MKI_PATCHPROPERTY (Entity Data Classes) New in Version 2022.2

C++ Syntax

class MKI_PATCHPROPERTY

{

  public:

  __int32 m_nPen,

          m_nFillMode,

          m_nLayer;

  MKI_COLORVALUE m_cFillColor,

                 m_cLineColor;

  MKI_COLORMODEL m_cFillColorMode;

  MKI_ALPHAVALUE m_cFillAlpha;

  MKI_COLORMODEL m_cLineColorMode;

  MKI_ALPHAVALUE m_cLineAlpha;

  double m_dLineWidth;

  void

  Init( void );

  void

  CopyFromXProperty(

 MKI_CONST_XPROPERTY_REF f_rSource );

  bool

  ICopyToXProperty(

 MKI_XPROPERTY& f_rDestin );

  bool

  IsFilled( void ) const;

  bool

  IsErased( void ) const;

  bool

  IsOpaque( void ) const;

  bool

  IsFramed( void ) const;

};

This structure contains a property set for patches.

Element Description

m_nPen

[__int32] Index of the pen. Valid range: 0 <= Value <= MKI_PEN_MAX.

m_nFillMode

[__int32] The value m_nFillMode determines, which parts of an object are to be drawn (see MKI_FILLMODE_*).

m_nLayer

[__int32] Index of the layer. Valid range: 0 <= Value <= MKI_LAYER_MAX.

m_cFillColor

[MKI_COLORVALUE] Color of the object's surface in the notation defined by m_cFillColorMode.

m_cLineColor

[MKI_COLORVALUE] Color of the object's outline in the notation defined by m_cLineColorMode.

m_cFillColorMode

[MKI_COLORMODEL] Determines how the content of m_cFillColor is to be interpreted (see MKI_COLORMODE_*).

m_cFillAlpha

[MKI_ALPHAVALUE] Determines the translucency of the object's surface.

m_cLineColorMode

[MKI_COLORMODEL] Determines how the content of m_cLineColor is to be interpreted (see MKI_COLORMODE_*).

m_cLineAlpha

[MKI_ALPHAVALUE] Determines the translucency of the object's outline.

m_dLineWidth

[double] Width of the object's outline in [mm] between 0.0 and MKI_LINEWIDTH_MAX (including). A width of 0.0 always results in a line of the minimum width possible on the respective device (one pixel). Must not be negative, i.e. "by layer" (MKI_LINEWIDTH_BYLAYER) is not supported here.

MKD Syntax

In a drawing file, a MKI_PATCHPROPERTY is always expanded to a MKI_XPROPERTY with all remaining values set to 0 (as they are unused and 0 is the smallest possible value in a file).

0,Pen,FillMode,FillColor,LineColor,LineWidth,0,0,

Layer,,FillAlpha,LineAlpha,0

Example

0,0,2,0/1/0/0,0/0/0/0,0.0,0,0,0,-1,0,0,0

If a patch is drawn with these properties, it will result in a RGB red filled patch, outlined with a minimum-width solid black line. It is fully opaque.