Edit

COLORDATATYPE enumeration (icm.h)

  • Article

Used by WCS functions to indicate the data type of vector content.

Syntax

typedef enum {
  COLOR_BYTE = 1,
  COLOR_WORD,
  COLOR_FLOAT,
  COLOR_S2DOT13FIXED,
  COLOR_10b_R10G10B10A2,
  COLOR_10b_R10G10B10A2_XR,
  COLOR_FLOAT16
} COLORDATATYPE;

Constants

 
COLOR_BYTE
Value: 1
Color data is stored as 8 bits per channel, with a value from 0 to 255, inclusive.
COLOR_WORD
Color data is stored as 16 bits per channel, with a value from 0 to 65535, inclusive.
COLOR_FLOAT
Color data is stored as 32 bits value per channel, as defined by the IEEE 32-bit floating point standard.
COLOR_S2DOT13FIXED
Color data is stored as 16 bits per channel, with a fixed range of -4 to +4, inclusive. A signed format is used, with 1 bit for the sign, 2 bits for the integer portion, and 13 bits for the fractional portion.
COLOR_10b_R10G10B10A2
Color data is stored as 10 bits per channel. The two most significant bits are alpha.
COLOR_10b_R10G10B10A2_XR
Color data is stored as 10 bits per channel, 32 bits per pixel. The 10 bits of each color channel are 2.8 fixed point with a -0.75 bias, giving a range of [-0.76 .. 1.25]. This range corresponds to [-0.5 .. 1.5] in a gamma = 1 space. The two most significant bits are preserved for alpha.

This uses an extended range (XR) sRGB color space. It has the same RGB primaries, white point, and gamma as sRGB.
COLOR_FLOAT16
Color data is stored as 16 bits value per channel, as defined by the IEEE 16-bit floating point standard.

Remarks

The PCOLORDATATYPE and LPCOLORDATATYPE data types are defined as pointers to the COLORDATATYPE enumeration:

typedef COLORDATATYPE *PCOLORDATATYPE, *LPCOLORDATATYPE;

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header icm.h