1. 项目背景与需求解析
在机械设计领域，三维模型的精确测量是工程师日常工作中不可或缺的环节。西门子NX作为行业领先的CAD/CAM/CAE软件，其二次开发能力为自动化测量提供了强大支持。最近我在一个汽车零部件项目中遇到了一个典型需求：需要批量测量两个曲面在特定方向上的投影距离，用于验证装配间隙。
传统的手动测量方式效率低下，一个复杂装配体可能需要重复操作上百次。通过NX Open API结合C#开发自动化测量工具，可以将原本需要数小时的工作压缩到几分钟内完成。这种投影距离测量在模具设计、装配验证、运动干涉检查等场景中都有广泛应用。
2. 开发环境准备
2.1 基础环境配置
开发NX二次开发项目需要以下环境：
- NX软件（建议版本NX 1847以上）
- Visual Studio（推荐2019或2022）
- NX Open .NET API引用
在VS中创建C#类库项目后，需要添加以下关键引用：
using NXOpen; using NXOpen.UF; using NXOpen.Utilities;2.2 项目初始化设置
每个NX二次开发程序都需要标准的初始化结构：
public static void Main(string[] args) { Session theSession = Session.GetSession(); Part workPart = theSession.Parts.Work; UFGet get = new UFGet(); try { // 主逻辑代码 } catch (Exception ex) { theSession.LogFile.WriteLine("Error: " + ex.Message); } }重要提示：务必添加异常处理，因为NX环境中的操作可能因对象状态变化而失败
3. 核心测量逻辑实现
3.1 几何对象获取与验证
首先需要获取待测量的两个面对象，并进行有效性检查：
Face face1 = /* 获取第一个面的方法 */; Face face2 = /* 获取第二个面的方法 */; if (face1 == null || face2 == null) { theSession.LogFile.WriteLine("错误：未能获取有效的面对象"); return; } if (!face1.IsSameDirection(face2)) { theSession.LogFile.WriteLine("警告：两个面的法向方向不一致"); }3.2 投影方向确定
投影距离测量的关键在于投影方向的确定。常见场景包括：
- 沿坐标轴方向投影（X/Y/Z）
- 沿两个面的平均法向投影
- 自定义矢量方向投影
以下是沿Z轴投影的实现示例：
Vector3d projectionDir = new Vector3d(0, 0, 1); // Z轴方向对于复杂场景，可以计算两个面的平均法向：
double[] face1Normal = face1.Normal; double[] face2Normal = face2.Normal; Vector3d avgNormal = new Vector3d( (face1Normal[0] + face2Normal[0])/2, (face1Normal[1] + face2Normal[1])/2, (face1Normal[2] + face2Normal[2])/2 ); avgNormal = avgNormal.Normalize();3.3 距离测量实现
使用UFModl类提供的测量方法：
UFModl.ProjectionDistanceData distanceData = new UFModl.ProjectionDistanceData(); distanceData.projection_direction = new double[3] { projectionDir.X, projectionDir.Y, projectionDir.Z }; Tag[] faces = new Tag[2] { face1.Tag, face2.Tag }; UFModl.AskProjectionDistance(faces, 2, ref distanceData); double minDistance = distanceData.distance; Point3d pointOnFace1 = new Point3d( distanceData.point_on_entity1[0], distanceData.point_on_entity1[1], distanceData.point_on_entity1[2] ); Point3d pointOnFace2 = /* 类似方法获取 */;4. 高级功能扩展
4.1 批量测量实现
在实际工程中，往往需要批量测量多个面组合：
List<Tuple<Face, Face>> facePairs = /* 获取需要测量的面组合 */; List<MeasurementResult> results = new List<MeasurementResult>(); foreach (var pair in facePairs) { var result = MeasureProjectionDistance(pair.Item1, pair.Item2, projectionDir); results.Add(result); // 实时显示进度 theSession.ListingWindow.WriteLine($"已测量 {results.Count}/{facePairs.Count}"); }4.2 测量结果可视化
增强结果的可读性：
void VisualizeResult(Point3d p1, Point3d p2, double distance) { // 创建测量线 LineBuilder lineBuilder = workPart.Curves.CreateLineBuilder(); lineBuilder.StartPoint = p1; lineBuilder.EndPoint = p2; Line measurementLine = lineBuilder.Commit(); // 添加距离标注 AnnotationManager annoMgr = workPart.Annotations; Dimension dimension = annoMgr.CreateLinearDimension( p1, p2, new Point3d((p1.X+p2.X)/2, (p1.Y+p2.Y)/2, (p1.Z+p2.Z)/2), Annotation.AlignmentHorizontal.Center, Annotation.AlignmentVertical.Middle ); dimension.SetText($"距离: {distance:F2}mm"); }5. 性能优化技巧
5.1 对象缓存策略
频繁访问NX对象会影响性能，可采用缓存机制：
Dictionary<Tag, Face> faceCache = new Dictionary<Tag, Face>(); Face GetCachedFace(Tag faceTag) { if (!faceCache.ContainsKey(faceTag)) { faceCache[faceTag] = (Face)NXObjectManager.Get(faceTag); } return faceCache[faceTag]; }5.2 并行测量处理
对于大批量测量，可采用并行计算：
Parallel.ForEach(facePairs, pair => { lock (results) { results.Add(MeasureProjectionDistance(pair.Item1, pair.Item2)); } });注意：NX API某些方法不是线程安全的，并行时需要测试稳定性
6. 常见问题排查
6.1 测量结果异常
当测量结果出现以下情况时：
- 距离值为0
- 距离值异常大
- 点不在预期位置
检查步骤：
- 确认面的法向方向是否正确
- 检查投影方向是否与面平行
- 验证面对象是否有效（未被删除或修改）
6.2 性能瓶颈分析
若测量速度慢，可检查：
- 是否频繁创建/销毁临时对象
- 是否有冗余的对象查询操作
- 是否启用了不必要的更新通知
7. 工程应用建议
在实际项目中，我总结了以下经验：
- 对于复杂曲面，建议先进行三角网格化处理再测量
- 测量前最好先检查面的连续性（G0/G1/G2）
- 对于大装配体，建议先隐藏不相关组件再测量
- 重要测量结果应该记录到日志文件或数据库
一个健壮的测量工具还应该包含：
- 测量结果导出到Excel功能
- 测量历史记录与比较
- 自动生成测量报告
8. 完整示例代码
以下是整合后的核心代码框架：
public class DistanceMeasurer { private Session _session; private Part _workPart; public DistanceMeasurer() { _session = Session.GetSession(); _workPart = _session.Parts.Work; } public MeasurementResult Measure(Face face1, Face face2, Vector3d direction) { UFModl.ProjectionDistanceData data = new UFModl.ProjectionDistanceData(); data.projection_direction = new double[3] { direction.X, direction.Y, direction.Z }; Tag[] faces = new Tag[] { face1.Tag, face2.Tag }; UFModl.AskProjectionDistance(faces, 2, ref data); return new MeasurementResult { Distance = data.distance, Point1 = ConvertToPoint(data.point_on_entity1), Point2 = ConvertToPoint(data.point_on_entity2) }; } private Point3d ConvertToPoint(double[] coords) { return new Point3d(coords[0], coords[1], coords[2]); } } public struct MeasurementResult { public double Distance; public Point3d Point1; public Point3d Point2; }在实际项目中，这个基础框架可以根据需求扩展出更多实用功能。通过NX Open API，我们不仅能够实现投影距离测量，还能构建完整的自动化检测系统，大幅提升设计验证效率。
