Extended Object 80 "Text on Path" (Entity Type "Extended Object")

The extended object "Text on Path" is defined by CAD6studio and CAD6industrie.

Creation of this extended object is not supported in CAD6starter and CAD6engine Eco! If already created, it can be displayed and modified generally, but not modified parametrically.

Data Block Sequence

Data Block 1001( Text )

Data Block 235( Options )

Data Block 1004( Position, Unused1 )

Data Block 1005( Rotation, BaseLine, TextAlign, OtherSide, DrawPath, Unused2 )

Data Block 1003( ObjType )

These data blocks are followed by a sequence of data blocks identical to those stored in an object of type "Surface", see Object 13 "Surface", but without circular arcs!

Parameters

Text

[MKI_STRLONGW] Text to be displayed. Its length may be up to MKI_LENGTH_TEXT_LONG characters including the terminating zero character (0x00). In order to achieve a tabulator, use the character ¬ (Unicode 172). For a line feed, use the character ¶ (Unicode 182). All other characters will be displayed using the given font. Characters below Unicode 32 will be ignored. See also Advanced Text Capabilities.

Options

[MKI_TEXTSTANDARD] Standard text parameters. TextMatrix and LinkedID are unused.

Position

[double] Position of the text's alignment point on the path in percent of the path's total length. Valid range: 0.0 ≤ x ≤ 100.0.

Unused1

[double] Unused, set to 0.0.

Rotation

[__int32] If zero, all characters will be rotated along the path. Otherwise not.

BaseLine

[__int32] Vertical alignment of the text relative to the path. Possible values are:

TextAlign

[__int32] Alignment of the text along the path. Possible values are:

MKI_TEXTMODE_LEFT (0)

The alignment point defines the left end-point of the text.

MKI_TEXTMODE_CENTER (1)

The alignment point defines the center-point of the text.

MKI_TEXTMODE_RIGHT (2)

The alignment point defines the right end-point of the text.

MKI_TEXTMODE_BLOCK (3)

The text will be spread along the whole path. For justification, the word gaps made up by the character ' ' (Ansi 32) will be enlarged. Word gaps made up by the character ' ' (Ansi 160) will not be enlarged, i.e. Ansi 160 is a "fixed space".

OtherSide

[__int32] If non-zero, the text will be placed on the "other" side of the path. Technically, the path will be inverted, switching both the text direction and the side of the path.

DrawPath

[__int32] If non-zero, the path will be displayed along with the text. Otherwise, the path will only be added as a guide curve that will only become visible if definition points are displayed.

Unused2

[__int32] Unused, set to 0.

ObjType

[__int32] Determines whether the path is closed or not. If ObjType is MKI_ENUMDATA_SURFACE, the path is closed, otherwise not.

Interface Command Sequence

MKI_ExtOpen, OwnerID = MKI_DB_OWNER_MK, Type = MKI_OBJ_EXT_TEXT_ON_PATH, Flag = MKI_EXTFLAG_TEXT | MKI_EXTFLAG_MULTITEXT | MKI_EXTFLAG_TEXTPROP

MKI_ExtAddTextStandard

MKI_ExtAddText, Type = 1001, StaticLength = false

MKI_ExtAddDouble, Type = 1004, ElemCount = 2

MKI_ExtAddInt32, Type = 1005, ElemCount = 6

MKI_ExtAddInt32, Type = 1003, ElemCount = 1

MKI_ExtAddPoint, Type = MKI_DB_POINT_START

         ...

MKI_ExtAddPoint, Type = MKI_DB_POINT_END

         ...

MKI_ExtAddPoint, Type = MKI_DB_POINT_PIVOT1

MKI_ExtAddPoint, Type = MKI_DB_POINT_PIVOT2

MKI_ExtAddPoint, Type = MKI_DB_POINT_END

         ...

MKI_ExtFastInsert

Use code like the following to parse the data blocks of this entity in memory:

MKI_BLOCK_ENUM b235( f_pExt ),

               b1001( f_pExt ),

               b1004( f_pExt ),

               b1005( f_pExt ),

               b1003( f_pExt );

b1001.SetNext( b235 );

b1004.SetNext( b1001 );

b1005.SetNext( b1004 );

b1003.SetNext( b1005 );

MKI_TEXTSTANDARD cText = b235.TextStandard();

...