Acro Color Layer

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

See Also

Parameters

count: ASUns32 *

(Filled by the method) A pointer to the count value.

Returns

See Also

Parameters

index: ASUns32

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

name: AC_String *

(Filled by the method) Optional. If it is not NULL , 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

See Also

Parameters

bpc: ASUns32 *

It will receive the flag value, flag value equal to 1 implies black-point compensation is on , value 0 otherwise.

Returns

See Also

Parameters

settings: AC_Settings

The settings object 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

See Also

Parameters

settings: AC_Settings

The settings object 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

See Also

Parameters

settings: AC_Settings

The settings object 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

See Also

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

See Also

Parameters

settings: AC_Settings

(Filled by the method) The settings object.

file: AC_FileSpec *

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

Returns

See Also

Parameters

settings: AC_Settings

file: AC_String

Returns

See Also

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

See Also

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- NULL , it must contain ASCII data, and may contain Unicode data also. If NULL , a hard-coded default description is used.

Returns

See Also

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- NULL , it must contain ASCII data, and may contain Unicode data also. If it is NULL , a hard-coded default description is used.

Returns

See Also

Parameters

profile: AC_Profile *

spec: ACCalRGB *

intent: AC_RenderIntent

description: AC_String

Returns

See Also

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

See Also

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

See Also

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

See Also

Parameters

settings: AC_Settings *

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

type: AC_SettingsType

The settings type (AC_SettingsType_Color or AC_SettingsType_Proof).

Returns

See Also

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 NULL .

Returns

See Also

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 NULL -terminated ASCII string containing the monitor's device name (for example, "Display" )

Returns

See Also

Parameters

profile: AC_Profile *

monitorID: void *

Returns

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

See Also

Parameters

list: AC_PresetList

The preset list object.

count: ASUns32 *

(Filled by the method) A pointer to the number of settings in the list.

Returns

See Also

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

See Also

Parameters

list: AC_PresetList

index: ASUns32

file: AC_String *

name: AC_String *

Returns

Parameters

profile: AC_Profile

The device color profile.

space: AC_ColorSpace *

(Filled by the method) A pointer to the color space.

Returns

See Also

Parameters

profile: AC_Profile

The device color profile.

data: void *

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

Returns

See Also

Parameters

profile: AC_Profile

The device color profile.

description: AC_String *

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

Returns

See Also

Parameters

profile: AC_Profile *

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

code: AC_ProfileCode

The profile type code.

Returns

See Also

Parameters

profile: AC_Profile *

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

description: AC_String

The description string.

Returns

See Also

Parameters

list: AC_ProfileList

The profile list.

count: ASUns32 *

(Filled by the method) A pointer to the number of profiles in the list.

Returns

See Also

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

See Also

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

See Also

Parameters

profile: AC_Profile

The device color profile object.

size: ASUns32 *

(Filled by the method) A pointer to the profile data size.

Returns

See Also

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: true if the profiles match, false otherwise.

Returns

See Also

Parameters

bpc: ASUns32

1 to enable black-point compensation, 0 otherwise.

Returns

See Also

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

See Also

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 of buffer in bytes, including the trailing NULL character.

maxCount: ASUns32

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

Returns

See Also

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 buffer , including the trailing NULL character.

maxCount: ASUns32

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

Returns

See Also

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 of buffer in bytes, including the trailing NULL character.

maxCount: ASUns32

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

Returns

See Also

Parameters

bp: ACSwatchBook

Returns

Parameters

dbp: ACSwatchBookDB

A pointer to the swatchbook database object.

Returns

Parameters

dbp: ACSwatchBookDB

A pointer to the swatchbook database object to be destroyed.

Returns

Parameters

dbp: ACSwatchBookDB

A pointer to the swatchbook database object.

ix: ASUns32

The index of the swatchbook item. Its value is in the range [0, swatchBookCount-1] .

Returns

Parameters

bp: ACSwatchBook

Returns

Parameters

bp: ACSwatchBook

ix: ASUns32

The index of the swatch. Its value is in the range [0, swatchCount-1] .

Returns

Parameters

bp: ACSwatchBook

ix: ASUns32

The index of the swatch. Its value is in the range [0, swatchCount-1] .

values: float *

Values that are filled in by this call.

Returns

Parameters

bp: ACSwatchBook

Returns

Parameters

dbp: ACSwatchBookDB

The swatchbook database.

ix: ASUns32

Returns

Parameters

dbp: ACSwatchBookDB

The swatchbook database.

path: ASPathName

The path to the swatchbook file.

Returns

Parameters

bp: ACSwatchBook

Returns

Parameters

dbp: ACSwatchBookDB

A pointer to the swatchbook database object.

ix: ASUns32

The index of the swatchbook item. Its value is in the range [0, swatchBookCount-1] .

Returns

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

Parameters

list: AC_PresetList

The preset list object.

Returns

See Also

Parameters

profile: AC_Profile

The profile object.

Returns

See Also

Parameters

list: AC_ProfileList

The profile list object.

Returns

See Also

Parameters

settings: AC_Settings

The settings object.

Returns

See Also

Parameters

string: AC_String

The string object.

Returns

See Also

Parameters

transform: AC_Transform

The tranform object.

Returns

See Also

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 true , embed the color space and make the object calibrated. If it is false and 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

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

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

Parameters

doc: PDDoc

The document in which to embed the output intent.

OIProfile: AC_Profile

Returns

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

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 reportProc .

changed: ASBool *

Returns

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 reportProc .

changed: ASBool *

Returns

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

Values

kACWorkingGray

—

Grayscale profile.

kACWorkingRGB

—

RGB profile.

kACWorkingCMYK

—

CMYK profile.

kACWorkingSpaces

—

Working spaces.

See Also

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

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 false .

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 the enum to be 32 bits wide.

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.

R, G, B = 0 is black.

R, G, B = 255 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.

R, G, B = 0 is black.

R, G, B = 32768 is white.

Values greater than 32768 are invalid.

Data must be 64-bit aligned.

AC_Packing_CMYK8_Black0

—

8-bit CMYK.

C, M, Y, K = 0 is 100% ink.

C, M, Y, K = 255 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.

C, M, Y, K = 0 is 100% ink.

C, M, Y, K = 32768 is 0% ink.

Values greater than 32768 are invalid.

Data must be 64-bit aligned.

AC_Packing_pLab8

—

8-bit LAB, with a leading pad byte.

L = 0 means L* = 0.0

L = 255 means L* = 100.0

a, b = 0 means a*, b* = -128.0

a, b = 128 means a*, b* = 0.0

a, b = 255 means a*, b* = +127.0

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.

L = 0 means L* = 0.0

L = 32768 means L* = 100.0

a, b = 0 means a*, b* = -128.0

a, b = 16384 means a*, b* = 0.0

a, b = 32768 means a*, b* = +128.0

Values greater than 32768 are invalid.

Data must be 64-bit aligned.

AC_Packing_Gray8_Black0

—

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

G = 0 is 100% ink or black or fully out of gamut.

G = 255 is 0% ink or white or fully in gamut.

When used for gamut test results, any value greater than or equal to 128 should 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.

G = 0 is 100% ink or black or fully out of gamut.

G = 32768 is 0% ink or white or fully in gamut.

Values greater than 32768 are invalid.

Data must be 16-bit aligned.

AC_Packing_pXYZ16

—

16-bit XYZ, with a leading pad word.

X, Y, Z = 0 means X, Y, Z = 0.0

X, Y, Z = 32768 means X, Y, Z = 1.0

X, Y, Z = 65535 means X, Y, Z = 1.9999694824 .

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

—

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 the enum to be 32 bits wide.

Values

AC_Profile_Null

—

A NULL result, 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 ( X = Y = Z = 1.0 ). 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

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

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

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 enum ).

AC_Key_PolicyCMYK

—

CMYK color management policy (AC_Policy enum ).

AC_Key_PolicyGray

—

Gray color management policy (AC_Policy enum ).

AC_Key_MismatchAskOpening

—

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

AC_Key_MismatchAskPasting

—

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

AC_Key_MissingAskOpening

—

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

AC_Key_EngineCMS

—

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

AC_Key_EngineCMM

—

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

AC_Key_Intent

—

Conversion intent (standard ICC integer encoding).

AC_Key_KPC

—

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

AC_Key_Dither

—

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

AC_Key_CompressionEnabled

—

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

AC_Key_CompressionPercent

—

Monitor compression percent (in percent).

AC_Key_BlendGammaEnabled

—

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

AC_Key_BlendGammaValue

—

RGB blending gamma value ( 100 = gamma 1.00).

AC_Key_ProofType

—

Proof type (AC_ProofType enum ).

AC_Key_ProofProfile

—

Proof profile.

AC_Key_Simulate

—

Display simulation (AC_Simulate enum ).

AC_Key_MaxEnum

—

This constant forces the enum to be 32 bits wide.

See Also

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 the enum to be 32 bits wide.

See Also

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.

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 1 .

kColorConvObj_AnyObject

—

Any object.

kColorConvObj_MaxEnum

—

Maximum enum value.

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.

Values

PDCompletionSuccess

—

Success.

PDCompletionContinue

—

Continue.

PDCompletionAbort

—

Abort.

Values

PDReasonNone

—

None.

PDReasonNotImplemented

—

None implemented.