ColorSetting

Color management settings.

Objects:

Boolean, ColorSettingsPolicy, File, Object, RenderingIntent, String

Property Listing

Property

Type

Access

Description

cmsSettings

String

read/write

The current color management system settings configuration. Note: For information on possible values, see CMS settings list.

cmsSettingsList

Array of String

readonly

A list of valid color management system settings configurations.

cmsSettingsPath

File

read/write

The file path of the CSF file to use.

cmykPolicy

ColorSettingsPolicy

ColorSettingsPolicy.COLOR_POLICY_OFF

ColorSettingsPolicy.CONVERT_TO_WORKING_SPACE

ColorSettingsPolicy.PRESERVE_EMBEDDED_PROFILES

read/write

The policy for handling colors in a CMYK color model, including reading and embedding color profiles, resolving mismatches between embedded color profiles and the working space, and moving colors between documents.

enableColorManagement

Boolean

read/write

If true, enables color management.

engine

String

read/write

The color management module (CMM) for mapping color space gamuts between documents.

engineList

Array of String

readonly

The available color engines.

intent

RenderingIntent

RenderingIntent.ABSOLUTE_COLORIMETRIC

RenderingIntent.PERCEPTUAL

RenderingIntent.RELATIVE_COLORIMETRIC

RenderingIntent.SATURATION

RenderingIntent.USE_COLOR_SETTINGS

read/write

The rendering intent. Note: Valid only when use color management is true.

mismatchAskWhenOpening

Boolean

read/write

If true, displays a prompt when opening a file whose embedded color profile does not match the current working space. The prompt provides the option to override the default mismatch behavior.

mismatchAskWhenPasting

Boolean

read/write

If true, displays a prompt when importing an object (via pasting, drag-and-drop, or other similar methods) whose colors do not match the current working space. The prompt provides the option to override the default mismatch behavior.

missingAskWhenOpening

Boolean

read/write

If true, displays a prompt when opening a file that does not have an embedded color profile. The prompt provides the option to assign a color profile.

parent

Application

readonly

The parent of the ColorSetting (a Application).

properties

Object

read/write

A property that allows setting of several properties at the same time.

rgbPolicy

ColorSettingsPolicy

ColorSettingsPolicy.COLOR_POLICY_OFF

ColorSettingsPolicy.CONVERT_TO_WORKING_SPACE

ColorSettingsPolicy.PRESERVE_EMBEDDED_PROFILES

read/write

The policy for handling colors in an RGB color model, including reading and embedding color profiles, handling mismatches between embedded color profiles and the working space, and moving colors from one document to another.

useBPC

Boolean

read/write

If true, uses black point compensation to ensure that shadow detail is preserved by simulating the full dynamic range of the output device.

workingSpaceCMYK

String

read/write

The current CMYK profile.

workingSpaceCMYKList

Array of String

readonly

A list of valid CMYK color profiles.

workingSpaceRGB

String

read/write

The current RGB profile.

workingSpaceRGBList

Array of String

readonly

A list of valid RGB color profiles.

Object of

Application.colorSettings