MKI_DIMSMALL (Entity Data Classes) Changed in Version 2022.1

C++ Syntax

class MKI_DIMSMALL

{

  public:

  MKI_FONTDEF m_cTextFont;

  MKI_XPROPERTY m_cTextXProperty;

  MKI_UNIQUE_ID m_cLinkedID;

  double m_dTextSize1,

         m_dTextSize2,

         m_dCharDistance,

         m_dTabDistance;

  __int32 m_nTextMode,

          m_nTextVertical,

          m_nTextOrder,

          m_nNumMode,

          m_nNumPrecision,

          m_nNumRefresh,

          m_nNumRotate,

          m_nSystem,

          m_nDimFlag,

          m_nUnused;

  void

  InitParam( void ); New in Version 2022.1

  void

  CopyParam( const MKI_DIMSMALL& f_rData ); New in Version 2022.1

  void

  InitSmall( void );

  bool

  IsIdenticalSmall( const MKI_DIMSMALL& f_rData ) const; New in Version 2022.1

};

This structure contains settings for a dimension without dimension line.

Element Description

TextFont

[MKI_FONTDEF] Description of the font to be used for the dimension texts (dimension and tolerances).

TextXProperty

[MKI_XPROPERTY] Properties for the dimension texts (dimension and tolerances). The properties of the entity itself are only valid for dimension line and dimension arrow.

LinkedID New in Version 2017.0

[MKI_UNIQUE_ID] Unique identifier of a entity to which this dimension 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.

TextSize1

[double] Font size of the dimension in mm.

TextSize2

[double] Font size of the tolerances in mm.

CharDistance

[double] The value CharDistance 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] The value TabDistance 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.

TextMode

[__int32] The value TextMode states the position of the text relative to the insertion point (see MKI_TEXTMODE_*). Block mode is not supported.

TextVertical New in Version 6.50

[__int32] The value TextVertical states the vertical position of the text relative to the insertion point (see MKI_TEXTVERTICAL_*).

TextOrder

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

NumMode

[__int32] The value NumMode determines how dimension numbers are to be displayed (see MKI_FRACTION_*). If negative, the current number display settings from the assigned coordinate system System will be used.

NumPrecision

[__int32] The value NumPrecision determines the precision of the dimension's display.

If numeric values are displayed as decimal numbers, this value determines the number of fractional digits. The value may be between 0 (no fractional digit) and 14 (fourteen fractional digits). Whether trailing zeros will be displayed or not depends of user-dependent settings in the application.

If numeric values are displayed as fractional numbers, this value determines the maximum power of two that the denominator will have. The value may be between 0 (no fraction) and 14 (maximum denominator 16384). The resulting fraction will be reduced. If the numeric value is 2.1, the resulting fraction will be 2 3/32 for a NumPrecision of 6 and 2 51/512 for a NumPrecision of 9.

NumRefresh

[__int32] The value NumRefresh determines how the dimension shall be (re-)calculated (see MKI_NUMREFRESH_*).

NumRotate

[__int32] The value NumRotate determines how the dimension number shall be rotated (sse MKI_NUMROTATE_*).

System

[__int32] Index of the coordinate system the dimension shall be based on. If this coordinate system is set to a distorting display (isometric or dimetric), the dimension will be calculated accordingly.

DimFlag New in Version 6.51

[__int32] The usage of this value depends on the object type the data block is defined in. Please refer to the description of the corresponding object type for detailed information.

Unused New 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_DIMSMALL (230) is used to store the parameters for dimensions that do not include dimension lines (like area and perimeter).

TextFont,TextXProperty,LinkedID,

TextSize1,TextSize2,CharDistance,TabDistance,

TextMode,TextVertical,TextOrder,

NumMode,NumPrecision,NumRefresh,NumRotate,

System,DimFlag