Carbon


Usage and Update Constants

Header: Palettes.h

enum {
    pmCourteous = 0,
    pmDithered = 1,
    pmTolerant = 2,
    pmAnimated = 4,
    pmExplicit = 8,
    pmWhite = 16,
    pmBlack = 32,
    pmInhibitG2 = 256,
    pmInhibitC2 = 512,
    pmInhibitG4 = 1024,
    pmInhibitC4 = 2048,
    pmInhibitG8 = 4096,
    pmInhibitC8 = 8192,
    pmNoUpdates = 32768,
    pmBkUpdates = 40960,
    pmFgUpdates = 49152,
    pmAllUpdates = 57344
};

Constant descriptions

pmCourteous

Courteous color.

pmDithered
pmTolerant

Tolerant color.

pmAnimated

Animated color.

pmExplicit

Explicit color.

pmWhite

Use on 1-bit device.

pmBlack

Use on 1-bit device.

pmInhibitG2

Inhibit on 2-bit grayscale device.

pmInhibitC2

Inhibit on 2-bit color device.

pmInhibitG4

Inhibit on 4-bit grayscale device.

pmInhibitC4

Inhibit on 4-bit color device.

pmInhibitG8

Inhibit on 8-bit grayscale device.

pmInhibitC8

Inhibit on 8-bit color device.

pmNoUpdates

Do not update the window when its color environment changes.

pmBkUpdates

Update the window only when it is not the active window.

pmFgUpdates

Update the window only when it is the active window.

pmAllUpdates

Update the window whenever its color environment changes.

The usage constants define how each color in a palette is to be used. (Note that you can combine certain of these constants.) The ciUsage field of ColorInfo) contains usage constants that define how a particular color in a palette is to be used.

The update constants (pmNoUpdates, pmBkUpdates, pmFgUpdates, and pmAllUpdates) determine whether a window is updated based on various changes to the color environment. You use the update constants with the nCUpdates parameter of the NSetPalette function and the updates parameter of the SetPaletteUpdates function.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)