Autodesk.Revit.DB.PointClouds.PointCloudColorSettings

Autodesk.Revit.DB.PointClouds.PointCloudColorSettings是一个用于设置点云渲染颜色的类。通过该类，可以定义点云的颜色方案，包括每个颜色对应的高程值范围、颜色、透明度等属性。

属性

PointCloudColorSettings类具有以下属性：

• ColorRanges：定义每个颜色对应的高程值范围。每个颜色范围由一个ColorRange对象表示。
• ColorScheme：定义点云的颜色方案。可以是RGB、HSB或单色。
• DefaultAlpha：定义颜色的默认透明度。取值范围为0到1。
• DefaultColor：定义颜色的默认值，可以是系统预定义的颜色值或自定义的颜色值。
• DefaultOpacityCorrection：定义透明度校正系数，用于调整点云的透明度。取值范围为0到1。

方法

PointCloudColorSettings类具有以下方法：

• GetColor(PointCloudEntry)：获取给定点的颜色。
• SetDefaultColor(Color)：设置默认颜色值。
• SetOpacityCorrection(double)：设置透明度校正系数。

用法示例

以下示例演示如何使用PointCloudColorSettings类定义点云的颜色方案：

PointCloudColorSettings colorSettings = new PointCloudColorSettings();
colorSettings.ColorScheme = PointCloudColorSchemeType.RGB;
colorSettings.DefaultColor = new Autodesk.Revit.DB.Color(255, 255, 255);
colorSettings.ColorRanges.Add(new ColorRange(-9999, -1000, new Autodesk.Revit.DB.Color(109, 115, 170), 0));
colorSettings.ColorRanges.Add(new ColorRange(-1000, -500, new Autodesk.Revit.DB.Color(229, 204, 100), 0.2));
colorSettings.ColorRanges.Add(new ColorRange(-500, 0, new Autodesk.Revit.DB.Color(255, 204, 51), 0.5));
colorSettings.ColorRanges.Add(new ColorRange(0, 500, new Autodesk.Revit.DB.Color(102, 204, 255), 0.7));
colorSettings.ColorRanges.Add(new ColorRange(500, 9999, new Autodesk.Revit.DB.Color(0, 51, 204), 1));
PointCloudSettings settings = new PointCloudSettings();
settings.ColorSettings = colorSettings;

在以上示例中，ColorRanges属性包括了五个ColorRange对象，分别定义了五个不同高程值范围对应的颜色值和不透明度。DefaultColor属性定义了默认颜色值，当点云无法匹配到特定高程值范围时使用该颜色值。最后，将定义好的颜色方案PointCloudColorSettings赋给PointCloudSettings的ColorSettings属性即可应用到点云渲染中。

备注

• PointCloudColorSettings类仅在使用PointCloudConverter类将点云数据转换成DirectShape对象时才能使用。在其他情况下使用点云渲染，如将点云数据用于材质或图案填充等，应使用PointCloudElement类的ColorMode和ColorRange属性定义。
• ColorRange对象由高程下限值、高程上限值、颜色值和不透明度共四个属性定义，其中高程下限值和颜色值为必需属性，高程上限值和不透明度为可选属性。高程范围与颜色透明度的默认值依赖于PointCloudColorSettings的DefaultAlpha和DefaultOpacityCorrection属性。