Layer

Acro Color Layer

1 components102 items
67 Functions 6 Definitions 5 Typedefs 10 Structures 14 Enums

acrocolor

102 items

Functions(67)

ACApplyTransform

AC_Error ACApplyTransform(AC_Transform transform, const void *srcData, void *dstData, ASUns32 count, AC_PackingCode srcPacking, AC_PackingCode dstPacking)
AcroColorProcs.h:741

Applies a color conversion or gamut test transformation. It processes the number of colors specified by, using the memory formats for the source and destination data specified inand. The source data and destination data can point to the same block of memory if the source and destination packing formats use the same number of bits per color.

Parameters
transform: AC_Transform

The color conversion or tranformation to apply.

srcData: const void *

The source data to tranform.

dstData: void *

The destination for the transformed data.

count: ASUns32

The number of colors to transform.

srcPacking: AC_PackingCode

The packing type used in the source data.

dstPacking: AC_PackingCode

The packing type to use in the destination data.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACMakeColorTransform

ACEngineInfo

AC_Error ACEngineInfo(ASUns32 index, AC_String *name, ASUns32 *cmsID, ASUns32 *cmmID)
AcroColorProcs.h:62

Gets information for a CMS/CMM in the AcroColor engine (ACE) by index. The CMS and CMM identifiers specify an engine to the ACE. Engine names should only be used as the text for popup menus. It is better to store the identifiers in settings files (rather than names), because they are independent of localization.

Parameters
index: ASUns32

The zero-based index of the CMS/CMM. The highest legal value is.

name: AC_String *

(Filled by the method) Optional. If it is not, the parameter returns the name of the CMS/CMM.

cmsID: ASUns32 *

(Filled by the method) Returns the CMS identifier.

cmmID: ASUns32 *

(Filled by the method) Returns the CMM identifier.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACEngineCountACSetEngine

ACGetSettingsProfile

AC_Error ACGetSettingsProfile(AC_Settings settings, AC_SettingsKey key, AC_Profile *profile)
AcroColorProcs.h:313

Gets the current color profile for a given key from the AcroColor engine (ACE)object. If the settings file contains a profile entry with the specified key, that profile is returned. If the settings file contains a specialentry with the key, aprofile is returned. If the settings file contains a string with this key rather than an embedded profile, this method returns an installed profile whose description matches the string, if found. In all other cases, AC_Error_MissingKey is returned. The method does not check for known keys or legal key values. It is up to the client to write only legal key values, and to verify key values when reading.

Parameters
settings: AC_Settings

Theobject from which the profile is obtained.

key: AC_SettingsKey

The value key constant.

profile: AC_Profile *

(Filled by the method) A pointer to the current color profile value of the given key.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsStringACGetSettingsUnsigned32ACLoadSettingsACMakeSettingsACUnReferenceProfileACUnReferenceSettings

ACGetSettingsString

AC_Error ACGetSettingsString(AC_Settings settings, AC_SettingsKey key, AC_String *string)
AcroColorProcs.h:394

Gets the current string value for a given key from the AcroColor engine (ACE)object. If the settings file contains a string entry with the specified key, the method returns the entry. If the settings file contains a specialentry with the key, the method returns astring. In all other cases, the method returns AC_Error_MissingKey.

Parameters
settings: AC_Settings

Theobject from which the string is obtained.

key: AC_SettingsKey

The value key constant.

string: AC_String *

(Filled by the method) A pointer to the current string value of the given key.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetSettingsUnsigned32ACLoadSettingsACMakeSettingsACUnReferenceSettingsACUnReferenceString

ACGetSettingsUnsigned32

AC_Error ACGetSettingsUnsigned32(AC_Settings settings, AC_SettingsKey key, ASUns32 *value)
AcroColorProcs.h:416

Gets the current numeric value for a given key from the AcroColor engine (ACE)object. If the settings file contains an unsigned 32-bit numeric entry with the specified key, the method returns the entry. In all other cases, the method returns AC_Error_MissingKey.

Parameters
settings: AC_Settings

Theobject from which the value is obtained.

key: AC_SettingsKey

The value key constant.

value: ASUns32 *

(Filled by the method) A pointer to the current numeric value of the given key.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetSettingsStringACLoadSettingsACMakeSettingsACUnReferenceSettings

ACGetWorkingSpaceProfile

AC_Error ACGetWorkingSpaceProfile(ACWorkingSpace space, AC_Profile *workingProfile)
AcroColorProcs.h:901

Gets a working color profile in a specified color space.

Parameters
space: ACWorkingSpace

The type of color space of the profile to obtain.

workingProfile: AC_Profile *

(Filled by the method) A pointer to the working profile. When done with this object, dereference it using ACUnReferenceProfile().

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACProfilesMatchACUnReferenceProfile

ACLoadSettings

AC_Error ACLoadSettings(AC_Settings settings, AC_FileSpec *file)
AcroColorProcs.h:360

[DEPRECATED] Loads the AcroColor engine (ACE) settings from a file. This method reads the settings entries from the specified file and stores them in theobject, including entries with unknown keys or data formats. As a general rule, the client should keep theobject around so these unknown keys are preserved when the settings are saved out. The only time the client should start with a freshobject is when performing another settings load. Platform: ((!MAC_PLATFORM || !AS_ARCH_64BIT)) && ((!MAC_PLATFORM))

Parameters
settings: AC_Settings

(Filled by the method) Theobject.

file: AC_FileSpec *

A pointer to the file specification for the file containing the settings.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetSettingsStringACGetSettingsUnsigned32ACMakeSettingsACPresetListItemFileACUnReferenceSettingsreplacment ACLoadSettingsU

ACLoadSettingsU

AC_Error ACLoadSettingsU(AC_Settings settings, AC_String file)
AcroColorProcs.h:1114

Reads the settings entries from the specified file. All entries are stored in the settings object, even entries with unknown keys or data formats. As a general rule, the client should keep the settings object around so these unknown keys are preserved when the settings are saved out. The only time the client should start with a fresh settings object is when performing another settings load.

Parameters
settings: AC_Settings
file: AC_String
Returns
AC_Error
See Also
ACLoadSettings

ACMakeBufferProfile

AC_Error ACMakeBufferProfile(AC_Profile *profile, void *data, ASUns32 dataSize)
AcroColorProcs.h:557

Creates a device color profile object from a data buffer containing the raw ICC profile data. The method copies the data, so the client can dispose of the source data. The client should call ACUnReferenceProfile() when done with the profile.

Parameters
profile: AC_Profile *

(Filled by the method) The device profile.

data: void *

The buffer containing the device profile data.

dataSize: ASUns32

The size in bytes of the data buffer.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetWorkingSpaceProfileACMakeCalGrayACMakeCalLabACMakeCalRGBACMonitorProfileACProfileFromCodeACProfileFromDescriptionACUnReferenceProfile

ACMakeCalGray

AC_Error ACMakeCalGray(AC_Profile *profile, ACCalGray *spec, AC_RenderIntent intent, AC_String description)
AcroColorProcs.h:610

Creates a device color profile object from a calibrated grayscale color space with the specified rendering intent and description string. The client should call ACUnReferenceProfile() when done with the profile.

Parameters
profile: AC_Profile *

(Filled by the method) A pointer to the new device color profile.

spec: ACCalGray *

A pointer to the calibrated grayscale color space specification.

intent: AC_RenderIntent

The rendering intent.

description: AC_String

The description of the new profile. If it is non-, it must contain ASCII data, and may contain Unicode data also. If, a hard-coded default description is used.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalLabACMakeCalRGBACMonitorProfileACProfileFromCodeACProfileFromDescriptionACUnReferenceProfile

ACMakeCalLab

AC_Error ACMakeCalLab(AC_Profile *profile, ACCalLab *spec, AC_RenderIntent intent, AC_String description)
AcroColorProcs.h:638

Creates a device color profile object from a calibrated Lab color space with the specified rendering intent and description string. The client should call ACUnReferenceProfile() when done with the profile.

Parameters
profile: AC_Profile *

(Filled by the method) A pointer to the new device color profile.

spec: ACCalLab *

The calibrated Lab color space specification.

intent: AC_RenderIntent

The rendering intent.

description: AC_String

The description of the new profile. If it is non-, it must contain ASCII data, and may contain Unicode data also. If it is, a hard-coded default description is used.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalGrayACMakeCalRGBACMonitorProfileACProfileFromCodeACProfileFromDescriptionACUnReferenceProfile

ACMakeCalRGB

AC_Error ACMakeCalRGB(AC_Profile *profile, ACCalRGB *spec, AC_RenderIntent intent, AC_String description)
AcroColorProcs.h:583

Creates a device color profile object from a calibrated RGB color space, with the specified rendering intent and descriptive string. The client should call ACUnReferenceProfile() when done with the profile.

Parameters
profile: AC_Profile *

(Filled by the method) A pointer to the
new device color profile.

spec: ACCalRGB *

The calibrated RGB color space specification.

intent: AC_RenderIntent

The rendering intent.

description: AC_String

The description of the new profile. If it is non-, the
description must contain ASCII data, and may contain Unicode data also. If it is, a hard-coded default description is used.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalGrayACMakeCalLabACMonitorProfileACProfileFromCodeACProfileFromDescriptionACUnReferenceProfile

ACMakeColorTransform

AC_Error ACMakeColorTransform(AC_Transform *transform, AC_Profile srcProfile, AC_Profile dstProfile, AC_RenderIntent intent)
AcroColorProcs.h:717

Creates a color transformation object. The client can dispose of the source and destination profiles as soon as the transform is created. If the source profile is a device link or abstract profile, then the destination profile must be; otherwise it must be non-.

Parameters
transform: AC_Transform *

(Filled by the method) A pointer to the new color transformation object.

srcProfile: AC_Profile

The source profile from which to transform color data.

dstProfile: AC_Profile

The destination profile to which to transform color data.

intent: AC_RenderIntent

The rendering intent for colors outside the gamut of the destination profile.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACApplyTransformACUnReferenceTransform

ACMakePresetList

AC_Error ACMakePresetList(AC_PresetList *list, AC_SettingsType type)
AcroColorProcs.h:193

Creates a list of preset AcroColor engine (ACE) settings of the specified type. Clients should call ACUnReferencePresetList() when done with the preset list. A preset list is a list of predefined color settings that specifies the source and destination working color profiles to be used for color conversion.

Parameters
list: AC_PresetList *

(Filled by the method) A pointer to the new preset list object.

type: AC_SettingsType

The settings type (AC_SettingsType_Color or AC_SettingsType_Proof).

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACPresetListCountACPresetListItemFileACUnReferencePresetList

ACMakeProfileList

AC_Error ACMakeProfileList(AC_ProfileList *list, AC_SelectorCode selector)
AcroColorProcs.h:109

Creates a list of device color profiles of a given type. Builds a list of those profiles from the database that meet the criterion of the specified selector. If the profile database has never been built, it will be automatically built without a progress callback. Clients should call ACUnReferenceProfileList() when done with the profile list.

Parameters
list: AC_ProfileList *

(Filled by the method) A pointer to the new profile list object.

selector: AC_SelectorCode

The code for the type of device profile to include in the list.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACProfileListCountACProfileListItemCodeACProfileListItemDescriptionACUnReferenceProfileList

ACMakeSettings

AC_Error ACMakeSettings(AC_Settings *settings, AC_SettingsType type)
AcroColorProcs.h:329

Creates an AcroColor engine (ACE)object of a given type, with no entries. When done with all operations, call ACUnReferenceSettings() to free theobject.

Parameters
settings: AC_Settings *

(Filled by the method) A pointer to the newobject.

type: AC_SettingsType

The settings type (AC_SettingsType_Color or AC_SettingsType_Proof).

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetSettingsStringACGetSettingsUnsigned32ACLoadSettingsACUnReferenceSettings

ACMakeString

AC_Error ACMakeString(AC_String *string, const char *ascii, const ASUTF16Val *unicode)
AcroColorProcs.h:786

Creates an AcroColor string from a-terminated ASCII string or a-terminated Unicode string, or both. If both ASCII and Unicode data are specified, the AC_String object keeps track of both in parallel, returning the ASCII data when asked for ASCII, and the Unicode data when asked for Unicode. These dual-encoded strings are useful as description strings for ICC profiles, which can store both ASCII and Unicode data in their description tags. The ICC profile standard requires that the ASCII version of the description string be limited to 7-bit ASCII characters. The AcroColor engine requires only the Unicode descriptions to be unique among profile descriptions.

Parameters
string: AC_String *

(Filled by the method) A pointer to the new string object.

ascii: const char *

The ASCII data. It should be limited to 7-bit ASCII characters for use in profile descriptions.

unicode: const ASUTF16Val *

The Unicode data. All Unicode characters are two byte characters, in native byte order, including the trailing.

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACProfileFromDescriptionACProfileListItemDescriptionACStringASCIIACStringLocalizedACStringUnicodeACUnReferenceString

ACMonitorProfile

AC_Error ACMonitorProfile(AC_Profile *profile, void *monitorID)
AcroColorProcs.h:525

Gets a device color profile for a specific monitor device. The returned profile may be either RGB or grayscale. If no profile is specified by the system, the method returns a default platform profile (sRGB on Windows). The client should call ACUnReferenceProfile() when done with the returned profile. Platform: ((!MAC_PLATFORM || !AS_ARCH_64BIT)) && ((!MAC_PLATFORM))

Parameters
profile: AC_Profile *

(Filled by the method) A pointer to the profile object.

monitorID: void *

A pointer to the platform-specific monitor device identifier. On Windows, this is a-terminated ASCII string containing the monitor's device name (for example,)

Returns
AC_Error

if successful, a non-zero error code otherwise.

See Also
ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalGrayACMakeCalLabACMakeCalRGBACProfileFromCodeACProfileFromDescriptionACUnReferenceProfile

ACPresetFileToName

AC_Error ACPresetFileToName(const AC_FileSpec *file, AC_String *name)
AcroColorProcs.h:264

[DEPRECATED] Translates a preset settings file specification to a name ready to be displayed in menus (with directory paths and file extensions removed). The client should call ACUnReferenceString() when done with the name.

  • If the file contains an internal name tag, the returned string is created from the internal name.
  • If the file does not contain an internal name tag, the returned string is built from the file name. In this case, the method assumes that the file name and the ASCII data of the returned string are in the local script code. Platform: ((!MAC_PLATFORM || !AS_ARCH_64BIT)) && ((!MAC_PLATFORM))

    • Parameters
    file: const AC_FileSpec *

    A pointer to the preset file specification.

    name: AC_String *

    (Filled by the method) A pointer to the display name string.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACPresetListItemFileACUnReferenceStringreplacement ACPresetListItemFileAndNameU

    ACPresetListItemFile

    AC_Error ACPresetListItemFile(AC_PresetList list, ASUns32 index, AC_FileSpec *file)
    AcroColorProcs.h:230

    [DEPRECATED] Gets the file specification for a preset settings item in a preset list. Platform: ((!MAC_PLATFORM || !AS_ARCH_64BIT)) && ((!MAC_PLATFORM))

    Parameters
    list: AC_PresetList

    The preset list object.

    index: ASUns32

    The item index in the list.

    file: AC_FileSpec *

    (Filled by the method) A pointer to the file specification for the item.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACLoadSettingsACMakePresetListACPresetFileToNameACPresetListCountACUnReferencePresetListreplacement ACPresetListItemFileAndNameU

    ACPresetListItemFileAndNameU

    AC_Error ACPresetListItemFileAndNameU(AC_PresetList list, ASUns32 index, AC_String *file, AC_String *name)
    AcroColorProcs.h:1102

    Returns the file specification and a display name of a specified preset in a list. The client should call ACE_UnReferenceString when done with the file and name. Either the file or name parameter can be NULL if the client does not need that value returned. It is an error if both parameters are NULL. Note: If the preset file contains an internal name tag, the returned string is created from the internal name. If the preset file does not contain an internal name tag, the returned string is built from the file name. Any leading path or trailing extension will be removed from the string.

    Parameters
    list: AC_PresetList
    index: ASUns32
    file: AC_String *
    name: AC_String *
    Returns
    AC_Error

    ACProfileDescription

    AC_Error ACProfileDescription(AC_Profile profile, AC_String *description)
    AcroColorProcs.h:443

    Gets the description of a device profile. The returned description string contains both ASCII and Unicode data, even if the profile itself only contains ASCII data.

    Parameters
    profile: AC_Profile

    The device color profile.

    description: AC_String *

    (Filled by the method) A pointer to the description string.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACMakeStringACProfileColorSpaceACProfileDataACProfileListItemDescriptionACProfileFromDescription

    ACProfileFromCode

    AC_Error ACProfileFromCode(AC_Profile *profile, AC_ProfileCode code)
    AcroColorProcs.h:496

    Creates a device profile from a device profile type code. The client should call ACUnReferenceProfile() when done with the profile.

    Parameters
    profile: AC_Profile *

    (Filled by the method) A pointer to the device color profile object.

    code: AC_ProfileCode

    The profile type code.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalGrayACMakeCalLabACMakeCalRGBACMonitorProfileACProfileFromDescriptionACUnReferenceProfile

    ACProfileFromDescription

    AC_Error ACProfileFromDescription(AC_Profile *profile, AC_String description)
    AcroColorProcs.h:475

    Finds a profile matching the description string in the database. The client should call ACUnReferenceProfile() when done with the profile. If the description string contains Unicode text, the Unicode text is used to find the profile. If the description string contains only ASCII text, the method tries to find a match. However, the AcroColor engine requires only Unicode descriptions to be unique, so this might return the wrong profile is in some rare cases. Use ASCII-only description strings only when Unicode description string are unavailable.

    Parameters
    profile: AC_Profile *

    (Filled by the method) A pointer to the device color profile object.

    description: AC_String

    The description string.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalGrayACMakeCalLabACMakeCalRGBACMakeStringACMonitorProfileACProfileFromCodeACProfileListItemDescriptionACUnReferenceProfile

    ACProfileListItemCode

    AC_Error ACProfileListItemCode(AC_ProfileList list, ASUns32 index, AC_ProfileCode *code)
    AcroColorProcs.h:164

    Gets the profile code of a specified profile in a profile list. While this routine is not absolutely required, since the description string is always a unique reference, profile codes have the advantage that they are localization-independent.

    Parameters
    list: AC_ProfileList

    The profile list.

    index: ASUns32

    The index for the profile in the list.

    code: AC_ProfileCode *

    (Filled by the method) A pointer to the profile code. If the specified profile does not have a code, this method returns AC_Profile_Null.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACMakeProfileListACProfileListCountACProfileListItemDescription

    ACProfileListItemDescription

    AC_Error ACProfileListItemDescription(AC_ProfileList list, ASUns32 index, AC_String *description)
    AcroColorProcs.h:145

    Returns the description string of a specified profile in a list. The returned description string always contains both ASCII and Unicode data, even if the profile itself only contains an ASCII version. You can store only the Unicode data in settings files if you wish; the ACProfileFromDescription() method finds the correct profile when passed the Unicode-only string.

    Parameters
    list: AC_ProfileList

    The profile list.

    index: ASUns32

    The index for the profile in the list.

    description: AC_String *

    (Filled by the method) A pointer to the profile description string.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACMakeProfileListACMakeStringACProfileFromDescriptionACProfileListCountACProfileListItemCode

    ACProfilesMatch

    AC_Error ACProfilesMatch(AC_Profile workingProfile, AC_Profile documentProfile, ASBool *match)
    AcroColorProcs.h:922

    Compares the working device profile with the document device profile to determine if they are the same. This comparison ignores rendering intents, and is, allowing very close, but not exactly the same, profiles to match. Equivalent profiles always match, but some non-equivalent profiles may also match.

    Parameters
    workingProfile: AC_Profile

    The working device color profile.

    documentProfile: AC_Profile

    The document's device color profile.

    match: ASBool *

    (Filled by the method) A pointer to the result:if the profiles match,otherwise.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACGetSettingsProfileACGetWorkingSpaceProfileACUnReferenceProfile

    ACSetBlackPointCompensation

    AC_Error ACSetBlackPointCompensation(ASUns32 bpc)
    AcroColorProcs.h:1149

    Sets the black-point compensation flag, which controls whether to adjust for differences in black points when converting colors between color spaces. When enabled, the full dynamic range of the source space is mapped into the full dynamic range of the destination space. When disabled, the dynamic range of the source space is simulated in the destination space (which can result in blocked or gray shadows).

    Parameters
    bpc: ASUns32

    to enable black-point compensation,otherwise.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACSetBlackPointCompensation

    ACSetEngine

    AC_Error ACSetEngine(ASUns32 cmsID, ASUns32 cmmID)
    AcroColorProcs.h:87

    Sets the AcroColor engine (ACE) for the system, changing the global default CMS/CMM choice. This method rebuilds all existing transforms using the new engine. If the user aborts the process, or if the ACE runs out of resources during the rebuilding process, an error code is returned and some existing transforms may still use the previous engine choice. Everything will still work, since multiple engines can be used at once. Call the method again to restart the transform rebuilding process.

    Parameters
    cmsID: ASUns32

    The Color Management System identifier for the new engine default, as returned by ACEngineInfo().

    cmmID: ASUns32

    The Color Management Module identifier for the new engine default, as returned by ACEngineInfo().

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACEngineCountACEngineInfo

    ACStringASCII

    AC_Error ACStringASCII(AC_String string, char *buffer, ASUns32 *count, ASUns32 maxCount)
    AcroColorProcs.h:820

    Copies the ASCII version of a string into a supplied buffer. Either theor thecan be. The ICC profile standard requires that ASCII version of the profile description string be limited to 7-bit ASCII characters. Depending on the API, operating system, file contents, and so on, the method can return strings in the local script code (8 bit single byte or 8 bit encoded multi-byte). Clients should always assume that the ASCII data is in the local script code (of which the 7-bit ASCII characters are a subset).

    Parameters
    string: AC_String

    The AcroColor string containing ASCII data. If the string does not contain an ASCII version, the method returns AC_Error_NoASCII.

    buffer: char *

    (Filled by the method) A buffer to contain a copy of the ASCII data.

    count: ASUns32 *

    (Filled by the method) A pointer to the size ofin bytes, including the trailingcharacter.

    maxCount: ASUns32

    The maximum size ofin bytes. If the length of the string is longer than this value, the method copies a truncated string to theand returns AC_Error_StringOverflow.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACMakeStringACStringLocalizedACStringUnicodeACUnReferenceString

    ACStringLocalized

    AC_Error ACStringLocalized(AC_String string, ASUTF16Val *buffer, ASUns32 *count, ASUns32 maxCount)
    AcroColorProcs.h:854

    Copies the localized Unicode version of a string into a supplied buffer. Either theor thecan be. The settings file format and ICC profiles later than version 2 can contain text in multiple languages or countries. When the AcroColor engine (ACE) create strings from these files or profiles, it uses the current language and country codes to create strings with a third fork: a localized Unicode version. These localized versions are intended for user display only and should not be stored in preferences files or action scripts, since they vary from country to country and are not portable.

    Parameters
    string: AC_String

    The AcroColor string containing localized Unicode data. If the string does not contain a localized Unicode version, the method returns AC_Error_NoLocalized.

    buffer: ASUTF16Val *

    (Filled by the method) A buffer to contain a copy of the localized Unicode data.

    count: ASUns32 *

    (Filled by the method) A pointer to the size (in bytes) of the, including the trailingcharacter.

    maxCount: ASUns32

    The maximum size of thein bytes. If the length of the string is longer than this value, the method copies a truncated string to theand returns AC_Error_StringOverflow.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACMakeStringACStringASCIIACStringUnicodeACUnReferenceString

    ACStringUnicode

    AC_Error ACStringUnicode(AC_String string, ASUTF16Val *buffer, ASUns32 *count, ASUns32 maxCount)
    AcroColorProcs.h:877

    Copies the Unicode version of a string into a supplied buffer. Either theor thecan be.

    Parameters
    string: AC_String

    The AcroColor string containing localized Unicode data. If the string does not contain a Unicode version, the method returns AC_Error_NoUnicode.

    buffer: ASUTF16Val *

    (Filled by the method) A buffer to contain a copy of the Unicode data.

    count: ASUns32 *

    (Filled by the method) A pointer to the size ofin bytes, including the trailingcharacter.

    maxCount: ASUns32

    The maximum size ofin bytes. If the length of the string is longer than this value, the method copies a truncated string to theand returns AC_Error_StringOverflow.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACMakeStringACStringASCIIACStringLocalizedACUnReferenceString

    ACSwatchBooksFind

    ACSwatchBookDB ACSwatchBooksFind(ASUns32 count, ASFileSys fs, ASPathName *folders)
    AcroColorProcs.h:998

    Retrieves andatabase object, containing the swatchbooks found by searching the folders given. The folders are usually determined by using the. This always scans the swatchbook directories, so this should be called every time one is going to make a list of the swatchbooks, in case a user installed a swatchbook in the user directory while the application was open. PDF library clients must pass in whatever folder location is appropriate.

    Parameters
    count: ASUns32

    The number of folders in the folders array.

    fs: ASFileSys
    folders: ASPathName *

    A pointer to an array of path names for the folders to search.

    Returns
    ACSwatchBookDB

    A swatchbook database object. Callwhen this is no longer needed.

    ACUnReferenceProfile

    AC_Error ACUnReferenceProfile(AC_Profile profile)
    AcroColorProcs.h:694

    Decrements the reference count of a device color profile object. If this causes the object's reference count to reach zero, the method deletes it.

    Parameters
    profile: AC_Profile

    The profile object.

    Returns
    AC_Error

    if successful, a non-zero error code otherwise.

    See Also
    ACGetSettingsProfileACGetWorkingSpaceProfileACMakeBufferProfileACMakeCalGrayACMakeCalLabACMakeCalRGBACMonitorProfileACProfileFromCodeACProfileFromDescription

    PDColorConvertPDEElement

    PDEElement PDColorConvertPDEElement(PDDoc doc, PDEElement elem, AC_Profile targetProfile, AC_RenderIntent intent, ASBool embed)
    AcroColorProcs.h:984

    Converts a PDEElement to the supplied color space.

    Parameters
    doc: PDDoc

    The document in which the element is located.

    elem: PDEElement

    The element to convert.

    targetProfile: AC_Profile

    The ICC profile to which the color should be converted.

    intent: AC_RenderIntent

    The rendering intent to use for the conversion. AC_UseProfileIntent can be passed in order to use the default intent. (Note that it is not actually using the profile intent, but is using the current intent in the PDF graphics state).

    embed: ASBool

    If, embed the color space and make the object calibrated. If it isand the target profile is CMYK, RGB, or Gray, the colors space of the resulting object, after conversion, will be DeviceCMYK, DeviceRGB, or DeviceGray, respectively.

    Returns
    PDEElement

    A PDEElement containing the converted data. Note that the source element is copied and its reference count is not decremented, so the caller should decrement the source element's reference count if it is no longer needed. @see PDColorConvertPDEElementEx

    PDColorConvertPDEElementEx

    PDEElement PDColorConvertPDEElementEx(PDDoc doc, PDEElement elem, PDColorConvertParamsEx params)
    AcroColorProcs.h:1129

    Converts a PDEElement to the supplied color space.

    Parameters
    doc: PDDoc

    The document in which the element is located.

    elem: PDEElement

    The element to convert.

    params: PDColorConvertParamsEx

    The parameters block that describes how color conversions are to be performed.

    Returns
    PDEElement

    A PDEElement containing the converted data. Note that the source element is copied and its reference count is not decremented, so the caller should decrement the source element's reference count if it is no longer needed. @see PDColorConvertPDEElement

    PDColorConvertPDEElementEx2

    PDEElement PDColorConvertPDEElementEx2(PDDoc doc, PDEElement elem, PDColorConvertParamsEx params, ASInt32 pageNum)
    AcroColorProcs.h:1187

    Converts a PDEElement to the supplied color space.

    Parameters
    doc: PDDoc

    The document in which the element is located.

    elem: PDEElement

    The element to convert.

    params: PDColorConvertParamsEx

    The parameters block that describes how color conversions are to be performed.

    pageNum: ASInt32

    The page on which the element is present.

    Returns
    PDEElement

    A PDEElement containing the converted data. Note that the source element is copied and its reference count is not decremented, so the caller should decrement the source element's reference count if it is no longer needed. @see PDColorConvertPDEElement

    PDDocColorConvertEmbedOutputIntentEx

    void PDDocColorConvertEmbedOutputIntentEx(PDDoc doc, AC_Profile OIProfile, ASAtom subtype)
    AcroColorProcs.h:1160

    Embeds an output intent into a document.

    Parameters
    doc: PDDoc

    The document in which to embed the output intent.

    OIProfile: AC_Profile

    The parameter from which to get the output intent, described as the target space.

    subtype: ASAtom

    The ASAtom for the name of output intent subtype created. The subtype must be one of the following: GTS_PDFX, GTS_PDFA1, or ISO_PDFE1.

    Returns
    void

    PDDocColorConvertPage

    ASBool PDDocColorConvertPage(PDDoc doc, PDColorConvertParams params, ASInt32 pageNum, ASProgressMonitor progMon, void *progMonData, PDColorConvertReportProc reportProc, void *reportProcData, ASBool *changed)
    AcroColorProcs.h:937

    Converts the colors (in place) on a page, as specified by theblock.

    Parameters
    doc: PDDoc

    The document in which to convert a page.

    params: PDColorConvertParams

    The parameter block that describes how color conversions are to be performed.

    pageNum: ASInt32

    The page number of the page to convert.

    progMon: ASProgressMonitor

    The progress monitor callback. This call will set the duration of the monitor to the number of elements in the top-level content stream, and will update the value as the elements are converted. If this parameter is zero, no progress monitor callback is called.

    progMonData: void *

    The data element to be passed into progress monitor calls.

    reportProc: PDColorConvertReportProc

    The reporting callback; it reports the attributes and action of each object converted to the callback. Passing in a zero reporting callback means that no reporting will be done.

    reportProcData: void *

    The data element to be passed into.

    changed: ASBool *
    Returns
    ASBool

    if the conversion was aborted or failed.

    PDDocColorConvertPageEx

    ASBool PDDocColorConvertPageEx(PDDoc doc, PDColorConvertParamsEx paramsEx, ASInt32 pageNum, ASProgressMonitor progMon, void *progMonData, PDColorConvertReportProc reportProc, void *reportProcData, ASBool *changed)
    AcroColorProcs.h:954

    Convert the colors (in place) in a page as specified by theblock. Takes an extended parameters block.

    Parameters
    doc: PDDoc

    The document in which to convert a page.

    paramsEx: PDColorConvertParamsEx
    pageNum: ASInt32

    The page number of the page to convert.

    progMon: ASProgressMonitor

    The progress monitor callback. This call will set the duration of the monitor to the number of elements in the top-level content stream, and will update the value as the elements are converted. If this parameter is zero, no progress monitor callback is called.

    progMonData: void *

    The data element to be passed into progress monitor calls.

    reportProc: PDColorConvertReportProc

    The reporting callback; it reports the attributes and action of each object converted to the callback. Passing in a zero reporting callback means that no reporting will be done.

    reportProcData: void *

    The data element to be passed into.

    changed: ASBool *
    Returns
    ASBool

    if the conversion was aborted or failed.

    PDPageColorConvertEmbedOutputIntent

    void PDPageColorConvertEmbedOutputIntent(PDPage page, AC_Profile OIProfile, ASAtom subtype)
    AcroColorProcs.h:1172

    Embeds an output intent into specified page.

    Parameters
    page: PDPage

    The page in which to embed the output intent.

    OIProfile: AC_Profile

    The parameter from which to get the output intent, described as the target space.

    subtype: ASAtom

    The ASAtom for the name of output intent subtype created. The subtype must be one of the following: GTS_PDFX, GTS_PDFA1, or ISO_PDFE1.

    Returns
    void

    Typedefs(5)

    Structures(10)

    Enums(14)

    ACWorkingSpace

    AcroColorExpT.h:1236

    Constants that specify the color space of working profiles. This enumeration is added for the purpose of ACGetWorkingSpaceProfile(). The profile returned by this function must be unreferenced by the caller.

    Values
    kACWorkingGray
    —

    Grayscale profile.

    kACWorkingRGB
    —

    RGB profile.

    kACWorkingCMYK
    —

    CMYK profile.

    kACWorkingSpaces
    —

    Working spaces.

    See Also
    ACGetWorkingSpaceProfile

    AC_ColorSpace

    AcroColorExpT.h:1117

    Constant values for ICC color space signatures.

    Values
    AC_Space_XYZ
    —
    AC_Space_Lab
    —
    AC_Space_RGB
    —
    AC_Space_Gray
    —
    AC_Space_CMYK
    —
    AC_Space_Luv
    —
    AC_Space_YCbCr
    —
    AC_Space_HSV
    —
    AC_Space_HLS
    —
    AC_Space_CMY
    —
    AC_Space_2Component
    —
    AC_Space_3Component
    —
    AC_Space_4Component
    —
    AC_Space_5Component
    —
    AC_Space_6Component
    —
    AC_Space_7Component
    —
    AC_Space_8Component
    —
    AC_Space_9Component
    —
    AC_Space_10Component
    —
    AC_Space_11Component
    —
    AC_Space_12Component
    —
    AC_Space_13Component
    —
    AC_Space_14Component
    —
    AC_Space_15Component
    —
    AC_Space_PhotoYCC
    —

    Kodak's PhotoYCC space is stored as a generic 3-component space.

    AC_Space_Null
    —

    A null color space. Used to represent spot-only color spaces.

    AC_Space_MaxEnum
    —

    This constant forces the enum to be 32 bits wide.

    See Also
    ACProfileColorSpace

    AC_Error

    AcroColorExpT.h:268

    Error codes returned by AcroColor functions.

    Values
    AC_Error_None
    —

    No error.

    AC_Error_General
    —

    Other error.

    AC_Error_Param
    —

    Bad parameters to an API call.

    AC_Error_Version
    —

    Application and ACE library mismatch.

    AC_Error_UserAbort
    —

    The user aborted the operation. Returned by ACE when the client progress callback returns.

    AC_Error_Memory
    —

    Out of memory.

    AC_Error_StackFull
    —

    Out of stack space.

    AC_Error_ScratchFull
    —

    Client callback ran out of scratch space.

    AC_Error_StringOverflow
    —

    String does not fit in supplied buffer.

    AC_Error_NoASCII
    —

    String does not contain ASCII data.

    AC_Error_NoUnicode
    —

    String does not contain Unicode data.

    AC_Error_NoLocalized
    —

    String does not contain localized data.

    AC_Error_BadAlignment
    —

    Data is not correctly byte aligned.

    AC_Error_BadDescription
    —

    Invalid profile description.

    AC_Error_BadConcat
    —

    Unable to concatenate transforms.

    AC_Error_BadMerge
    —

    Unable to merge transforms.

    AC_Error_BadProfile
    —

    Invalid profile.

    AC_Error_UnsupCMS
    —

    Unsupported CMS.

    AC_Error_UnsupOption
    —

    Unsupported ACE option.

    AC_Error_UnsupPacking
    —

    Unsupported packing code.

    AC_Error_UnsupProfile
    —

    Unsupported profile version.

    AC_Error_UnsupProfileCode
    —

    Unsupported profile code.

    AC_Error_UnsupSpace
    —

    Unsupported color space.

    AC_Error_UnsupQuery
    —

    Unsupported query code.

    AC_Error_MissingProfile
    —

    A profile was missing from the disk.

    AC_Error_ModifiedProfile
    —

    The profile on disk has been modified.

    AC_Error_FileNotFound
    —

    File is missing from disk.

    AC_Error_EOF
    —

    End of file error.

    AC_Error_FileLocked
    —

    File locked error.

    AC_Error_DiskIO
    —

    Disk I/O error.

    AC_Error_ColorSync
    —

    A problem using ColorSync.

    AC_Error_ICM
    —

    A problem using ICM.

    AC_Error_MissingKey
    —

    The color settings does not contain this key.

    AC_Error_InvalidSettings
    —

    The color settings file is invalid.

    AC_Error_SettingsVersion
    —

    The color settings file is an incompatible version.

    AC_Error_NotImplemented
    —

    The function is not implemented (subsetted library).

    AC_Error_MaxEnum
    —

    This constant forces theto be 32 bits wide.

    AC_PackingCode

    AcroColorExpT.h:492

    Constants that specify the packing used in a color transformation.

    Values
    AC_Packing_pRGB8
    —

    8-bit RGB (or grayscale destination), with a leading pad byte. When grayscale is output in this format, the gray value is replicated into to the R, G, and B values.

    is black.

    is white.

    Data must be 32-bit aligned.

    AC_Packing_RGB8
    —

    Same as AC_Packing_pRGB8, without the leading pad byte. Data need only be 8-bit aligned.

    AC_Packing_pRGB15
    —

    15+ bit RGB (or grayscale destination), with a leading pad word. When grayscale is output in this format, the gray value is replicated into to the R, G, and B values.

    is black.

    is white.

    Values greater thanare invalid.

    Data must be 64-bit aligned.

    AC_Packing_CMYK8_Black0
    —

    8-bit CMYK.

    is 100% ink.

    is 0% ink.

    Data must be 32-bit aligned.

    AC_Packing_CMYK8_White0
    —

    Same as AC_Packing_CMYK8_Black0 with inverse encoding.

    AC_Packing_CMYK15_Black0
    —

    15+ bit CMYK.

    is 100% ink.

    is 0% ink.

    Values greater thanare invalid.

    Data must be 64-bit aligned.

    AC_Packing_pLab8
    —

    8-bit LAB, with a leading pad byte.

    means

    means

    means

    means

    means

    Data must be 32-bit aligned.

    AC_Packing_Lab8
    —

    Same as AC_Packing_pLab8, without the leading pad byte.

    Data need only be 8-bit aligned.

    AC_Packing_pLab15
    —

    15+ bit LAB, with a leading pad word.

    means

    means

    means

    means

    means

    Values greater thanare invalid.

    Data must be 64-bit aligned.

    AC_Packing_Gray8_Black0
    —

    8-bit grayscale or gamut test results, no padding.

    is 100% ink or black or fully out of gamut.

    is 0% ink or white or fully in gamut.

    When used for gamut test results, any value greater than or equal toshould be considered to be in gamut.

    AC_Packing_Gray8_White0
    —

    Same as AC_Packing_Gray8_Black0 with inverse encoding.

    AC_Packing_Gray15_Black0
    —

    15+ bit grayscale or gamut test results, no padding.

    is 100% ink or black or fully out of gamut.

    is 0% ink or white or fully in gamut.

    Values greater thanare invalid.

    Data must be 16-bit aligned.

    AC_Packing_pXYZ16
    —

    16-bit XYZ, with a leading pad word.

    means

    means

    means.

    Data must be 64-bit aligned.

    AC_Packing_pABC8
    —

    Generic padded 3-component 8-bit packing. Data must be 32-bit aligned.

    AC_Packing_ABC8
    —

    Same as AC_Packing_pABC8, without the leading pad byte. Data need only be 8-bit aligned.

    AC_Packing_pABC15
    —

    Generic padded 3-component 15+ bit packing. Data must be 64-bit aligned.

    AC_Packing_ABCD8
    —

    Generic 4-component 8-bit packing. Data must be 32-bit aligned.

    AC_Packing_ABCD15
    —

    Generic 4-component 15+ bit packing. Data must be 64-bit aligned.

    AC_Packing_CS64_Gray
    —

    Packing codes for native 64-bit (gray) ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_CS64_RGB
    —

    Packing codes for native 64-bit (RGB) ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_CS64_CMYK
    —

    Packing codes for native 64-bit (CMYK) ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_CS64_Lab
    —

    Packing codes for native 64-bit (Lab) ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_CS64_XYZ
    —

    Packing codes for native 64-bit (xyz) ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_CS64_ABC
    —

    Packing codes for native 64-bit (abc) ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_CS64_ABCD
    —

    Packing codes for native 64-bit (abcd)ColorSync formats (type "CMColor"). ICM2 also uses these packings formats (type "COLOR"). See the Apple ColorSync documentation for the details of these formats. These are mostly intended for internal use by ACE, and are not intended for use by most ACE clients. Data must be 16-bit aligned.

    AC_Packing_Null
    —

    data, for use with data in AC_Space_Null.

    AC_Packing_General
    —

    None of the above; use the general packing specification.

    AC_Packing_MaxEnum
    —

    This constant forces theto be 32 bits wide.

    AC_ProfileCode

    AcroColorExpT.h:389

    Constants that describe the type of a device color profile.

    Values
    AC_Profile_Null
    —

    Aresult, indication that a profile is not a built-in profile.

    AC_Profile_Lab_D50
    —

    Adobe's standard Lab profile. It has a white point of D50, and exactly matches the ICC's Lab PCS space.

    AC_Profile_PCS_XYZ
    —

    An XYZ profile that exactly matches the ICC's XYZ PCS space.

    AC_Profile_Flat_XYZ
    —

    An XYZ profile with a flat white point encoding (). Photoshop uses this as an intermediate space in its display loop.

    AC_Profile_sRGB
    —

    HP's sRGB profile. The default Windows monitor profile.

    AC_Profile_AppleRGB
    —

    Default RGB space using by Photoshop 4.0 and earlier. The default Mac OS monitor profile.

    AC_Profile_AdobeRGB1998
    —

    A wider gamut RGB space recommended by Adobe.

    AC_Profile_ColorMatchRGB
    —

    A simplified version of Radius' ColorMatch RGB space, without Radius' non-zero black point.

    AC_Profile_Gamma18
    —

    Grayscale display profile with a gamma of 18.

    AC_Profile_Gamma22
    —

    Grayscale display profile with a gamma of 22.

    AC_Profile_DotGain10
    —

    Grayscale printer profile with a dot gain of 10.

    AC_Profile_DotGain15
    —

    Grayscale printer profile with a dot gain of 15.

    AC_Profile_DotGain20
    —

    Grayscale printer profile with a dot gain of 20.

    AC_Profile_DotGain25
    —

    Grayscale printer profile with a dot gain of 25.

    AC_Profile_DotGain30
    —

    Grayscale printer profile with a dot gain of 30.

    AC_Profile_MonitorRGB
    —

    The system "Monitor RGB" profile, which is the same profile as that returned by AC_MainMonitorProfile.

    AC_Profile_SystemRGB
    —

    The system default profiles for RGB color space. (Currently a ColorSync 3.0 only feature.)

    AC_Profile_SystemCMYK
    —

    The system default profiles for CMYK color space. (Currently a ColorSync 3.0 only feature.)

    AC_Profile_SystemGray
    —

    The system default profiles for Gray color space. (Currently a ColorSync 3.0 only feature.)

    AC_Profile_SystemInput
    —

    The system default profiles for input device type. (Currently a ColorSync 3.0 only feature.)

    AC_Profile_SystemOutput
    —

    The system default profiles for output device type. (Currently a ColorSync 3.0 only feature.)

    AC_Profile_SystemProofer
    —

    The system default profiles for proofer device type. (Currently a ColorSync 3.0 only feature.)

    AC_Profile_WorkingRGB
    —

    The application working (RGB) color space profiles. (For use as abstact values only, since ACE does not keep track of these profiles, and thus cannot make profiles from these codes.)

    AC_Profile_WorkingCMYK
    —

    The application working (CMYK) color space profiles. (For use as abstact values only, since ACE does not keep track of these profiles, and thus cannot make profiles from these codes.)

    AC_Profile_WorkingGray
    —

    The application working (gray) color space profiles. (For use as abstact values only, since ACE does not keep track of these profiles, and thus cannot make profiles from these codes.)

    AC_Profile_Acrobat5_CMYK
    —
    AC_Profile_Acrobat9_CMYK
    —
    AC_Profile_MaxEnum
    —

    This constant forces the enum to be 32 bits wide.

    See Also
    ACProfileFromCodeACProfileListItemCode

    AC_RenderIntent

    AcroColorExpT.h:673

    Constants that specify a standard ICC rendering intent for a device color profile. The rendering intent specifies the color translation method for colors that are outside the gamut of the color profile.

    Values
    AC_Perceptual
    —

    Tries to preserve the visual relationship between colors in a way that is perceived as natural to the human eye, although the color values themselves may change. This is the same as the Image intent in Adobe PageMaker and Illustrator. This option is suitable for photographic, continuous tone images.

    AC_RelColorimetric
    —

    The same as absolute colorimetric, except that it compares the white point of the source color space to that of the destination color space and shifts all other colors accordingly, rather than comparing individual colors.

    AC_Saturation
    —

    Tries to create vivid color at the expense of accurate color. It scales the source gamut to the destination gamut, but preserves relative saturation instead of hue, so that when scaling to a smaller gamut, hues may shift. This is the same as the Graphics intent in Adobe PageMaker and Illustrator. This option is suitable for business graphics and charts, where the exact relationship between colors is not as important as having bright saturated colors.

    AC_AbsColorimetric
    —

    Tries to maintain color accuracy at the expense of preserving relationships between colors. It leaves colors that fall inside the destination gamut unchanged. When translating to a smaller gamut, two colors that are distinct in the source space may be mapped to the same color in the destination space. This type of rendering can be more accurate than AC_RelColorimetric if the color profile of the image contains correct white point (extreme highlight) information.

    AC_UseProfileIntent
    —

    Use the source profile's rendering intent.

    AC_UseGStateIntent
    —

    This intent can be used ONLY in PDPageDrawContentsToMemoryWithParams. When it is used, the destination intent will be set to the same as the source intent

    AC_RenderIntentSize
    —
    See Also
    ACMakeCalGrayACMakeCalLabACMakeCalRGB

    AC_SelectorCode

    AcroColorExpT.h:200

    Constants that specify the types of device profiles to include in a profile list.

    Values
    AC_Selector_RGB_Standard
    —

    Standard (recommended) RGB profiles. These profiles are always bidirectional.

    AC_Selector_RGB_OtherInputCapable
    —

    RGB profiles that can be used as a source. These profiles may or may not be usable as a destination. This constant does not include profiles selected by AC_Selector_RGB_Standard.

    AC_Selector_RGB_OtherOutputCapable
    —

    RGB profiles that can be used as a destination. These profiles are also usable as a source. This constant does not include profiles selected by AC_Selector_RGB_Standard.

    AC_Selector_CMYK_StandardInput
    —

    Standard (recommended) CMYK profiles that can be used as a source. These profiles may or may not be usable as a destination.

    AC_Selector_CMYK_StandardOutput
    —

    Standard (recommended) CMYK profiles that can be used as a destination. These profiles are also usable as a source.

    AC_Selector_CMYK_OtherInputCapable
    —

    CMYK profiles that can be used as a source. These profiles may or may not be usable as a destination. This constant does not include profiles selected by AC_Selector_CMYK_StandardInput or AC_Selector_CMYK_StandardOutput.

    AC_Selector_CMYK_OtherOutputCapable
    —

    CMYK profiles that can be used as a destination. These profiles are also usable as a source. This constant does not include profiles selected by AC_Selector_CMYK_StandardOutput.

    AC_Selector_Gray_Standard
    —

    Standard (recommended) grayscale profiles. These profiles are always bidirectional.

    AC_Selector_Gray_OtherInputCapable
    —

    Grayscale profiles that can be used as a source. These profiles may or may not be usable as a destination. This constant does not include profiles selected by AC_Selector_Gray_Standard.

    AC_Selector_Gray_OtherOutputCapable
    —

    Grayscale profiles that can be used as a destination. These profiles are also usable as a source. This constant does not include profiles selected by AC_Selector_Gray_Standard.

    AC_Selector_DotGain_Standard
    —

    Standard dot gain profiles. This constant is used by Photoshop to represent a single ink's dot gain curve, and is stored as an ICC gray output profile.

    AC_Selector_DotGain_Other
    —

    Other grayscale printer profiles. This constant does not include profiles selected by AC_Selector_DotGain_Standard, and does not include grayscale display profiles.

    AC_Selector_PhotoYCC_InputCapable
    —

    PhotoYCC profiles that can be used as a source.

    AC_Selector_MaxEnum
    —

    This constant forces the enum to be 32 bits wide.

    See Also
    ACMakeProfileList

    AC_SettingsKey

    AcroColorExpT.h:1014

    Constant key values for anobject.

    Values
    AC_Key_Name
    —

    Settings file name string (if different than the file name).

    AC_Key_Description
    —

    Settings file description string.

    AC_Key_WriterName
    —

    Name of application to write this settings file.

    AC_Key_WorkingRGB
    —

    Working RGB profile.

    AC_Key_WorkingCMYK
    —

    Working CMYK profile.

    AC_Key_WorkingGray
    —

    Working gray profile.

    AC_Key_WorkingSpot
    —

    Working spot profile.

    AC_Key_PolicyRGB
    —

    RGB color management policy (AC_Policy).

    AC_Key_PolicyCMYK
    —

    CMYK color management policy (AC_Policy).

    AC_Key_PolicyGray
    —

    Gray color management policy (AC_Policy).

    AC_Key_MismatchAskOpening
    —

    Ask about profile mismatches when opening (= no,= yes).

    AC_Key_MismatchAskPasting
    —

    Ask about profile mismatches when pasting (= no,= yes).

    AC_Key_MissingAskOpening
    —

    Ask about missing profile when opening (= no,= yes).

    AC_Key_EngineCMS
    —

    Conversion engine CMS code (4-char code, stored as).

    AC_Key_EngineCMM
    —

    Conversion engine CMM code (4-char code, stored as).

    AC_Key_Intent
    —

    Conversion intent (standard ICC integer encoding).

    AC_Key_KPC
    —

    Conversion black point compensation (= no,= yes).

    AC_Key_Dither
    —

    Dither conversions between 8-bit color spaces (= no,= yes).

    AC_Key_CompressionEnabled
    —

    Enable or disable monitor compression (= off,= on).

    AC_Key_CompressionPercent
    —

    Monitor compression percent (in percent).

    AC_Key_BlendGammaEnabled
    —

    Enable or disable RGB blending gamma (= off,= on).

    AC_Key_BlendGammaValue
    —

    RGB blending gamma value (= gamma 1.00).

    AC_Key_ProofType
    —

    Proof type (AC_ProofType).

    AC_Key_ProofProfile
    —

    Proof profile.

    AC_Key_Simulate
    —

    Display simulation (AC_Simulate).

    AC_Key_MaxEnum
    —

    This constant forces theto be 32 bits wide.

    See Also
    ACGetSettingsProfileACGetSettingsStringACGetSettingsUnsigned32

    AC_SettingsType

    AcroColorExpT.h:1100

    Constant values that determine the type of an AC_Settings object.

    Values
    AC_SettingsType_Color
    —

    Used to hold global color settings, such as working spaces.

    AC_SettingsType_Proof
    —

    Used to specify the parameters for proofing a document. The Proof Setup Files generally control a per-window setting.

    AC_SettingsType_MaxEnum
    —

    This constant forces theto be 32 bits wide.

    See Also
    ACMakePresetListACMakeSettings

    PDColorConvertActionType

    AcroColorExpT.h:1363

    Action types: these specify what to do when an object is matched.

    Values
    kColorConvPreserve
    —

    Do nothing but handle ink aliases.

    kColorConvConvert
    —

    Convert to target space.

    kColorConvDecalibrate
    —

    Convert calibrated space to device space.

    kColorConvDownConvert
    —

    Convert NChannel space to DeviceN space.

    kColorConvToAltSpace
    —

    Convert spot to Alternate Space

    kColorConvMaxEnum
    —

    Maximum enum value.

    PDColorConvertObjectAttributeFlags

    AcroColorExpT.h:1262

    Object attributes: these are arranged as a bitmap.

    Values
    kColorConvObj_Image
    —

    Object is an image.

    kColorConvObj_JPEG
    —

    Object is a JPEG image.

    kColorConvObj_JPEG2000
    —

    Object is a JPEG2000 image.

    kColorConvObj_Lossy
    —

    Image is in a lossy space.

    kColorConvObj_Lossless
    —

    Image is in a non-lossy space.

    kColorConvObj_Text
    —

    Object is text.

    kColorConvObj_LineArt
    —

    Object is line-art (fill, stroke).

    kColorConvObj_Shade
    —

    Object is a smooth shade.

    kColorConvObj_Transparent
    —

    Object is not opaque.

    kColorConvObj_Overprinting
    —

    Object overprints.

    kColorConvObj_OverprintMode
    —

    Overprint mode (OPM) is set to.

    kColorConvObj_AnyObject
    —

    Any object.

    kColorConvObj_MaxEnum
    —

    Maximum enum value.

    PDColorConvertSpaceTypeFlags

    AcroColorExpT.h:1309

    Color Space attributes: these are arranged as a bitmap.

    Values
    kColorConvDeviceSpace
    —

    Device color space.

    kColorConvCalibratedSpace
    —

    Calibrated color space.

    kColorConvAlternateSpace
    —

    Alternate color space.

    kColorConvBaseSpace
    —

    Base of an indexed space.

    kColorConvIndexedSpace
    —

    Indexed color space.

    kColorConvSeparationSpace
    —

    Separation color space.

    kColorConvDeviceNSpace
    —

    DeviceN color space.

    kColorConvNChannelSpace
    —

    NChannel color space.

    kColorConvRGBSpace
    —

    RGB color space. This should only be set if either Device space (unless Lab) or Calibrated space is set.

    kColorConvCMYKSpace
    —

    CMYK color space. This should only be set if either Device space (unless Lab) or Calibrated space is set.

    kColorConvGraySpace
    —

    Gray color space. This should only be set if either Device space (unless Lab) or Calibrated space is set.

    kColorConvLabSpace
    —

    Lab color space.

    kColorConvertMatchProfile
    —

    Match Specified Profile. This action should only be take if it is a decalibration, and the specified profile matches the color profile of the current color

    kColorConvAnySpace
    —

    Any color space.

    kColorConvSpace_MaxEnum
    —

    Maximum enum value.

    PDCompletionCode

    AcroColorExpT.h:1611

    Callback completion code.

    Values
    PDCompletionSuccess
    —

    Success.

    PDCompletionContinue
    —

    Continue.

    PDCompletionAbort
    —

    Abort.

    PDReasonCode

    AcroColorExpT.h:1623

    Callback reason code.

    Values
    PDReasonNone
    —

    None.

    PDReasonNotImplemented
    —

    None implemented.

    Definitions(6)

    _FLG

    AcroColorExpT.h:1259
    Value:(1 << n)