当前位置：首页 > news >正文

CAD二次开发中DoubleCollection用法详解

news 2026/7/1 5:25:34

在 AutoCAD .NET API 中，DoubleCollection是一个用于存储双精度浮点数集合的类，常用于定义多段线（Polyline）的顶点坐标或样条曲线的拟合点等。

核心用法

DoubleCollection通常作为参数传递给需要一系列连续数值的构造函数或方法。其核心用法是按顺序存储坐标值，例如(x1, y1, z1, x2, y2, z2, ...)。

1. 创建与填充 DoubleCollection

你可以通过多种方式创建并填充一个DoubleCollection对象。

// 方法一：使用构造函数并逐个添加 DoubleCollection vertices1 = new DoubleCollection(); vertices1.Add(0.0); // X1 vertices1.Add(0.0); // Y1 vertices1.Add(0.0); // Z1 vertices1.Add(100.0); // X2 vertices1.Add(100.0); // Y2 vertices1.Add(0.0); // Z2 // 方法二：使用集合初始化器（更简洁） DoubleCollection vertices2 = new DoubleCollection { 0.0, 0.0, 0.0, // 顶点1 (X, Y, Z) 100.0, 0.0, 0.0, // 顶点2 100.0, 100.0, 0.0, // 顶点3 0.0, 100.0, 0.0 // 顶点4 };

2. 典型应用：创建三维多段线 (Polyline3d)

这是DoubleCollection最经典的应用场景之一，用于传递多段线所有顶点的三维坐标。

using Autodesk.AutoCAD.ApplicationServices; using Autodesk.AutoCAD.DatabaseServices; using Autodesk.AutoCAD.Geometry; using Autodesk.AutoCAD.Runtime; public class DoubleCollectionExample { [CommandMethod("CreatePoly3d")] public void CreatePoly3d() { Document doc = Application.DocumentManager.MdiActiveDocument; Database db = doc.Database; using (Transaction tr = db.TransactionManager.StartTransaction()) { // 打开块表记录（模型空间）以写入实体 BlockTable bt = (BlockTable)tr.GetObject(db.BlockTableId, OpenMode.ForRead); BlockTableRecord btr = (BlockTableRecord)tr.GetObject(bt[BlockTableRecord.ModelSpace], OpenMode.ForWrite); // 1. 定义多段线的顶点坐标集合 DoubleCollection vertices = new DoubleCollection { // 顶点1 0, 0, 0, // 顶点2 200, 0, 50, // 顶点3200, 150, 100, // 顶点4 0, 150, 0 }; // 2. 创建三维多段线对象 Polyline3d poly3d = new Polyline3d(Poly3dType.SimplePoly, vertices, false); // 3. 将实体添加到模型空间并提交事务 btr.AppendEntity(poly3d); tr.AddNewlyCreatedDBObject(poly3d, true); tr.Commit(); } } }

3. 与其他几何类型的转换

有时需要将Point3dCollection等更结构化的数据转换为DoubleCollection。

// 假设有一个 Point3dCollectionPoint3dCollection points = new Point3dCollection { new Point3d(10, 20, 0), new Point3d(50, 60, 10), new Point3d(100, 30, 20) }; // 转换为 DoubleCollection DoubleCollection coordCollection = new DoubleCollection(); foreach (Point3d pt in points) { coordCollection.Add(pt.X); coordCollection.Add(pt.Y); coordCollection.Add(pt.Z); } // 此时 coordCollection 包含:10, 20, 0, 50, 60, 10, 100, 30, 20

关键注意事项

事项	说明
数据顺序	必须严格按照`X, Y, Z, X, Y, Z...`的顺序添加坐标值，否则图形会错乱。
元素数量	`DoubleCollection`中元素的总数必须是 3 的倍数（对于三维坐标），因为每个顶点由三个`double`值 (X, Y, Z) 构成。
性能考量	对于大量顶点，建议在创建集合时预估大小，或使用更高效的填充方式（如数组转换），以减少内存重新分配。
应用场景	主要用于`Polyline3d`、某些`Spline`拟合数据的构造，以及需要传递原始双精度数组的低层级 API。