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. 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. 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. 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. Its component will be displayed as an absolute value.

MKI_COLORMODE_HSB (6)

The color is stored in HSB format. The hue value is stored as degrees (0..360) in the highest 16 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 L* value is stored in 1/5 steps (0 to 500) in the highest 10 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!