Teigha中OdGe几何库详解及C#使用

张

张建站

2026/5/28 2:44:15

10分钟阅读

OdGe是 Teigha (ODA) SDK 中一个核心的几何库命名空间它封装了所有用于描述和操作几何图形的类与函数是进行任何 CAD 数据底层处理的基础。OdGe命名空间的构成与作用OdGe库提供了一套与 AutoCAD 原生几何库高度兼容、但独立于任何特定 CAD 平台或文件格式的纯数学几何对象模型。它的主要作用是几何数据建模定义了点、向量、矩阵、曲线、曲面等基本几何元素的数据结构。几何计算提供了丰富的数学方法如求交、投影、变换、求导、长度计算等。与数据库实体分离OdGe对象是纯粹的几何定义不包含图层、颜色、线型等数据库属性。它们通常由OdDb数据库实体对象生成用于进行复杂的几何运算。OdGe的核心类可按功能分类如下表所示类别代表性类说明基础类型OdGePoint2d,OdGePoint3dOdGeVector2d,OdGeVector3dOdGeMatrix2d,OdGeMatrix3d表示二维/三维点、向量和变换矩阵。是所有几何计算的基础。曲线 (Curve)OdGeCurve2d,OdGeCurve3d(抽象基类)OdGeLineSeg2d,OdGeLineSeg3dOdGeCircArc2d,OdGeCircArc3dOdGeEllipArc2d,OdGeEllipArc3dOdGeNurbCurve2d,**OdGeNurbCurve3d**定义各种二维和三维曲线。OdGeCurve3d是抽象基类OdGeNurbCurve3d等是其具体实现用于参数化曲线计算。曲面 (Surface)OdGeSurface(抽象基类)OdGePlane,OdGeCylinder,OdGeCone,OdGeSphereOdGeNurbSurface定义各种三维曲面。其他OdGeInterval,OdGeBoundBlock2d,OdGeBoundBlock3d表示参数区间、二维/三维边界框等。在 C# (Teigha.NET) 中使用OdGe在 C# 项目中你需要引用 Teigha.NET 的程序集并通过Teigha.Geometry命名空间来访问OdGe的托管封装类。这些类的名称通常与 C 版本对应但遵循 .NET 的命名规范如使用属性而非get/set方法。1. 环境配置与引用首先确保你的项目已正确引用 Teigha.NET 的核心程序集特别是Teigha.Geometry.dll。// 在代码文件顶部添加必要的 using 指令 using Teigha.Runtime; using Teigha.Geometry; // 这是 OdGe 在 C# 中的主要命名空间 using Teigha.DatabaseServices;2. 基础类型使用示例创建点、向量进行基本运算using Teigha.Geometry; public void BasicGeometricOperations() { // 1. 创建三维点 Point3d pointA new Point3d(10.0, 20.0, 0.0); Point3d pointB new Point3d(30.0, 40.0, 5.0); // 2. 创建向量 Vector3d vectorAB pointB - pointA; // 从A指向B的向量 Console.WriteLine($向量 AB: ({vectorAB.X}, {vectorAB.Y}, {vectorAB.Z})); // 3. 向量标准化单位化 if (!vectorAB.IsZeroLength()) { Vector3d unitVector vectorAB.GetNormal(); Console.WriteLine($单位向量: ({unitVector.X}, {unitVector.Y}, {unitVector.Z})); } // 4. 点与向量运算 Point3d pointC pointA vectorAB * 0.5; // A 到 B 的中点 Console.WriteLine($中点 C: ({pointC.X}, {pointC.Y}, {pointC.Z})); // 5. 使用矩阵进行变换平移 Matrix3d translationMatrix Matrix3d.Translation(new Vector3d(5, 10, 0)); Point3d translatedPoint pointA.TransformBy(translationMatrix); Console.WriteLine($平移后的点: ({translatedPoint.X}, {translatedPoint.Y}, {translatedPoint.Z})); }3. 曲线使用示例创建并计算 NURBS 曲线 (OdGeNurbCurve3d)以下示例演示如何创建一个简单的三次 NURBS 曲线由四个控制点定义并在其上采样计算点的位置。using Teigha.Geometry; using System.Collections.Generic; public void CreateAndEvaluateNurbCurve() { // 1. 定义 NURBS 曲线的控制点 ListPoint3d controlPoints new ListPoint3d { new Point3d(0, 0, 0), new Point3d(10, 20, 5), new Point3d(30, 10, -5), new Point3d(40, 0, 0) }; // 2. 定义节点向量 (Knot Vector) // 对于有4个控制点、阶数(p)为3的曲线节点数控制点数 p 1 8 // 这里使用一个均匀的、非周期性的节点向量 [0,0,0,0,1,1,1,1] Listdouble knots new Listdouble { 0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0 }; // 3. 定义权值 (Weights)默认为1 Listdouble weights new Listdouble { 1.0, 1.0, 1.0, 1.0 }; // 4. 创建 OdGeNurbCurve3d 对象 // 参数阶数(degree)3, 控制点, 节点向量, 权值, 是否为有理曲线(false) NurbCurve3d nurbCurve new NurbCurve3d( 3, // degree (阶数 order - 1) controlPoints.ToArray(), knots.ToArray(), weights.ToArray(), false // 非有理曲线所有权值为1时 ); // 5. 使用 evaluatePoint 方法计算曲线上特定参数位置的点 // 这是从 OdGeCurve3d 基类继承的核心方法 double parameter 0.5; // 参数范围通常在节点向量定义的有效区间内此处为[0,1] Point3d evaluatedPoint; Vector3d firstDerivative; // 调用 Evaluate 方法。参数参数值、求导阶数(1表示同时计算一阶导)、输出点、输出导数 nurbCurve.Evaluate(parameter, 1, out evaluatedPoint, out firstDerivative); Console.WriteLine($在参数 t{parameter} 处); Console.WriteLine($ 点坐标: ({evaluatedPoint.X:F2}, {evaluatedPoint.Y:F2}, {evaluatedPoint.Z:F2})); Console.WriteLine($ 一阶导数(切向量): ({firstDerivative.X:F2}, {firstDerivative.Y:F2}, {firstDerivative.Z:F2})); // 6. 获取曲线的其他信息 double startParam, endParam; nurbCurve.GetInterval(out startParam, out endParam); Console.WriteLine($曲线参数区间: [{startParam}, {endParam}]); Console.WriteLine($曲线是否闭合: {nurbCurve.IsClosed()}); }4. 从数据库实体 (OdDbEntity) 获取OdGe几何对象这是最常见的应用场景从 DWG 文件读取一个实体提取其几何定义进行计算或修改。using Teigha.DatabaseServices; using Teigha.Geometry; public void GetGeometryFromEntity(OdDbDatabase db) { using (Transaction tr db.TransactionManager.StartTransaction()) { // 假设我们有一个块表记录和模型空间块表记录 BlockTable bt (BlockTable)tr.GetObject(db.BlockTableId, OpenMode.ForRead); BlockTableRecord btr (BlockTableRecord)tr.GetObject(bt[BlockTableRecord.ModelSpace], OpenMode.ForRead); foreach (ObjectId entityId in btr) { Entity ent tr.GetObject(entityId, OpenMode.ForRead) as Entity; if (ent null) continue; // 示例1处理圆弧 (OdDbArc - OdGeCircArc3d) if (ent is Arc arcEntity) { // 获取圆弧的几何定义 CircularArc3d geArc arcEntity.GetGeCurve() as CircularArc3d; if (geArc ! null) { Point3d center geArc.Center; double radius geArc.Radius; // 使用 geArc 进行几何计算... } } // 示例2处理样条曲线 (OdDbSpline - OdGeNurbCurve3d) if (ent is Spline splineEntity) { // 获取样条曲线的 NURBS 几何表示 NurbCurve3d geSpline splineEntity.GetGeCurve() as NurbCurve3d; if (geSpline ! null) { // 现在可以使用 NurbCurve3d 的所有方法进行分析 // 例如采样一系列点 ListPoint3d samplePoints new ListPoint3d(); double start, end; geSpline.GetInterval(out start, out end); for (double t start; t end; t 0.1) { Point3d pt; geSpline.Evaluate(t, 0, out pt); samplePoints.Add(pt); } } } } tr.Commit(); } }关键注意事项命名空间在 C# 中OdGe的类位于Teigha.Geometry命名空间下。类名可能略有不同如Point3d而非OdGePoint3d但功能对应。对象生命周期OdGe几何对象是纯粹的 .NET 托管对象其生命周期由 CLR 管理无需像 C 中那样手动释放。性能考量虽然OdGe提供了强大的几何计算能力但复杂的运算如大量曲面求交可能耗时。在性能敏感的场景中应合理使用。与OdDb的转换OdDb实体类如OdDbCircle,OdDbSpline通常提供GetGeCurve()或类似的方法来返回其对应的OdGe几何对象。反之也可以通过OdDb实体类的构造函数或设置方法用OdGe对象来创建或更新实体。错误处理Teigha.NET 中的方法在失败时可能会抛出异常或返回错误状态码建议在关键操作中添加try-catch或检查返回值。总之OdGe是 Teigha 中进行所有底层数学和几何计算的基石。在 C# 中通过Teigha.Geometry命名空间你可以以面向对象的方式创建、转换和操作这些几何对象从而实现对 DWG 文件中图形数据的精确控制和复杂分析。参考来源使用Teigha.NET操作DWG基本配置用C调用C生成的dll动态链接库文件ODA介绍