Autodesk.Revit.DB.BuiltInFailures.IlluminationFailures

概述

Autodesk.Revit.DB.BuiltInFailures.IlluminationFailures 是 Revit API 中提供的内置错误类型之一，用于表示与照明设置有关的错误。

错误类型

在 Autodesk.Revit.DB.BuiltInFailures.IlluminationFailures 类中，包含以下错误类型：

• LightingChannelsOutOfRangeFailure：照明通道超出范围的错误
• LightingChannelsInconsistentFailure：照明通道不一致的错误
• LightingChannelsTypeMismatchFailure：照明通道类型不匹配的错误
• LightingChannelsDuplicatedFailure：照明通道重复的错误

错误原因

以下是每个错误类型的错误原因：

• LightingChannelsOutOfRangeFailure：照明通道的值超出有效范围
• LightingChannelsInconsistentFailure：照明通道的数量与照明设置不一致
• LightingChannelsTypeMismatchFailure：照明通道的类型不匹配，例如将点光源分配给面光源
• LightingChannelsDuplicatedFailure：照明通道重复设置

解决方案

对于 Autodesk.Revit.DB.BuiltInFailures.IlluminationFailures 中的错误类型，应采取以下解决方案：

• LightingChannelsOutOfRangeFailure：更改照明通道的值以在有效范围内
• LightingChannelsInconsistentFailure：匹配照明通道的数量与照明设置
• LightingChannelsTypeMismatchFailure：将照明通道的类型与照明设置匹配
• LightingChannelsDuplicatedFailure：删除重复的照明通道

示例代码

以下示例演示如何使用 Autodesk.Revit.DB.BuiltInFailures.IlluminationFailures 检测 Revit 模型中的照明错误：

// 获取文档设置中的照明设置
LightingSettings lightingSettings = document.GetLightingSettings();

using (Transaction transaction = new Transaction(document, "Fix Illumination Failures"))
{
    // 开始事务
    transaction.Start();

    // 检查照明通道
    IList<FailureMessageAccessor> failures = new List<FailureMessageAccessor>();
    lightingSettings.VerifyLightingChannels(failures);

    // 处理错误
    if (failures.Count > 0)
    {
        foreach (FailureMessageAccessor failure in failures)
        {
            if (failure.HasResolutions())
            {
                failure.SetCurrentResolution(FailureResolutionOption.DeleteElements);
            }
            else
            {
                failure.SetSeverity(FailureSeverity.Error);
            }
            failuresAccessor.DeleteAllWarnings();
        }
    }

    // 提交事务
    transaction.Commit();  
}

在上述代码中，VerifyLightingChannels 方法用于检查照明通道，并将错误添加到 failures 列表中。通过检查 failures 中的错误，我们可以采取适当的解决方案。

结论

Autodesk.Revit.DB.BuiltInFailures.IlluminationFailures 提供了管理 Revit 模型中照明错误的内置错误类型。通过使用这些错误类型，我们可以检测和处理照明设置的错误，从而确保模型的正确性和准确性。