Autodesk.Revit.DB.Lighting.LightGroupManager

概述

Autodesk.Revit.DB.Lighting.LightGroupManager是一个用于管理灯光组的类。灯光组是由同一控制器控制的一组灯光。灯光组可以通过添加灯光到组内，或从组中移除灯光来修改。

属性

• ControllerId: 控制灯光组的控制器的ID。

方法

• CreateLightGroup: 创建一个新的灯光组，并将其添加到项目中。该方法返回LightGroup对象。
• GetLightGroups: 获取项目中所有灯光组的清单。该方法将返回LightGroup对象的列表。
• GetLightGroup: 通过传递灯光组的ID，获取指定的灯光组。该方法将返回LightGroup对象。
• GetLights: 获取指定灯光组中的所有灯光。该方法返回Light对象的列表。
• AddLight: 将指定的灯光添加到指定的灯光组中。
• RemoveLight: 将指定的灯光从指定的灯光组中移除。
• DeleteLightGroup: 从项目中删除指定的灯光组。

示例代码

// 创建灯光组
LightGroup lg = LightGroupManager.CreateLightGroup(controllerId);

// 添加灯光到组中
Light l = ...
LightGroupManager.AddLight(lg.Id, l.Id);

// 获取指定组中的所有灯光
List<Light> lights = LightGroupManager.GetLights(lg.Id);

// 从组中移除灯光
LightGroupManager.RemoveLight(lg.Id, l.Id);

// 删除灯光组
LightGroupManager.DeleteLightGroup(lg.Id);

注意事项

• 在使用LightGroup对象之前，必须将其添加到项目中。
• 如果试图使用不存在的灯光组或控制器ID，则会抛出异常。