MKI_TEXTSTANDARD (Entity Data Classes) Changed in Version 2022.1

C++ Syntax

class MKI_TEXTSTANDARD

{

  public:

  MKI_FONTDEF m_cTextFont;

  MKI_XPROPERTY m_cTextXProperty;

  MKI_UNIQUE_ID m_cLinkedID;

  MKI_MATRIX m_cTextMatrix;

  double m_dCharDistance,

         m_dTabDistance,

         m_dLineDistance;

  __int32 m_nTextMode,

          m_nTextVertical,

          m_nTextOrder,

          m_nDisplayMode,

          m_nSystem,

          m_nUnused;

  void

  Init( void );

  bool

  IsIdentical( const MKI_TEXTSTANDARD& f_rData ) const; New in Version 2022.1

};

This structure contains settings for a standard text or basic settings for a reference text.

Element Description

TextFont

[MKI_FONTDEF] Description of the font to be used for this text.

TextXProperty

[MKI_XPROPERTY] Properties of the text. The properties of the entity itself are not used for texts.

LinkedID New in Version 2017.0

[MKI_UNIQUE_ID] Unique identifier of a entity to which this text is linked. This reference can be used to access the referenced entity's properties such as surface area, perimeter, layer, line styles, etc. This value may contain either a valid UUID (Universally Unique Identifier) or all 0 if unused.

TextMatrix

[MKI_MATRIX] Display matrix of the text. The text will be multiplied with this matrix before display. The matrix contains all operations like translation, rotation, scaling and distortion. The font size is coded as scaling relative to 1 mm.

All transformations apply to the complete text, not to single characters, i.e. a rotation will rotate the complete text, not the single characters.

CharDistance

[double] Determines the gap between two characters. This gap is stated relative to the font size. A value of 0.1 at a font size of 10pt will result in a character gap of 1pt. Allowed values are -10.0 to +10.0. The default value for TrueType and device fonts should be 0.0, for internal fonts 0.125.

TabDistance

[double] Determines the distance between two tabulators. This distance is stated relative to the font size. A value of 4.0 at a font size of 5 mm will result in a tabulator distance of 20 mm. Allowed values are -100.0 to 100.0. The default value is 4.0.

LineDistance

[double] Determines the offset between two lines of text, measured from baseline to baseline. This offset is stated relative to the font size. A value of 1.2 at a font size of 10pt will lead to a line offset of 12pt. Allowed values are -10.0 to 10.0. The default value is 1.0.

TextMode

[__int32] States the horizontal position of the text relative to the insertion point (see MKI_TEXTMODE_*). Block mode is not supported.

TextVertical New in Version 6.50

[__int32] States the vertical position of the text relative to the insertion point (see MKI_TEXTVERTICAL_*).

TextOrder

[__int32] Defines the reading order of the text, i.e. it determines the direction in which the characters are placed (see MKI_TEXTORDER_*).

DisplayMode New in Version 6.20

[__int32] Bit-wise OR combination of some flags indicating the display mode for blocks. Possible values are (see MKI_DISPLAYMODE_*):

MKI_DISPLAYMODE_DEFAULT

MKI_DISPLAYMODE_ADAPT_ANGLE

MKI_DISPLAYMODE_ADAPT_SCALE

System New in Version 2017.0

[__int32] Index of the coordinate system the text shall be based on.

Unused Changed in Version 6.50

[__int32] Currently unused space for future extensions, must not be used!

MKD Syntax

A data block of type MKI_DB_INFO_TEXTSTANDARD (235) is used to store the parameters for standard texts.

TextFont,TextXProperty,LinkedID,TextMatrix,

CharDistance,TabDistance,LineDistance,

TextMode,TextVertical,TextOrder,DisplayMode,System

Example

|TextFont|

1,1,400,"Times New Roman",

|TextXProperty|

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

|LinkedID|

"",

|TextMatrix|

10.0,0.0,0.0,10.0,7.0,-7.0,

|CharDistance,TabDistance,LineDistance|

0.0,4.0,1.0,

|TextMode,TextVertical,TextOrder,DisplayMode, System|

0,3,0,0,0

The text will be displayed using the TrueType font "Times New Roman Italic" with a text size of 10 mm. It will be non-rotated and is aligned left to the position (7.0,-7.0). The characters will be assigned to layer 1 (TextXProperty.Flag = MKI_USE_LAYER, TextXProperty.Layer = 1), they are drawn filled in black.

The character distance will be 0.0 mm (font size 10 mm × 0.0 = 0.0 mm), the tabulator distance will be 40 mm (font size 10 mm × 4.0 = 40 mm) and the line distance 10 mm (font size 10 mm × 1.0 = 10.0 mm).