Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

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.