MKI_COLORMODE_* (Color Model) Changed in Version 2014.2

The color mode determines how the content of a MKI_COLORVALUE is to be interpreted. The following values are defined:

MKI_COLORMODE_RGB100 (0)

The color is stored in standard RGB format with values of 0 to 255 for each component according to the COLORREF definition. The lowest 8 bits contain the R value, the next 8 bits contain the G value, the next 8 bits the B value. The highest 8 bits are unused and should be zero. Its components will be displayed as percent values.

MKI_COLORMODE_RGB255 (1)

The color is stored in standard RGB format with values of 0 to 255 for each component according to the COLORREF definition. The lowest 8 bits contain the R value, the next 8 bits contain the G value, the next 8 bits the B value. The highest 8 bits are unused and should be zero. Its components will be displayed as absolute values.

MKI_COLORMODE_CMYK100 (2)

The color is stored in CMYK format with values of 0 to 255 for each component. The highest 8 bits contain the C value, the lowest 8 bits contain the K value. Its components will be displayed as percent values.

MKI_COLORMODE_CMYK255 (3)

The color is stored in CMYK format with values of 0 to 255 for each component. The highest 8 bits contain the C value, the lowest 8 bits contain the K value. Its components will be displayed as absolute values.

MKI_COLORMODE_GRAY100 (4)

The color is stored in Gray format with values of 0 to 255 in the lowest 8 bits. The highest 24 bits are unused and should be zero. Its component will be displayed as a percent value.

MKI_COLORMODE_GRAY255 (5)

The color is stored in Gray format with values of 0 to 255 in the lowest 8 bits. The highest 24 bits are unused and should be zero. Its component will be displayed as an absolute value.

MKI_COLORMODE_HSB (6)

The color is stored in HSB format. The highest 7 bits are unused and should be zero. The hue value is stored as degrees (0..360) in the next 9 bits, the saturation value is stored as 1/2 percent (0..200) in the next 8 bits, and the brightness value is stored as 1/2 percent (0..200) in the lowest 8 bits. Its hue component will be displayed as an angle value, its saturation and brightness components will be displayed as percent values.

MKI_COLORMODE_LAB (7) Changed in Version 2014.0

The color is stored in CIELab format. The highest bit is unused, the L* value is stored in 1/5 steps (0 to 500) in the next 9 bits, the a* value is stored in 1/5 steps plus an offset of 1000 (250..1750) in the next 11 bits, and the b* value is stored in 1/5 steps plus an offset of 1000 (250..1750) in the lowest 11 bits. All components will be displayed as absolute values.

MKI_COLORMODE_BYLAYER (8) New in Version 2014.2

The color copies the color value and color mode of the assigned layer. The MKI_COLORVALUE itself is not used at all and should contains all zeros.

Please note that CMYK, Gray, HSB, and CIELab colors cannot be displayed directly on the monitor or output using standard printer drivers since Windows only supports RGB colors. As a result, all those colors will usually be converted into RGB colors during output. Except for HSB and CIELab, this conversion is not perfect and will result in approximations only. The different color models cover different color spaces, so not every color can be converted from one color model to another.

In order to create genuine CMYK, Gray, HSB, or CIELab output, you will require a special PDF output extension!