Object 29 "Dimension Arc Length" (Entity Type "Object") Changed in Version 2021.0

Data Block Sequence

Data Block 003( Center )

Data Block 004( Radius )

Data Block 005( Angle1 )

Data Block 005( Angle2 )

Data Block 101( Orientation )

Data Block 000( Line )

Data Block 000( Num1 )

Data Block 000( Num2 )

Data Block 000( Ext1 )

Data Block 000( Ext2 )

Data Block 110( PreText )

Data Block 110( NumText )

Data Block 110( PostText )

Data Block 110( Tolerance1 )

Data Block 110( Tolerance2 )

Data Block 225( Options )

Parameters

Center

[MKI_POINT] Center point of the circle.

Radius

[MKI_POINT] Radius point of the circle.

Angle1

[MKI_POINT] Start angle of the arc.

Angle2

[MKI_POINT] End angle of the arc.

Orientation

[double] Direction of the arc. If Orientation >= 0, the arc is drawn counter-clockwise from the start angle to the end angle. If Orientation < 0, the arc is drawn clockwise.

Line

[MKI_POINT] Dimension line position and/or end.

Num1

[MKI_POINT] Position of the dimension text.

Num2

[MKI_POINT] Direction of the dimension text.

Ext1

[MKI_POINT] First dimension extension line definition.

Ext2

[MKI_POINT] Second dimension extension line definition.

Prefix

[MKI_STRSHORTW] Prefix text for the dimension.

Value

[MKI_STRSHORTW] Dimension text for the dimension.

Postfix

[MKI_STRSHORTW] Postfix text for the dimension.

Tolerance1

[MKI_STRSHORTW] Upper tolerance text for the dimension.

Tolerance2

[MKI_STRSHORTW] Lower tolerance text for the dimension.

Options

[MKI_DIMLARGE] Dimension parameters.

Prefix, Value, and Postfix will be connected to one text ("Main dimension text") without separating characters.

Attributes New in Version 2021.0

An arc length dimension may contain attribute data blocks (see MKI_BLOCK_ATTRIBUTE) only of type "local". They must be placed behind all other datablocks. Attributes of types "outline" and "point" must not exist. The total number of local attributes per object is limited to MKI_ATTRIBS_PER_OBJECT.

Specific Usage of Data Block 225

DimFlag,

LineOrientation,

LineDimType

[__int32] Unused.

LineDistMode

[__int32] The value LineDistMode determines how the dimension line's distance to the dimension is calculated. The distance is the difference of the circle's and the dimension line's radius. Possible values are:

MKI_DIMDISTANCE_ARBITRARY

The dimension line passes through the point Line.

MKI_DIMDISTANCE_FIXED

The dimension line has exactly the distance stated in LineDistance. The position of Line determines on what side it lies.

MKI_DIMDISTANCE_MULTIPLE

The dimension line's distance is a multiple of the value stated in LineDistance, while being as close as possible to Line.

Example

|BlockType|

0,225,0,0,

|TextFont|

0,0,400,"DINDRAFT",

|TextXProperty|

1,1,0,0.0/0.0/0.0,0.0/0.0/0.0,0.0,0,0,

|TextSize1,TextSize2|

5.0,3.5,

|CharDistance,TabDistance,TextMode,TextOrder|

0,4,1,0,

|Precision,Refresh,Centered,Tight,Rotate|

2,1,1,1,0,

|ArrowStart...,ArrowEnd...|

1,0,1,0,

|ExtStartDisplay,ExtEndDisplay,LineDisplay|

1,1,1,

|Orientation,Type,DistMode,Distance|

1,1,0,10.0,0.0,

|System|

0;

This arc length dimension will be lettered with the font "DINLQ", using pen 1. The main dimension has a text size of 5 mm, the tolerances have a text size of 3.5 mm. The dimension number will automatically placed centered and tight to the dimension line, it will be updated automatically.

The dimension line has a fixed distance of 10 mm to the circular arc. Both dimension extension lines will be visible, they are either drawn radially from an edge's end-point to the dimension line or parallel (this depends on settings in the application). At both ends of the dimension line, a filled, non-rotated, triangular arrow will be drawn.

The dimension will be calculated according to the settings in the coordinate system 0 ("- Standard -").

The image above shows an arc length dimension created using the settings described above. The points Center, Radius, Angle1 and Angle2 define the circular arc to be measured. The dimension line has a distance of 10 mm, the point Line determines its position.

The dimension number was centered and set tight automatically, so the point Num1 is irrelevant. As the number is not rotated the point Num2 is not used.

Interface Command Sequence

MKI_ObjectOpen, Type = MKI_OBJ_DARCLENGTH

MKI_ObjectAddPoint, Type = MKI_DB_POINT_CENTER

MKI_ObjectAddPoint, Type = MKI_DB_POINT_RADIUS

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANGLE

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANGLE

MKI_ObjectAddOrient

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANY

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANY

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANY

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANY

MKI_ObjectAddPoint, Type = MKI_DB_POINT_ANY

MKI_ObjectAddTextShort, StaticLength = false

MKI_ObjectAddTextShort, StaticLength = true

MKI_ObjectAddTextShort, StaticLength = false

MKI_ObjectAddTextShort, StaticLength = false

MKI_ObjectAddTextShort, StaticLength = false

MKI_ObjectAddDimLarge

MKI_ObjectFastInsert

Use the MKI_PARSE_OBJ_DARCLENGTH class to parse the data blocks of such an object in memory.