Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / ColorSync Manager Functions

Accessing Profile Elements /

CMGetScriptProfileDescription

Obtains the name of a profile and the script code identifying the language in which the profile name is specified from the specified profile.

pascal CMError CMGetScriptProfileDescription (
CMProfileRef prof,
Str255 name,
ScriptCode *code);

prof

A profile reference (page 3-63) to the profile whose profile name and script code are obtained.

name

A pointer to a name string. On output, the profile name.

code

A pointer to a script code. On output, the script code.

function result

A result code of type CMError. See "Result Codes" (page 3-174) for a list of ColorSync-specific result codes.

DISCUSSION

The element data of the text description tag, whose signature is 'desc', specifies the profile name and script code. The profile name is returned as a Pascal string. This function returns that information to you so that your application does not need to obtain and parse the element data, which contains other information, such as the name in UniCode format.