Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / Constants and Data Types

Profile Location Constants

Specification for a Procedure-Based Profile

Your application uses the CMProcedureLocation structure to provide a universal procedure pointer to a profile access procedure. You provide this structure in the CMProfileLocation structure's u field. The CMProcedureLocation structure also contains a pointer field to specify data associated with the profile access procedure.

The ColorSync Manager calls your profile access procedure when the profile is created, initialized, opened, read, updated, or closed.

struct CMProcedureLocation {
   CMProfileAccessUPP proc;/* profile access function universal
                              procedure pointer */
   void *            refCon;/* pointer to access procedure's private data,
                              if any */
};

Field Description

proc

A universal procedure pointer to a profile access procedure. For a description of the procedure, see the MyCMProfileAccessProc function (page 3-172).

refCon

A pointer to the profile access procedure's private data, such as a file or resource name, a pointer to a current offset, and so on.

The ColorSync Manager defines the CMProfileAccessUPP type as follows:

typedef UniversalProcPtr CMProfileAccessUPP;