Carbon


ColorInfo

Header: Palettes.h

struct ColorInfo {
    RGBColor ciRGB; 
    SInt16 ciUsage; 
    SInt16 ciTolerance; 
    SInt16 ciDataFields[3]; 
    ataIOPB ataIOParamBlock; 
    ataBusInquiry ataBIParamBlock; 
    ataMgrInquiry ataMIParamBlock; 
    ataAbort ataAbortParamBlock; 
    ataDrvrRegister ataDRParamBlock; 
    ataModifyEventMask ataMEParamBlock; 
    ataRegAccess ataRAParamBlock; 
    ataIdentify ataDIParamBlock; 
    ataDevConfiguration ataDCParamBlock; 
      FormatDiskTuple TPLFMT_DISK; 
      FormatMemTuple TPLFMT_MEM; 
    UInt8 ataByteRegValue; 
    UInt16 ataWordRegValue;
};
typedef ColorInfo ColorInfoPtr;

Field descriptions

ciRGB

An RGB color value, which is defined by the RGBColor structure. It contains three fields that contain integer values for defining, respectively, the red, green, and blue values of the color.

ciUsage

One or more of the usage constants, specifying how this entry is to be used. The ciUsage field can contain any of the “Usage and Update Constants”.

ciTolerance

An integer expressing the range in RGB space within which the red, green, and blue values must fall to satisfy this entry. A tolerance value of $0000 means that only an exact match is acceptable. Values of $0xxx other than $0000 are reserved and should not be used in applications.

ciDataFields

Private fields.

Each color information structure in a palette comprises an RGB color value, information describing how the color is to be used, a tolerance value for colors that need only be approximated, and private fields. You should not create and modify the public fields directly; instead, use Palette Manager functions such as SetEntryColor and SetEntryUsage.

The ColorInfo data type defines a color information structure.


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