Teigha.net实体属性注释

Polyline3d:

3D polyline的类型由PolyType属性存储，

它是由Poly3dType枚举定义的整数值。PolyType属性是一种绘制三维折线的近似方法

Polyline3d polyline = new Polyline3d(Poly3dType.SimplePoly, p3dc, false);

是否闭合:

polyline.Closed = false;

PolyType属性可用于设置和返回折线的类型。

使用非默认构造函数Polyline3d()创建3D polyline实体时，可以指定类型

polyline.PolyType = Poly3dType.QuadSplinePoly;

polyline.ConvertToPolyType(Poly3dType.QuadSplinePoly);

ConvertToPolyType()方法使用SplineFit()方法进行转换。如果需要其他设置，请使用此方法。

将当前三维折线转换为特定类型的三维折线。

线段参数设置为每个样条拟合折线生成的线段数量。大量的线段使折线更平滑。

polyline.SplineFit(Poly3dType.CubicSplinePoly, 3);

将当前3D折线转换为默认类型的3D折线，并使用默认的插值线段数量。

数据库对象的Splinetype和Splinesegs属性相应地设置默认样条类型和段数。

注意，当前Polyline3D对象必须是数据库的常驻对象

polyline.SplineFit();

Polyline3D对象具有拉直(Straighten())方法，

用于去除样条拟合，将样条拟合的三维折线转换为简单的三维折线:

polyline.Straighten();

Polyline3D对象包含用于在polyline中添加和插入顶点的方法。

若要向3D折线添加顶点，请使用AppendVertex()方法:

该方法将新的顶点实体附加到三维折线实体的顶点列表中，并使该折线成为其所有者。

如果折线是数据库驻留符，则必须在返回AppendVertex()方法后显式关闭附加的顶点实体。

PolylineVertex3d vrtx = new PolylineVertex3d(new Point3d(0, 0, 0));

polyline.AppendVertex(vrtx);

polyline.Dispose();

要将顶点插入到3D折线，使用InsertVertexAt()方法:

将指定的顶点实体插入到指定顶点之后的3D折线实体中，并使折线成为其所有者。

如果折线是数据库驻留，则必须在返回InsertVertexAt()方法后显式关闭插入的顶点实体。

insert new vertex after the fourth vertex //在第四个顶点之后插入新顶点

polyline.InsertVertexAt(verticesID[3], vrtx1);

insert new vertex at the beginig of the polyline 在折线的起始点插入新的顶点

polyline.InsertVertexAt(ObjectId.Null, vrtx2);

读取线段

foreach (ObjectId obj in polyline)

{

using (DBObject dbObj = trans.GetObject(obj, OpenMode.ForRead))

{

if (dbObj is PolylineVertex3d)

{

PolylineVertex3d poly3D = (PolylineVertex3d)dbObj;

}

}

}

Polyline3D对象具有只读长度属性，该属性返回以绘图单元测量的所有段长度的和。

MessageBox.Show(polyline.Length.ToString());

Arcs:

圆弧是由一个圆创建的，使用起始角和结束角、中心点和半径来定义。

起始角设置圆弧将从何处绘制的起始点。

结束角设置将绘制圆弧的结束点。这两个角都是用弧度(0到2 *)测量的，

并以逆向时针方计算法向量的原点。

如果起点和终点相同，则实体被画成一个圆。

public Arc(Point3d center, double radius, double startAngle, double endAngle);

• 这个构造函数需要四个参数:

center —圆弧中心点的三维WCS坐标。

radius —弧的半径。

startAngle —以弧度表示的弧的起始角。这个角的正方向是逆时针的。

endAngle —以弧度表示的弧的结束角。这个角的正方向是逆时针的。

Arc arc1 = new Arc(new Point3d(100, 50, 0), 50, 0, 45);

public Arc(Point3d center, Vector3d normal, double radius, double startAngle, double endAngle);

This constructor requires five parameters:

center — Three-dimensional WCS coordinates of the arc's center point.

normal — Three-dimensional vector of the arc’s normal.

radius — Radius of the arc.

startAngle — Start angle of the arc in radians.The positive direction for the angle is counter-clockwise.

endAngle — End angle of the arc in radians.The positive direction for the angle is counter-clockwise.

Arc arc2 = new Arc(new Point3d(100, 50, 0), new Vector3d(0, 0, 1), 150, 0, 90);

public Arc();

默认构造函数，它创建的弧的起始角和结束角为0.0，

半径为0.0，圆心为(0, 0, 0)，法向量为(0, 0, 1)。

using (var trans = F1Show.database.TransactionManager.StartTransaction())

{

using (BlockTableRecord btr = (BlockTableRecord)F1Show.database.CurrentSpaceId.GetObject(OpenMode.ForWrite))

{

btr.AppendEntity(arc1);

btr.AppendEntity(arc2);

trans.AddNewlyCreatedDBObject(arc1, true);

trans.AddNewlyCreatedDBObject(arc2, true);

}

trans.Commit();

}

圆弧的中心、半径、起始角、结束角、法线和厚度属性用于设置和获取圆弧的中心、半径、起始角和结束角、法线和厚度参数。

起始角和结束角属性定义弧的起始角和结束角。角的正方向是逆时针方向，指向法向量的原点。

Arc对象还具有只读的TotalAngle和Length属性。TotalAngle属性获取结束角和开始角之间的差(以弧度为单位)。Length属性获取弧的长度。

if (helperDevice != null)

{

helperDevice.Update();

}

Invalidate();

}

Ellipse:

可以使用下面的Ellipse()构造函数之一创建Ellipse对象。

public Ellipse(Point3d center, Vector3d unitNormal, Vector3d majorAxis, double radiusRatio, double startAngle, double endAngle);

公共椭圆(Point3d中心，Vector3d单位法线，Vector3d主轴，双半径比，双起始角，双结束角);

这个构造函数需要6个参数:

中心 - 中心点的三维WCS坐标。

单位法向量——法向量的三维向量。

主轴 - 指定主轴(中心点到起点)的三维向量。

半径比 - 椭圆的半径比，即小半径(小矢量的长度)与大半径(大矢量的长度)之比。半径比必须在0.000001到1.000000(小半径<大半径)之间。

起始角 - 椭圆的起始角，单位为弧度。这个角的正方向是逆时针方向，指向法向量的原点。

端角 - 椭圆的端角，单位为弧度。这个角的正方向是逆时针方向，指向法向量的原点。

如果起始角为0，结束角为2，则创建一个闭合椭圆，否则构造函数将生成椭圆弧。

创建一个闭合椭圆

Ellipse el1 = new Ellipse(new Point3d(100, 50, 0), new Vector3d(0, 0, 1), new Vector3d(10, 0, 0), 0.7, 0.0, 6.283185);

创建一个椭圆弧，起始角0.0，结束角3.141592弧度

Ellipse el2 = new Ellipse(new Point3d(100, 50, 0), new Vector3d(0, 0, 1), new Vector3d(10, 0, 0), 0.9, 0.0, 3.141592);

默认构造函数，它创建一个半径为1的圆(半径比为1的闭合椭圆)，圆心为(0, 0, 0)，法向量为(0, 0, 1)。

Ellipse el1 = new Ellipse();

Center属性用于设置和获取椭圆的中心。创建椭圆对象后，

设置Center属性来更改椭圆中心的位置。

el1.Center = new Point3d(10, 0, 0);

起始角和结束角属性

StartAngle和EndAngle属性用于设置和获取椭圆的起始角和结束角。

角的正方向是逆时针方向，指向法向量的原点。

如果将StartAngle设置为0,EndAngle设置为2，则创建一个闭合椭圆，否则椭圆将转换为椭圆弧。注意，起始角和结束角必须相差大于1E - 6。

el1.StartAngle = 0;

el1.EndAngle = 1.571;

(MajorAxis and MinorAxis)主轴和小轴的性质是用来得到代表椭圆的主轴和小轴的向量。这两个性质都是从椭圆中心点出发的

(MajorRadius and MinorRadius)大半径和小半径性质分别得到大半径和小半径。大半径是主轴矢量的长度，小半径是主轴矢量的长度。

Normal 法向量性质得到椭圆平面的法向量。

半径比特性用于设置和得到小半径与大半径的比值。大半径必须大于小半径 ，

这意味着半径比必须在0到1之间。如果辐射比大于1.0或小于1E - 6

el1.RadiusRatio = 0.5;

StartParam和EndParam属性相应地获取椭圆的开始和结束参数。用参数定义椭圆圆弧，用矢量参数方程:

p(u) = c + a* cos(u) + b* sin(u)

c 椭圆的中心。

a 椭圆的主轴。

b - 椭圆的小轴。

获取指定角度的参数

要获取与指定角度对应的参数值，可以使用GetParameterAtAngle()

public double GetParameterAtAngle(double angle);

参数求角

要获得与指定参数值对应的角度，使用GetAngleAtParameter()方法:

public double GetAngleAtParameter(double value);

设置椭圆的参数

要设置椭圆的属性，还可以使用set()方法:

public void Set(Point3d center, Vector3d unitNormal, Vector3d majorAxis, double radiusRatio, double startAngle, double endAngle);

具体示例：

Ellipse ellipse = new Ellipse();

ellipse.Set(new Point3d(0, 0, 0), new Vector3d(0, 0, 1), new Vector3d(10, 0, 0), 0.5, 0, 6.2830);

using (var trans = F1Show.database.TransactionManager.StartTransaction())

{

using (BlockTableRecord btr = (BlockTableRecord)F1Show.database.CurrentSpaceId.GetObject(OpenMode.ForWrite))

{

btr.AppendEntity(el1);

btr.AppendEntity(ellipse);

trans.AddNewlyCreatedDBObject(ellipse, true);

}

trans.Commit();

}

if (helperDevice != null)

{

helperDevice.Update();

}

Invalidate();

未完待续。。