tian/NavisworksTransport
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

测试3D路径点渲染

Browse Source
This commit is contained in:
tian 2025-06-19 18:34:04 +08:00
parent 0ac68acb19
commit b23715487d
6 changed files with 809 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
.cursor/rules/navisworks-plugin-rule.mdc
View File

@ -4,16 +4,20 @@ globs:
alwaysApply: true
---
本项目中设计方案和开发任何代码，都要先参考Navisworks2017的API文档；
每次完成一个开发任务，更新 [VERSION.md](mdc:NavisworksTransport/NavisworksTransport/VERSION.md) 和 [change_log.md](mdc:NavisworksTransport/NavisworksTransport/change_log.md)；
每次完成一个开发任务，更新 [VERSION.md](mdc:NavisworksTransport/NavisworksTransport/NavisworksTransport/VERSION.md) 和 [change_log.md](mdc:NavisworksTransport/NavisworksTransport/NavisworksTransport/change_log.md)；
生成的任务清单文件和其他临时文件，放在 doc/working目录下；
每次分析错误，要看日志文件[NavisworksTransport_Debug.log](mdc:NavisworksTransport/Desktop/NavisworksTransport_Debug.log)；
每次增加新的代码文件，要把文件增加到 [NavisworksTransportPlugin.csproj](mdc:NavisworksTransport/NavisworksTransport/NavisworksTransportPlugin.csproj)中；
每次分析错误，要看日志文件[NavisworksTransport_Debug.log](mdc:NavisworksTransport/NavisworksTransport/Desktop/NavisworksTransport_Debug.log)；
每次增加新的代码文件，要把文件增加到 [NavisworksTransportPlugin.csproj](mdc:NavisworksTransport/NavisworksTransport/NavisworksTransport/NavisworksTransportPlugin.csproj)中；
这个项目的开发环境是windows，生成命令时要注意；
在对代码进行修改时，不能随意删掉代码中原有的和此次修改无关的代码
编译使用命令
```bash
```sh
dotnet build NavisworksTransportPlugin.csproj --verbosity minimal
```
或者用
```sh
.\compile.bat
```

1
NavisworksTransportPlugin.csproj
View File

@ -74,6 +74,7 @@
<Compile Include="GeometryExtractor.cs" />
<Compile Include="LogManager.cs" />
<Compile Include="PathClickToolPlugin.cs" />
<Compile Include="PathPointRenderPlugin.cs" />
<Compile Include="Properties\AssemblyInfo.cs" />
</ItemGroup>
<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />

176
PathPlanningManager.cs
View File

@ -17,6 +17,7 @@ namespace NavisworksTransport
private CoordinateConverter _coordinateConverter;
private NavigationMapWindow _mapWindow;
private PathVisualizer _pathVisualizer;
private PathPointRenderPlugin _renderPlugin;
private List<ModelItem> _selectedChannels;
private List<PathRoute> _routes;
private PathRoute _currentRoute;
@ -119,6 +120,26 @@ namespace NavisworksTransport
_visibilityManager = visibilityManager ?? throw new ArgumentNullException(nameof(visibilityManager));
_pathVisualizer = new PathVisualizer();
// 获取已注册的圆形渲染插件实例
try
{
// 等待RenderPlugin自动注册，然后获取静态实例
_renderPlugin = PathPointRenderPlugin.Instance;
if (_renderPlugin != null)
{
LogManager.WriteLog("[路径管理] PathPointRenderPlugin实例获取成功");
}
else
{
LogManager.WriteLog("[路径管理] PathPointRenderPlugin实例尚未就绪，将在后续尝试获取");
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[路径管理] PathPointRenderPlugin实例获取失败: {ex.Message}");
_renderPlugin = null;
}
_selectedChannels = new List<ModelItem>();
_routes = new List<PathRoute>();
_currentRoute = new PathRoute("默认路径");
@ -133,6 +154,26 @@ namespace NavisworksTransport
_visibilityManager = new VisibilityManager();
_pathVisualizer = new PathVisualizer();
// 获取已注册的圆形渲染插件实例
try
{
// 等待RenderPlugin自动注册，然后获取静态实例
_renderPlugin = PathPointRenderPlugin.Instance;
if (_renderPlugin != null)
{
LogManager.WriteLog("[路径管理] PathPointRenderPlugin实例获取成功（无参构造）");
}
else
{
LogManager.WriteLog("[路径管理] PathPointRenderPlugin实例尚未就绪（无参构造）");
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[路径管理] PathPointRenderPlugin实例获取失败（无参构造）: {ex.Message}");
_renderPlugin = null;
}
_selectedChannels = new List<ModelItem>();
_routes = new List<PathRoute>();
_currentRoute = new PathRoute("默认路径");
@ -665,6 +706,14 @@ namespace NavisworksTransport
{
try
{
// 清理圆形渲染插件
if (_renderPlugin != null)
{
_renderPlugin.CleanUp();
_renderPlugin = null;
LogManager.WriteLog("[路径管理] PathPointRenderPlugin已清理");
}
// 停用ToolPlugin
if (_isToolPluginActive)
{
@ -2351,37 +2400,102 @@ namespace NavisworksTransport
}
/// <summary>
/// 绘制3D路径点标记
/// 绘制3D路径点标记（使用圆形标记）
/// </summary>
/// <param name="pathPoint">路径点</param>
private void Draw3DPathPoint(PathPoint pathPoint)
{
try
{
// 临时禁用PathVisualizer绘制以避免崩溃
// TODO: 修复PathVisualizer后重新启用
/*
// 使用PathVisualizer绘制3D球体标记
var color = GetNavisworksColor(pathPoint.Type);
var radius = 0.3; // 球体半径（米）
var pointNumber = GetPathPointNumber(pathPoint);
_pathVisualizer.DrawSphere(pathPoint.Position, radius, color);
*/
LogManager.WriteLog($"[3D标记] 开始绘制路径点标记: {pathPoint.Name}");
// 1. 创建圆形标记（如果RenderPlugin可用）
if (_renderPlugin == null)
{
// 尝试重新获取RenderPlugin实例
_renderPlugin = PathPointRenderPlugin.Instance;
}
if (_renderPlugin != null)
{
_renderPlugin.AddCircleMarker(pathPoint.Position, pathPoint.Type, pointNumber);
LogManager.WriteLog($"[3D标记] 圆形标记创建成功");
}
else
{
LogManager.WriteLog($"[3D标记] 圆形标记不可用，RenderPlugin未注册");
}
// 2. 创建文本标注序号
CreateTextLabel(pathPoint.Position, pointNumber.ToString(), pathPoint);
var colorName = GetPointColorName(pathPoint.Type);
LogManager.WriteLog($"[3D标记] {pathPoint.Name} ({pathPoint.Type}) at ({pathPoint.Position.X:F2}, {pathPoint.Position.Y:F2}, {pathPoint.Position.Z:F2}) - {colorName} [绘制已临时禁用]");
// 注释掉HighlightNearbyItems调用，避免干扰通道高亮
// HighlightNearbyItems(pathPoint.Position, GetPointColor(pathPoint.Type));
LogManager.WriteLog($"[3D标记] {pathPoint.Name} (序号:{pointNumber}) at ({pathPoint.Position.X:F2}, {pathPoint.Position.Y:F2}, {pathPoint.Position.Z:F2}) - {colorName} [圆形标记系统]");
}
catch (Exception ex)
{
LogManager.WriteLog($"[3D标记] 绘制3D路径点失败: {ex.Message}");
LogManager.WriteLog($"[3D标记] 异常堆栈: {ex.StackTrace}");
// 不再尝试备用方案，避免进一步的冲突
}
}
/// <summary>
/// 创建文本标注
/// </summary>
/// <param name="position">标注位置</param>
/// <param name="text">标注文本</param>
/// <param name="pathPoint">关联的路径点</param>
private void CreateTextLabel(Point3D position, string text, PathPoint pathPoint)
{
try
{
// 注意：Navisworks 2017的文本标注API可能有限
// 这里使用日志记录作为临时实现，后续可改进为真正的3D文本
LogManager.WriteLog($"[文本标注] 在位置 ({position.X:F2}, {position.Y:F2}, {position.Z:F2}) 创建标注: \"{text}\"");
// 记录文本标注信息
if (_pathPointMarkers == null)
_pathPointMarkers = new List<PathPointMarker>();
_pathPointMarkers.Add(new PathPointMarker
{
PathPoint = pathPoint,
LabelText = text,
LabelPosition = position,
MarkerType = PathPointMarkerType.TextLabel
});
// TODO: 实现真正的3D文本标注（如果Navisworks 2017 API支持）
// 可能的实现方式：
// 1. 使用COM接口的标注功能
// 2. 创建简单的几何文本
// 3. 使用视点注释功能
}
catch (Exception ex)
{
LogManager.WriteLog($"[文本标注] 创建文本标注失败: {ex.Message}");
}
}
/// <summary>
/// 获取路径点在当前路径中的序号
/// </summary>
/// <param name="pathPoint">路径点</param>
/// <returns>序号（从1开始）</returns>
private int GetPathPointNumber(PathPoint pathPoint)
{
if (_currentRoute?.Points != null)
{
var index = _currentRoute.Points.IndexOf(pathPoint);
return index >= 0 ? index + 1 : 0;
}
return 0;
}
/// <summary>
/// 获取点类型对应的颜色名称
/// </summary>
@ -2507,16 +2621,41 @@ namespace NavisworksTransport
{
try
{
// 清除所有临时材质和颜色覆盖
Application.ActiveDocument.Models.ResetAllTemporaryMaterials();
LogManager.WriteLog("[3D标记清理] 开始清除所有路径点标记");
// 刷新视图
// 1. 清除圆形标记（如果RenderPlugin可用）
if (_renderPlugin != null)
{
var circleCount = _renderPlugin.MarkerCount;
_renderPlugin.ClearAllMarkers();
LogManager.WriteLog($"[3D标记清理] 清除 {circleCount} 个圆形标记");
}
// 2. 清除文本标注记录
if (_pathPointMarkers != null)
{
var labelMarkers = _pathPointMarkers.Where(m => m.MarkerType == PathPointMarkerType.TextLabel).ToList();
foreach (var marker in labelMarkers)
{
LogManager.WriteLog($"[3D标记清理] 清除路径点 {marker.PathPoint?.Name} 的文本标注: {marker.LabelText}");
// TODO: 清除实际的3D文本标注（当实现后）
}
LogManager.WriteLog($"[3D标记清理] 共清除 {labelMarkers.Count} 个文本标注记录");
// 清空标记列表
_pathPointMarkers.Clear();
}
// 3. 刷新视图
Application.ActiveDocument.ActiveView.RequestDelayedRedraw(ViewRedrawRequests.All);
LogManager.WriteLog("[3D标记清理] 3D路径标记清除完成");
OnStatusChanged("已清除所有3D路径标记");
}
catch (Exception ex)
{
LogManager.WriteLog($"[3D标记清理] 清除3D路径标记失败: {ex.Message}");
OnErrorOccurred($"清除3D路径标记失败: {ex.Message}");
}
}
@ -2815,5 +2954,8 @@ namespace NavisworksTransport
#endregion
#endregion
// 路径点3D标记管理
private List<PathPointMarker> _pathPointMarkers;
}
}

42
PathPlanningModels.cs
View File

@ -1426,4 +1426,46 @@ namespace NavisworksTransport
}
#endregion
/// <summary>
/// 路径点标记类型
/// </summary>
public enum PathPointMarkerType
{
/// <summary>
/// 文本标注
/// </summary>
TextLabel
}
/// <summary>
/// 路径点3D标记信息
/// </summary>
public class PathPointMarker
{
/// <summary>
/// 关联的路径点
/// </summary>
public PathPoint PathPoint { get; set; }
/// <summary>
/// 标记类型
/// </summary>
public PathPointMarkerType MarkerType { get; set; }
/// <summary>
/// 标注文本
/// </summary>
public string LabelText { get; set; }
/// <summary>
/// 标注位置
/// </summary>
public Point3D LabelPosition { get; set; }
/// <summary>
/// 创建时间
/// </summary>
public DateTime CreatedTime { get; set; } = DateTime.Now;
}
}

440
PathPointRenderPlugin.cs Normal file
View File

@ -0,0 +1,440 @@
using System;
using System.Collections.Generic;
using System.Linq;
using Autodesk.Navisworks.Api;
using Autodesk.Navisworks.Api.Plugins;
namespace NavisworksTransport
{
/// <summary>
/// 路径点圆形标记渲染插件
/// 使用Graphics.Circle在3D空间绘制圆形标记
/// </summary>
[Plugin("PathPointRenderPlugin", "NavisworksTransport", DisplayName = "路径点圆形标记渲染器")]
public class PathPointRenderPlugin : RenderPlugin
{
private readonly object _lockObject = new object();
private List<CircleMarker> _circleMarkers = new List<CircleMarker>();
private bool _isEnabled = true;
// 静态实例，用于外部访问
private static PathPointRenderPlugin _instance;
/// <summary>
/// 构造函数
/// </summary>
public PathPointRenderPlugin()
{
_instance = this;
LogManager.WriteLog("[RenderPlugin] PathPointRenderPlugin构造函数被调用");
}
/// <summary>
/// 获取静态实例
/// </summary>
public static PathPointRenderPlugin Instance => _instance;
/// <summary>
/// 是否启用渲染
/// </summary>
public bool IsEnabled
{
get { return _isEnabled; }
set
{
_isEnabled = value;
// 触发视图刷新
if (Application.ActiveDocument?.ActiveView != null)
{
Application.ActiveDocument.ActiveView.RequestDelayedRedraw(ViewRedrawRequests.Render);
}
}
}
/// <summary>
/// 当前圆形标记数量
/// </summary>
public int MarkerCount
{
get
{
lock (_lockObject)
{
return _circleMarkers.Count;
}
}
}
/// <summary>
/// Navisworks渲染回调方法
/// </summary>
/// <param name="view">当前视图</param>
/// <param name="graphics">图形上下文</param>
public override void Render(View view, Graphics graphics)
{
if (!_isEnabled) return;
try
{
// 简单测试：画一条红色线段，看能否看到任何东西
graphics.Color(Color.Red, 0.0);
graphics.LineWidth(10);
var lineStart = new Point3D(19000, -18000, 2000);
var lineEnd = new Point3D(21000, -18000, 2000);
graphics.Line(lineStart, lineEnd);
LogManager.WriteLog($"[简单测试] 绘制测试线段: ({lineStart.X}, {lineStart.Y}, {lineStart.Z}) 到 ({lineEnd.X}, {lineEnd.Y}, {lineEnd.Z})");
// 先绘制测试大圆形 - 验证Graphics.Circle API
var testCenter = new Point3D(19082.41, -18248.14, 4037.26);
var testRadius = 200.0; // 200英寸大圆，应该非常明显
var testColor = new Color(1.0, 0.0, 0.0); // 红色，高对比度
graphics.Color(testColor, 0.0); // 完全不透明红色
graphics.Circle(testCenter, new Vector3D(0, 0, 1), testRadius, true); // 实心圆
LogManager.WriteLog($"[测试圆形] 绘制测试大圆: 中心({testCenter.X:F2}, {testCenter.Y:F2}, {testCenter.Z:F2}), 半径={testRadius:F2}, 颜色=红色");
lock (_lockObject)
{
if (_circleMarkers.Count > 0)
{
LogManager.WriteLog($"[圆形渲染] 开始渲染 {_circleMarkers.Count} 个圆形标记");
}
// 遍历所有圆形标记并绘制
foreach (var marker in _circleMarkers)
{
// 设置颜色和透明度
graphics.Color(marker.Color, marker.Transparency);
// 绘制圆形标记
graphics.Circle(marker.Center, marker.Normal, marker.Radius, marker.Filled);
LogManager.WriteLog($"[圆形渲染] 绘制圆形: 中心({marker.Center.X:F2}, {marker.Center.Y:F2}, {marker.Center.Z:F2}), 半径={marker.Radius:F2}, 序号={marker.SequenceNumber}");
}
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[圆形渲染] 渲染错误: {ex.Message}");
LogManager.WriteLog($"[圆形渲染] 异常堆栈: {ex.StackTrace}");
}
}
/// <summary>
/// 添加圆形标记
/// </summary>
/// <param name="center">圆心位置</param>
/// <param name="pointType">路径点类型</param>
/// <param name="sequenceNumber">序号</param>
public void AddCircleMarker(Point3D center, PathPointType pointType, int sequenceNumber)
{
try
{
var marker = new CircleMarker
{
Center = center,
Normal = new Vector3D(0, 0, 1), // 垂直向上
Radius = GetRadiusForPointType(pointType),
Color = GetColorForPointType(pointType),
Transparency = 0.0, // 完全不透明，更容易看见
Filled = true, // 实心圆
PointType = pointType,
SequenceNumber = sequenceNumber,
CreatedTime = DateTime.Now
};
lock (_lockObject)
{
_circleMarkers.Add(marker);
}
LogManager.WriteLog($"[圆形标记] 添加圆形标记: 类型={pointType}, 序号={sequenceNumber}, 中心=({center.X:F2}, {center.Y:F2}, {center.Z:F2})");
// 触发视图刷新
RequestViewRefresh();
}
catch (Exception ex)
{
LogManager.WriteLog($"[圆形标记] 添加标记失败: {ex.Message}");
}
}
/// <summary>
/// 移除指定位置的圆形标记
/// </summary>
/// <param name="position">位置</param>
/// <param name="tolerance">容差距离（米）</param>
/// <returns>是否成功移除</returns>
public bool RemoveMarkerAt(Point3D position, double tolerance = 1.0)
{
bool removed = false;
try
{
lock (_lockObject)
{
for (int i = _circleMarkers.Count - 1; i >= 0; i--)
{
var marker = _circleMarkers[i];
var distance = CalculateDistance(marker.Center, position);
if (distance <= tolerance)
{
_circleMarkers.RemoveAt(i);
removed = true;
LogManager.WriteLog($"[圆形标记] 移除标记: 序号={marker.SequenceNumber}, 距离={distance:F2}m");
}
}
}
if (removed)
{
RequestViewRefresh();
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[圆形标记] 移除标记失败: {ex.Message}");
}
return removed;
}
/// <summary>
/// 清除所有圆形标记
/// </summary>
public void ClearAllMarkers()
{
try
{
int removedCount = 0;
lock (_lockObject)
{
removedCount = _circleMarkers.Count;
_circleMarkers.Clear();
}
LogManager.WriteLog($"[圆形标记] 清除所有标记，共移除 {removedCount} 个圆形标记");
if (removedCount > 0)
{
RequestViewRefresh();
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[圆形标记] 清除标记失败: {ex.Message}");
}
}
/// <summary>
/// 获取所有标记的副本
/// </summary>
/// <returns>标记列表</returns>
public List<CircleMarker> GetAllMarkers()
{
lock (_lockObject)
{
return new List<CircleMarker>(_circleMarkers);
}
}
#region 私有辅助方法
/// <summary>
/// 根据路径点类型和真实文档单位获取适当的半径
/// 目标：路径点半径为0.5米物理尺寸，起点/终点为0.8米物理尺寸
/// </summary>
private double GetRadiusForPointType(PathPointType pointType)
{
// 基础半径（米为单位）
double baseRadiusInMeters = pointType == PathPointType.WayPoint ? 0.5 : 0.8;
// 获取真实文档单位转换系数
double metersToModelUnits = GetMetersToModelUnitsConversionFactor();
// 转换为模型单位
double radiusInModelUnits = baseRadiusInMeters * metersToModelUnits;
LogManager.WriteLog($"[半径计算] 类型={pointType}, 基础半径={baseRadiusInMeters}m, 转换系数={metersToModelUnits:F2}, 最终半径={radiusInModelUnits:F2}");
return radiusInModelUnits;
}
/// <summary>
/// 获取米转换为文档单位的转换系数
/// 使用Navisworks API直接获取真实文档单位，而不是猜测
/// </summary>
private double GetMetersToModelUnitsConversionFactor()
{
try
{
var units = Application.ActiveDocument.Units;
LogManager.WriteLog($"[单位检测] API返回的文档单位: {units}");
switch (units)
{
case Units.Millimeters:
LogManager.WriteLog("[单位检测] 确认为毫米单位，转换系数=1000");
return 1000.0; // 1米 = 1000毫米
case Units.Centimeters:
LogManager.WriteLog("[单位检测] 确认为厘米单位，转换系数=100");
return 100.0; // 1米 = 100厘米
case Units.Meters:
LogManager.WriteLog("[单位检测] 确认为米单位，转换系数=1");
return 1.0; // 1米 = 1米
case Units.Inches:
LogManager.WriteLog("[单位检测] 确认为英寸单位，转换系数=39.37");
return 39.37; // 1米 = 39.37英寸
case Units.Feet:
LogManager.WriteLog("[单位检测] 确认为英尺单位，转换系数=3.281");
return 3.281; // 1米 = 3.281英尺
case Units.Kilometers:
LogManager.WriteLog("[单位检测] 确认为公里单位，转换系数=0.001");
return 0.001; // 1米 = 0.001公里
case Units.Micrometers:
LogManager.WriteLog("[单位检测] 确认为微米单位，转换系数=1000000");
return 1000000.0; // 1米 = 1000000微米
case Units.Microinches:
LogManager.WriteLog("[单位检测] 确认为微英寸单位，转换系数=39370078.74");
return 39370078.74; // 1米 = 39370078.74微英寸
case Units.Mils:
LogManager.WriteLog("[单位检测] 确认为密尔单位，转换系数=39370.08");
return 39370.08; // 1米 = 39370.08密尔
case Units.Yards:
LogManager.WriteLog("[单位检测] 确认为码单位，转换系数=1.094");
return 1.094; // 1米 = 1.094码
case Units.Miles:
LogManager.WriteLog("[单位检测] 确认为英里单位，转换系数=0.000621");
return 0.000621; // 1米 = 0.000621英里
default:
LogManager.WriteLog($"[单位检测] 未知单位类型: {units}，使用默认米单位，转换系数=1");
return 1.0;
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[单位检测] API调用失败: {ex.Message}");
LogManager.WriteLog("[单位检测] 使用默认米单位，转换系数=1");
return 1.0;
}
}
/// <summary>
/// 根据路径点类型获取颜色
/// </summary>
private Color GetColorForPointType(PathPointType pointType)
{
switch (pointType)
{
case PathPointType.StartPoint:
return Color.Green; // 起点绿色
case PathPointType.EndPoint:
return Color.Red; // 终点红色
case PathPointType.WayPoint:
default:
return new Color(1.0, 0.0, 1.0); // 路径点洋红色RGB(1,0,1) - 高对比度避免与蓝色通道冲突
}
}
/// <summary>
/// 计算两点间距离
/// </summary>
private double CalculateDistance(Point3D point1, Point3D point2)
{
var dx = point1.X - point2.X;
var dy = point1.Y - point2.Y;
var dz = point1.Z - point2.Z;
return Math.Sqrt(dx * dx + dy * dy + dz * dz);
}
/// <summary>
/// 请求视图刷新
/// </summary>
private void RequestViewRefresh()
{
try
{
if (Application.ActiveDocument?.ActiveView != null)
{
Application.ActiveDocument.ActiveView.RequestDelayedRedraw(ViewRedrawRequests.Render);
}
}
catch (Exception ex)
{
LogManager.WriteLog($"[圆形标记] 视图刷新失败: {ex.Message}");
}
}
#endregion
#region 清理资源
/// <summary>
/// 清理资源
/// </summary>
public void CleanUp()
{
ClearAllMarkers();
}
#endregion
}
/// <summary>
/// 圆形标记数据结构
/// </summary>
public class CircleMarker
{
/// <summary>
/// 圆心坐标
/// </summary>
public Point3D Center { get; set; }
/// <summary>
/// 圆面法向量
/// </summary>
public Vector3D Normal { get; set; }
/// <summary>
/// 圆形半径
/// </summary>
public double Radius { get; set; }
/// <summary>
/// 圆形颜色
/// </summary>
public Color Color { get; set; }
/// <summary>
/// 透明度 (0.0-1.0)
/// </summary>
public double Transparency { get; set; }
/// <summary>
/// 是否填充
/// </summary>
public bool Filled { get; set; }
/// <summary>
/// 路径点类型
/// </summary>
public PathPointType PointType { get; set; }
/// <summary>
/// 序号
/// </summary>
public int SequenceNumber { get; set; }
/// <summary>
/// 创建时间
/// </summary>
public DateTime CreatedTime { get; set; }
public override string ToString()
{
return $"CircleMarker[序号={SequenceNumber}, 类型={PointType}, 中心=({Center.X:F2},{Center.Y:F2},{Center.Z:F2}), 半径={Radius:F2}]";
}
}
}

159
doc/working/3D路径点标记功能开发任务.md Normal file
View File

@ -0,0 +1,159 @@
# 上下文
文件名：3D路径点标记功能开发任务.md
创建于：2025-06-19 16:35:00
创建者：AI Assistant
# 任务描述
实现安全可靠的3D路径点标记功能，**现已简化为纯圆形标记系统：使用Graphics.Circle API绘制真实3D圆形标记。**
# 项目概述
NavisworksTransport插件需要在用户点击设置路径点时，在3D视图中显示清晰的视觉标记，包括：
- **真实3D圆形标记（基于Graphics.Circle）**
- 数字序号文本标注
- 不同点类型的颜色区分（起点绿色、终点红色、路径点蓝色）
---
*以下部分由 AI 在协议执行过程中维护*
---
# 分析 (由 RESEARCH 模式填充)
## 问题根源
- 之前的PathVisualizer.DrawSphere()方法过于复杂，尝试创建大量顶点和线条
- Navisworks 2017缺乏直接的几何绘制API
- 线程安全问题导致崩溃
## 技术调研结果
- **Graphics.Circle方法可以在RenderPlugin中绘制真实3D圆形**
- 文本标注可通过Navisworks内置功能实现
- **颜色覆盖标记被用户确认不适用于本项目**
# 提议的解决方案 (由 INNOVATE 模式填充)
## 选定方案：纯圆形标记系统
**Graphics.Circle圆形标记法**
- 使用`Graphics.Circle`方法绘制真实的3D圆形标记
- 基于RenderPlugin架构，利用Navisworks原生渲染管线
- 不同点类型使用不同颜色和大小
- 兼容性极好，性能稳定，视觉效果直观
**技术优势**：
- **真实3D几何**：在3D空间中绘制实际的圆形，不是2D覆盖
- **视觉清晰**：圆形标记在各种视角下都清晰可见
- **性能优化**：使用Navisworks原生渲染，高效流畅
- **简洁架构**：移除不适用的颜色覆盖功能，代码更清晰
# 实施计划 (由 PLAN 模式生成)
## 第一阶段：创建PathPointRenderPlugin类 ✅
1. 创建继承自RenderPlugin的PathPointRenderPlugin类
2. 实现Render方法，使用Graphics.Circle绘制路径点
3. 提供路径点数据管理接口
4. 支持不同点类型的颜色和大小配置
## 第二阶段：集成到PathPlanningManager ✅
1. 在PathPlanningManager中添加RenderPlugin管理
2. 修改Draw3DPathPoint方法支持圆形标记
3. 更新Clear3DPathMarkers方法处理圆形标记
## 第三阶段：简化架构（新增） ✅
1. **删除颜色覆盖相关功能**：FindNearbyChannelItems、CreateColorMarker等方法
2. **简化Draw3DPathPoint方法**：只使用圆形标记和文本标注
3. **清理数据模型**：移除PathPointMarker中的颜色覆盖字段
4. **移除枚举值**：删除PathPointMarkerType.ColorOverride
实施检查清单：
1. ✅ PathPointRenderPlugin类创建完成
2. ✅ CircleMarker数据结构实现
3. ✅ Render方法实现Graphics.Circle绘制
4. ✅ 标记管理系统（添加、移除、清空）
5. ✅ PathPlanningManager集成RenderPlugin
6. ✅ 修改Draw3DPathPoint方法支持圆形标记
7. ✅ 更新Clear3DPathMarkers方法
8. ✅ **删除颜色覆盖相关功能**
9. ⚠️ 编译测试（需要解决权限问题）
10. 🔄 功能测试和文档更新
# 当前执行步骤 (由 EXECUTE 模式在开始执行某步骤时更新)
> 正在执行: "步骤6 - 实现智能单位适配系统"
# 任务进度 (由 EXECUTE 模式在每步完成后追加)
* [2025-06-19 17:20:00]
* 步骤：步骤1 - 删除PathPlanningManager中的颜色标记功能
* 修改：移除FindNearbyChannelItems、CreateColorMarker等方法（约90+行代码）
* 更改摘要：简化Draw3DPathPoint方法，删除颜色覆盖标记逻辑，只保留圆形标记
* 原因：执行计划步骤 1
* 阻碍：无
* 用户确认状态：成功
* [2025-06-19 17:21:00]
* 步骤：步骤2 - 简化PathPointMarker数据结构
* 修改：删除MarkedItems和OriginalColor字段，简化Clear3DPathMarkers方法
* 更改摘要：清理数据模型，移除颜色覆盖相关字段和逻辑
* 原因：执行计划步骤 2
* 阻碍：无
* 用户确认状态：成功
* [2025-06-19 17:22:00]
* 步骤：步骤3 - 修复PathPointRenderPlugin注册机制
* 修改：添加静态Instance属性、构造函数日志、PathPlanningManager使用Instance
* 更改摘要：修复RenderPlugin不被Navisworks识别的问题
* 原因：执行计划步骤 3
* 阻碍：无
* 用户确认状态：成功
* [2025-06-19 17:30:00]
* 步骤：步骤4 - 修复颜色冲突问题
* 修改：将路径点颜色从蓝色改为洋红色，避免与蓝色通道冲突
* 更改摘要：使用new Color(1.0, 0.0, 1.0)创建洋红色，提高可见性
* 原因：执行计划步骤 4
* 阻碍：无
* 用户确认状态：成功
* [2025-06-19 17:35:00]
* 步骤：步骤5 - 发现并初步修复单位问题
* 修改：将半径从3-5米改为200-300英寸的硬编码值
* 更改摘要：临时解决英寸单位模型中圆形太小的问题
* 原因：执行计划步骤 5
* 阻碍：用户指出硬编码常量是错误做法
* 用户确认状态：失败
* [2025-06-19 17:40:00]
* 步骤：步骤6 - 实现智能单位适配系统
* 修改：实现GetModelUnitsPerMeter()方法，基于模型包围盒自动检测单位并转换
* 更改摘要：替换硬编码半径为动态计算，确保0.5米/0.8米的物理尺寸适配任何单位
* 原因：执行计划步骤 6
* 阻碍：编译被Navisworks文件锁定阻止，需要关闭Navisworks重新编译
* 用户确认状态：待确认
## 重大突破：单位自适应解决方案
**问题根源：** 用户模型使用英寸单位，但代码使用硬编码的米值，导致0.5米在英寸单位下太小（约19.7英寸在几万英寸的模型中不可见）
**解决方案：** 实现智能单位检测和转换系统：
1. **自动单位检测：** 通过分析模型整体包围盒尺寸推断单位类型
- 尺寸 > 10000：毫米 (转换系数 1000)
- 尺寸 1000-10000：英寸 (转换系数 39.37)
- 尺寸 100-1000：厘米 (转换系数 100)
- 尺寸 < 100：米 (转换系数 1)
2. **物理尺寸保证：** 不管模型单位，始终确保：
- 路径点圆形：0.5米物理尺寸
- 起点/终点圆形：0.8米物理尺寸
3. **动态计算：** `半径 = 基础半径(米) × 单位转换系数`
**技术实现：**
- `GetModelUnitsPerMeter()`: 分析所有模型包围盒，计算转换系数
- `GetRadiusForPointType()`: 应用转换系数，返回适配后的半径
- 详细日志：记录单位检测过程和半径计算
**预期效果：** 无论模型是米、英寸、毫米还是厘米，圆形标记都将显示为合适的碰撞检测尺寸。
# 最终审查 (由 REVIEW 模式填充)
**架构简化已完成**：
- ✅ 成功移除所有颜色覆盖标记相关代码
- ✅ 简化为纯Graphics.Circle圆形标记系统
- ✅ 保留文本标注功能
- ✅ 数据模型清理完成
- ⚠️ 需要解决编译权限问题以完成最终测试
**当前状态**: 代码修改完成，等待编译确认和功能测试。