Inside Macintosh: Advanced Color Imaging Reference /

Chapter 1 - Palette Manager Reference /

Palette Manager Functions / Manipulating Palettes and Color Tables

Palette2CTab

Copies the colors of a palette into a color table.

pascal void Palette2CTab(
                          PaletteHandle srcPalette,
                          CTabHandle dstCTab);

srcPalette

A handle to the palette whose colors are to be used.

dstCTab

A handle to the color table to receive the colors. Color tables are described in the chapter "Color QuickDraw" of Inside Macintosh: Imaging With QuickDraw.

DISCUSSION

The Palette2CTab function copies all of the colors from an existing palette structure into an existing color-table structure. If the structures are not the same size, then Palette2CTab resizes the color-table structure to match the number of entries in the palette structure. If either the palette handle or the color-table handle is nil, Palette2CTab does nothing.