PATHDocumentation > Mac OS 8 and 9 > Mutlimedia and Graphics > ColorSync Manager >

Managing Color With ColorSync


Locating the ColorSync Profiles Folder

The ColorSync Manager provides the function CMGetColorSyncFolderSpec to obtain the location of the ColorSync Profiles folder. See the function description for changes starting with ColorSync version 2.5.


CMGetColorSyncFolderSpec

Changed in ColorSync 2.5.

Obtains the volume reference number and the directory ID for the ColorSync Profiles folder.

pascal CMError CMGetColorSyncFolderSpec (
                     short vRefNum,
                     Boolean createFolder,
                     short *foundVRefNum,
                     long *foundDirID);
vRefNum
The reference number of the volume to examine. The volume must be mounted. The constant kOnSystemDisk defined in the Folders header file ( Folders.h ) specifies the active system volume.
createFolder
A flag you set to true to direct the ColorSync Manager to create the ColorSync Profiles folder, if it does not exist. You can use the constants kCreateFolder and kDontCreateFolder , defined in the Folders.h header file, to assign a value to the flag.
foundVRefNum
A pointer to a volume reference number. On output, the volume reference number for the volume on which the ColorSync Profiles folder resides.
foundDirID
A pointer to a directory ID. On output, the directory ID for the volume on which the ColorSync Profiles folder resides.
function result
A result code of type CMError . For possible values, see Result Codes for the ColorSync Manager .

DISCUSSION

If the ColorSync Profiles folder does not already exist, you can use this function to create it.

VERSION NOTES

Starting with version 2.5, the name and location of the profile folder changed, as described in Profile Search Locations .

Your application should use the function CMIterateColorSyncFolder , available starting in ColorSync version 2.5, or one of the search functions described in Searching for Profiles Prior to ColorSync 2.5 , to search for a profile file, even if it is only looking for one file. Do not search for a profile file by obtaining the location of the profiles folder and searching for the file directly.

SEE ALSO

For information about the Macintosh file system, see Inside Macintosh: Files.


© 1988-1999 Apple Computer, Inc. — (Last Updated 20 Jan 99)