Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 1 - Palette Manager Reference /

Palette Manager Functions / Drawing With Color Palettes

RestoreBack

Sets the current background color to the color you specify.

pascal void RestoreBack(const ColorSpec *c);

c

A pointer to a ColorSpec structure (described in the chapter "Color QuickDraw" of Inside Macintosh: Imaging With QuickDraw) containing the RGB color to be set as the background color.

DISCUSSION

The RestoreBack function stores the RGB color of the ColorSpec structure specified by the c parameter as the current background color. You can restore either the Color QuickDraw foreground color in the CGrafPort structure or the Palette Manager background color in the GrafVars structure. If you specify 0 in the value field of the ColorSpec structure, the RestoreBack function stores the RGB value in the rgbFgColor field of the current CGrafPort structure. If you specify 1 in the value field of the ColorSpec structure, the RestoreBack function stores the RGB value in the pmBkColor field of the GrafVars structure.

IMPORTANT

The RestoreBack function is available only with system software versions 6.0.5 and later and with the 32-Bit QuickDraw system extension.