Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / Constants and Data Types

Defining Color Spaces

Color Space Constants With Packing Formats

The following enumeration defines constants for color spaces that can specify color values for a bitmap image. All of these constants include a packing format, defined in "Color Packing for Color Spaces" (page 3-21).

enum {
   cmRGBASpace       = cmRGBSpace + cmAlphaSpace,
   cmGrayASpace      = cmGraySpace + cmAlphaSpace,
   cmRGB16Space      = cmWord5ColorPacking + cmRGBSpace,
   cmRGB32Space      = cmLong8ColorPacking + cmRGBSpace,
   cmARGB32Space     = cmLong8ColorPacking + cmAlphaFirstPacking + cmRGBASpace,
   cmCMYK32Space     = cmLong8ColorPacking + cmCMYKSpace,
   cmHSV32Space      = cmLong10ColorPacking + cmHSVSpace,
   cmHLS32Space      = cmLong10ColorPacking + cmHLSSpace,
   cmYXY32Space      = cmLong10ColorPacking + cmYXYSpace,
   cmXYZ32Space      = cmLong10ColorPacking + cmXYZSpace,
   cmLUV32Space      = cmLong10ColorPacking + cmLUVSpace,
   cmLAB32Space      = cmLong10ColorPacking + cmLABSpace,
   cmGamutResult1Space= cmOneBitDirectPacking + cmGamutResultSpace,
   cmRGB24Space      = cm24_8ColorPacking + cmRGBSpace,
   cmRGBA32Space     = cm32_8ColorPacking + cmAlphaLastPacking + cmRGBASpace,
   cmLAB24Space      = cm24_8ColorPacking + cmLABSpace,
   cmNamedIndexed32Space= cm32_32ColorPacking + cmNamedIndexedSpace,
   cmMCFive8Space    = cm40_8ColorPacking + cmMCFiveSpace,
   cmMCSix8Space     = cm48_8ColorPacking + cmMCSixSpace,
   cmMCSeven8Space   = cm56_8ColorPacking + cmMCSevenSpace,
   cmMCEight8Space   = cm64_8ColorPacking + cmMCEightSpace
};

Enumerator descriptions

cmRGBASpace

An RGB color space composed of red, green, and blue color value components and an alpha channel component. ColorSync does not currently support bitmaps that use this constant alone. Instead, this constant indicates the presence of an alpha channel in combination with cmLong8ColorPacking to indicate 8-bit packing format and cmAlphaFirstPacking to indicate the position of the alpha channel as the first component.

cmGrayASpace

A luminance color space with two components, a gray component followed by an alpha channel component. Each component value is 16 bits.

cmRGB16Space

An RGB color space composed of red, green, and blue components whose values are packed with 5 bits of storage per component. The storage size for a color value expressed in this color space is 16 bits, with the high-order bit not used.

cmRGB32Space

An RGB color space composed of red, green, and blue components whose values are packed with 8 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits, with bits 24-31 not used.

cmARGB32Space

An RGB color space composed of red, green, and blue color value components preceded by an alpha channel component whose values are packed with 8 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits.

cmCMYK32Space

A CMYK color space composed of cyan, magenta, yellow, and black components whose values are packed with 8 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits.

cmHSV32Space

An HSV color space composed of hue, saturation, and value components whose values are packed with 10 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits, with the high-order 2 bits not used.

cmHLS32Space

An HLS color space composed of hue, lightness, and saturation components whose values are packed with 10 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits, with the high-order 2 bits not used.

cmYXY32Space

A Yxy color space composed of Y, x, and y components whose values are packed with 10 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits, with the high-order 2 bits not used.

cmXYZ32Space

An XYZ color space composed of X, Y, and Z components whose values are packed with 10 bits per component. The storage size for a color value expressed in this color space is 32 bits, with the high-order 2 bits not used.

cmLUV32Space

An L*u*v* color space composed of L*, u*, and v* components whose values are packed with 10 bits per component. The storage size for a color value expressed in this color space is 32 bits, with the high-order 2 bits not used.

cmLAB32Space

An L*a*b* color space composed of L*, a*, and b* components whose values are packed with 10 bits per component. The storage size for a color value expressed in this color space is 32 bits, with the high-order 2 bits not used.

cmGamutResult1Space

A gamut result color space for the resulting bitmap pointed to by the resultBitMap field of the CWCheckBitMap function (page 3-123), with 1-bit direct packing.

cmRGB24Space

An RGB color space composed of red, green, and blue components whose values are packed with 8 bits of storage per component. The storage size for a color value expressed in this color space is 24 bits.

cmRGBA32Space

An RGB color space composed of red, green, and blue color value components, followed by an alpha channel component. Values are packed with 8 bits of storage per component. The storage size for a color value expressed in this color space is 32 bits.

cmLAB24Space

An L*a*b* color space composed of L*, a*, and b* components whose values are packed with 8 bits per component. The storage size for a color value expressed in this color space is 24 bits.

cmNamedIndexed32Space

A color space where each color is stored as a single 32-bit value, specifying an index into a named color space. The storage size for a color value expressed in this color space is 32 bits.

cmMCFive8Space

A five-channel multichannel (HiFi) data color space, whose values are packed with 8 bits per component. The storage size for a color value expressed in this color space is 40 bits.

cmMCSix8Space

A six-channel multichannel (HiFi) data color space, whose values are packed with 8 bits per component. The storage size for a color value expressed in this color space is 48 bits.

cmMCSeven8Space

A seven-channel multichannel (HiFi) data color space, whose values are packed with 8 bits per component. The storage size for a color value expressed in this color space is 56 bits.

cmMCEight8Space

A eight-channel multichannel (HiFi) data color space, whose values are packed with 8 bits per component. The storage size for a color value expressed in this color space is 64 bits.