Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Constants and Data Types

Picker Flags

Your application specifies characteristics for the color picker dialog box in the flags field of the color picker parameter block (page 2-20), the SystemDialogInfo structure (page 2-23), the PickerDialogInfo structure (page 2-24), or the ApplicationDialogInfo structure (page 2-25).

#define DialogIsMoveable      1  
#define DialogIsModal         2  
#define CanModifyPalette      4  
#define CanAnimatePalette     8  
#define AppIsColorSyncAware   16

Constant descriptions

DialogIsMoveable

If your application sets the bit represented by this constant when creating a custom dialog box, then the color picker dialog box is moveable by the user.

DialogIsModal

If your application sets the bit represented by this constant when creating a custom dialog box, then the color picker dialog box is a modal dialog box.

CanModifyPalette

Your application should set the bit represented by this constant if your application can install a palette of its own that may modify (but not animate) the current color table. If you don't want the colors in the document to change as the user makes choices in the color picker dialog box, don't set this flag. See the "Palette Manager Reference" (page 1-3) for information about color palettes.

CanAnimatePalette

If your application sets the bit represented by this constant, then the color picker may modify or animate the palette.

AppIsColorSyncAware

Your application should set the bit represented by this constant if your application uses ColorSync color matching. If your application sets this bit, a color may be returned to your application in a different color space than the one initially passed to the PickColor function. For example, your application could pass an RGB color with no color-matching profile in the field theColor in the color picker parameter block, and the Color Picker Manager could return a CMYK color with its associated profile. If your application does not set this flag, the Color Picker Manager automatically converts any color it receives back from the color picker to an RGB color.

Important

This version of the Color Picker Manager uses ColorSync 1.0 profiles only. The ColorSync 1.0 profile is a handle-based profile. The profile format is defined by Apple Computer. You cannot use version 2.x profiles, which are identified by profile references, with this version of the Color Picker Manager. ColorSync 1.0 profiles typically reside in the ColorSyncTM Profiles folder (within the Preferences folder of the System Folder). They may also be embedded with the images to which they pertain in graphics files. The appendix "ColorSync Manager Backward Compatibility" in Advanced Color Imaging on the Mac OS provides information about the relationship between the ColorSync Manager version 2.x and ColorSync 1.0 profiles, which you may find useful.

The color picker may set any of the following flags and override your application settings:

#define InSystemDialog  32    /* the color picker is in a 
                                 system-owned dialog box */
#define InApplicationDialog64 /* the color picker is in an  
                                 application-owned 
                                 dialog box */
#define InPickerDialog  128   /* the color picker is in its 
                                 own dialog box */
#define DetachedFromChoices256/* the color picker has been 
                                 detached from the 
                                 choices list */