ColorSetting

Color management settings.

Properties

Property Type Access Description
accurateLABSpots bool r/w If true, uses LAB alternates for spot colors when available.
cmsSettings string r/w 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 r/w The file path of the CSF file to use.
cmykPolicy ColorSettingsPolicy :
COLOR_POLICY_OFF
PRESERVE_EMBEDDED_PROFILES
CONVERT_TO_WORKING_SPACE
COMBINATION_OF_PRESERVE_AND_SAFE_CMYK		 r/w 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 bool r/w If true, enables color management.
engine string r/w The color management module (CMM) for mapping color space gamuts between documents.
engineList Array of string readonly The available color engines.
idealizedBlackToExport bool r/w If true, uses idealized black for CMYK-to-RGB or CMYK-to-Gray conversions to print or export.
idealizedBlackToScreen bool r/w If true, uses idealized black for CMYK-to-RGB or CMYK-to-Gray conversions to the screen.
intent DefaultRenderingIntent :
PERCEPTUAL
SATURATION
RELATIVE_COLORIMETRIC
ABSOLUTE_COLORIMETRIC		 r/w The default rendering intent.
mismatchAskWhenOpening bool r/w 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 bool r/w 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 bool r/w 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 r/w A property that allows setting of several properties at the same time.
rgbPolicy ColorSettingsPolicy :
COLOR_POLICY_OFF
PRESERVE_EMBEDDED_PROFILES
CONVERT_TO_WORKING_SPACE
COMBINATION_OF_PRESERVE_AND_SAFE_CMYK		 r/w 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 bool r/w 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 r/w The current CMYK profile.
workingSpaceCMYKList Array of string readonly A list of valid CMYK color profiles.
workingSpaceRGB string r/w The current RGB profile.
workingSpaceRGBList Array of string readonly A list of valid RGB color profiles.

Methods

Array of ColorSetting getElements ()
Resolves the object specifier, creating an array of object references.

string toSource ()
Generates a string which, if executed, will return the ColorSetting.

string toSpecifier ()
Retrieves the object specifier.

Element of:

Application.colorSettings

Returned by:

Array of ColorSetting ColorSetting.getElements ( )