MKI_COLORDEF (Entity Data Classes) Changed in Version 2019.1

C++ Syntax

class MKI_COLORDEF

{

  public:

  MKI_COLORNAME m_szColorName;

  MKI_COLORVALUE m_cColorValue;

  MKI_COLORMODEL m_cColorMode;

  __int32 m_nColorIndex,

          m_nColorFade;

  void

  Init( void );

};

This structure contains a custom color definition.

Element Description

m_szColorName Changed in Version 2019.1

[MKI_COLORNAME] Name of the custom color, up to 31 characters.

m_cColorValue Changed in Version 6.60

[MKI_COLORVALUE] Final value of the color in the notation defined by m_cColorMode.

m_bColorMode New in Version 6.60

[MKI_COLORMODEL] The value m_cColorMode determines how the content of m_cColorValue is to be interpreted (see MKI_COLORMODE_*).

m_nColorIndex New in Version 6.60

[__int32] Zero-based index of another color onto which this color is based. If negative or invalid, this color is an original color.

m_nColorFade New in Version 6.60

[__int32] Relative brightness of this color relative to its base color in percent. Allowed values are -100 to 100. Negative values make the color darker, positive values make the color lighter.

MKD Syntax

The section =COLOR= contains up to MKI_CUSTOMCOLOR_MAX custom color definitions. Custom colors will be displayed in most color selection dialog windows.

Head of Section

=COLOR=;

TotalNum,ColorHarmonyCount,ColorHarmonyIndex,ColorMixerCount;

Entry for each Color Definition

ColorName,ColorValue,ColorMode,ColorIndex,ColorFade;

Entry for each Color Harmony Entry New in Version 2014.0

ColorValue,ColorMode;

Entry for each Color Mixer Entry New in Version 2014.0

ColorValue,ColorMode;

End of Section

=END=;

If the section =COLOR= does not exist, assume no custom color and no color harmony to be defined (m_nTotalNum = 0, m_nColorHarmonyCount = 0, m_nColorHarmonyIndex = 0, m_nColorMixerCount = 0).

Element Description

m_nTotalNum

[__int32] Number of color definitions to follow. Valid range is 0 to MKI_CUSTOMCOLOR_MAX inclusive.

m_nColorHarmonyCount New in Version 2014.0

[__int32] Number of color harmony entries. Valid range is 0 to MKI_HARMONY_COLORS inclusive. The first entry is always the base color, the other entries are calculated based on that entry.

m_nColorHarmonyIndex New in Version 2014.0

[__int32] Index of the currently chosen color harmony. Possible values are:

MKI_COLORHARMONY_UNKNOWN (0)

 Undefined or unknown harmony (usually set if ColorHarmonyCount is 0). In this case, the defined harmony colors will still be used.

MKI_COLORHARMONY_2 (1)

 2-color harmony with opposite colors on the Liedl color wheel.

MKI_COLORHARMONY_3 (2)

 3-color harmony with equidistant colors on the Liedl color wheel.

MKI_COLORHARMONY_3_60 (3)

 4-color harmony with closer opposite colors on the Liedl color wheel.

MKI_COLORHARMONY_4 (4)

 4-color harmony with equidistant colors on the Liedl color wheel.

MKI_COLORHARMONY_4_60 (5)

 4-color harmony with closer opposite colors on the Liedl color wheel.

MKI_COLORHARMONY_4_30 (6)

 4-color harmony with very close opposite colors on the Liedl color wheel.

MKI_COLORHARMONY_5 (7)

 5-color harmony with equidistant colors on the Liedl color wheel.

MKI_COLORHARMONY_5_30 (8)

 5-color harmony with closer opposite colors on the Liedl color wheel.

MKI_COLORHARMONY_6 (9)

 6-color harmony with equidistant colors on the Liedl color wheel.

MKI_COLORHARMONY_6_30 (10)

 6-color harmony with closer opposite colors on the Liedl color wheel.

MKI_COLORHARMONY_ANALOG (11)

 7-color analogous color row.

MKI_COLORHARMONY_SHADES (12)

 A set of 3 shaded colors and 3 monochromatic derivates.

This index is only used to initialize the list from which the user chooses. It is not used to actively recalculate the color harmonies upon opening the drawing or changing the base color.

m_nColorMixerCount New in Version 2014.0

[__int32] Number of color mixer entries. Valid range is 0 to MKI_MIXER_COLORS inclusive.