Revit 二次开发：基于 HelixToolkit.Wpf.SharpDX 的高性能 3D 可视化工具库

Revit 二次开发：基于 HelixToolkit.Wpf.SharpDX 的高性能 3D 可视化工具库 | 极客日志

# Package Manager
Install-Package Su.Revit.HelixToolkit.SharpDX

# .NET CLI
dotnet add package Su.Revit.HelixToolkit.SharpDX

// 1. 初始化构建器
var builder = HelixViewport3DBuilder.Init(
    revitDocument, 
    geometryObjects,
    new Viewport3DXOptions()
);

// 2. 获取 3D 视口控件
Viewport3DX viewport = builder.Viewport;

// 3. 将 viewport 添加到你的 WPF 窗口中

// 准备要显示的几何对象
var geometryObjects = new List<GeometryObjectOptions>
{
    // 添加你的几何对象...
};

// 配置视口选项
var visualOptions = new Viewport3DXOptions
{
    BackgroundColor = System.Windows.Media.Colors.LightGray,
    FXAALevel = 4 // 抗锯齿等级
};

// 创建构建器
var builder = HelixViewport3DBuilder.Init(document, geometryObjects, visualOptions);

// 设置相机视图
builder.SetCamera(revitView);

// 启用交互功能
builder.SetHoverHighlightEnabled(true).SetClickHighlightEnabled(true);

操作	功能
中键双击	缩放至视图范围
中键拖动	平移视图
Shift + 右键	旋转视角
鼠标悬停	半透明高亮显示
左键点击	选中模型
Ctrl + 点击	多选模型

// 设置高亮颜色
builder.SetHighlightColor(Colors.Red, 0.8f); // 红色高亮

// 启用闪烁效果
builder.SetHighlightBlinking(true, 100); // 100ms 闪烁间隔

// 程序化高亮特定对象
builder.HighlightGeometryObject(specificGeometry);

// 方法 1: 使用 Revit 视图
builder.SetCamera(revitView);

// 方法 2: 自定义相机
builder.SetCamera(
    new XYZ(0, 0, 10),   // 相机位置
    new XYZ(0, 0, -1),   // 观察方向
    new XYZ(0, 1, 0)     // 上方向
);

// 监听模型选中事件
builder.OnModelSelected += (sender, args) =>
{
    var selectedModel = args.SelectedModel;
    var geometryObject = args.GeometryObject;
    var hitPoint = args.HitPoint;
    Console.WriteLine($"选中了模型：{geometryObject}");
};

// 监听取消选中事件
builder.OnModelDeselected += (sender, args) =>
{
    // 清除选中状态
};

// 获取当前选中的模型
var selectedModels = builder.GetSelectedModels();

// 获取当前选中的几何对象
var selectedGeometry = builder.GetSelectedGeometryObjects();

// 清除所有选择
builder.ClearHighlight();

var options = new Viewport3DXOptions
{
    BackgroundColor = Colors.Black,      // 背景颜色
    FXAALevel = 8,                       // 抗锯齿等级 (0-8)
    EnableRenderFrustum = true           // 视锥体裁剪
};

// 启用/禁用悬停高亮
builder.SetHoverHighlightEnabled(true);

// 启用/禁用点击高亮
builder.SetClickHighlightEnabled(true);

var options = new GeometryObjectOptions(
    geometryObject, // Revit 几何对象
    revitMaterial   // Revit 材质（可选）
);

var options = new GeometryObjectOptions(
    geometryObject, // Revit 几何对象
    Colors.Blue,    // 自定义颜色
    0.8f            // 透明度 (0-1)
);

var options = new GeometryObjectOptions(
    geometryObject, // Revit 几何对象
    textureStream,  // 贴图流
    Colors.White,   // 自发光颜色
    1.0f            // 透明度
);

var options = new GeometryObjectOptions(geometryObject, material)
{
    LevelOfDetail = 0.8,                    // 细节等级 (0-1)
    MinAngleInTriangle = 0,                 // 三角面最小角度
    MinExternalAngleBetweenTriangles = Math.PI / 4, // 相邻面最小外角
    IsDrawSolidEdges = true,                // 是否绘制轮廓线
    SolidEdgeThickness = 2f,                // 轮廓线粗细
    SolidEdgeSmoothness = 10f               // 轮廓线平滑度
};

参数	说明	默认值	影响
`LevelOfDetail`	渲染细节等级	0.5	值越高网格越密集，精度越高但性能消耗越大
`MinAngleInTriangle`	三角面最小夹角	0	控制网格生成时的平滑度
`MinExternalAngleBetweenTriangles`	相邻三角面最小外角	2π	判断曲面平滑过渡程度
`IsDrawSolidEdges`	是否绘制轮廓线	true	显示边界线条
`SolidEdgeThickness`	轮廓线粗细	2f	线条的像素宽度
`SolidEdgeSmoothness`	轮廓线平滑度	10f	数值越大边缘越平滑

// 清空场景
builder.Clear();

// 重新添加对象
builder.Add(newGeometryObjects);

// 重置相机
builder.SetCamera(newView);

builder.SetHighlightColor(Colors.Blue, 0.7f); // 蓝色高亮

builder.SetHoverHighlightEnabled(false).SetClickHighlightEnabled(false);

builder.OnModelSelected += (sender, args) =>
{
    var worldPosition = args.HitPoint; // 世界坐标
};

var options = new GeometryObjectOptions(geometryObject, material)
{
    LevelOfDetail = 0.3,                // 降低细节等级
    IsDrawSolidEdges = false            // 禁用轮廓线绘制
};

// 方法 1: 使用颜色透明度
var options = new GeometryObjectOptions(geometryObject, Colors.Red, 0.5f);

// 方法 2: 使用 Revit 材质的透明度
var material = document.GetElement(materialId) as Autodesk.Revit.DB.Material;
var options = new GeometryObjectOptions(geometryObject, material);

// 库已内置三角面索引优化，自动处理海量数据
// 只需正常创建 GeometryObjectOptions 即可
var options = new GeometryObjectOptions(largeSolidModel, material);

// 检查选中的模型
var selected = builder.GetSelectedModels();
Console.WriteLine($"选中了 {selected.Count()} 个模型");

// 检查几何对象映射
var geometryObjects = builder.GetSelectedGeometryObjects();
foreach (var geoObj in geometryObjects)
{
    Console.WriteLine($"几何对象类型：{geoObj.GetType()}");
}

Revit 二次开发：基于 HelixToolkit.Wpf.SharpDX 的高性能 3D 可视化工具库

项目地址

演示动画

安装方式

通过 NuGet 安装（推荐）

兼容性

简介

快速开始

基本使用

完整示例

交互功能

鼠标操作

高亮功能

视图控制

相机设置

导航控件

高级功能

事件监听

选择管理

配置选项

视觉配置

功能开关

GeometryObjectOptions 使用指南

基本配置

使用 Revit 材质

使用自定义颜色

使用贴图材质

渲染参数配置

参数说明

使用技巧

性能优化

最佳实践

场景管理

常见问题

如何更改高亮颜色？

如何禁用所有交互？

如何获取点击位置的世界坐标？

如何优化复杂模型的性能？

如何处理材质透明度？

如何处理海量三角面的 Solid 模型？

技术支持

调试技巧

更多资源

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具