ColorSetting

Color management settings.

Methods:

addEventListener, getElements, removeEventListener, toSource, toSpecifier

Objects:

Boolean, ColorSettingsPolicy, DefaultRenderingIntent, EventListeners, Events, File, Object, String

Hierarchy:

Superclass: Preference

Class: ColorSetting

Property Listing

Property

Type

Access

Description

accurateLABSpots

Boolean

read/write

If true, uses LAB alternates for spot colors when available.

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

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.

eventListeners

EventListeners EventListener

readonly

A collection of event listeners.

events

Events Event

readonly

A collection of events.

idealizedBlackToExport

Boolean

read/write

If true, uses idealized black for CMYK-to-RGB or CMYK-to-Gray conversions to print or export.

idealizedBlackToScreen

Boolean

read/write

If true, uses idealized black for CMYK-to-RGB or CMYK-to-Gray conversions to the screen.

intent

DefaultRenderingIntent

DefaultRenderingIntent.ABSOLUTE_COLORIMETRIC

DefaultRenderingIntent.PERCEPTUAL

DefaultRenderingIntent.RELATIVE_COLORIMETRIC

DefaultRenderingIntent.SATURATION

read/write

The default rendering intent.

isValid

Boolean

readonly

Returns true if the object specifier resolves to valid objects.

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

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.

Method Listing

EventListener addEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Adds an event listener.

Parameter

Type

Description

eventType

String

The event type.

handler

File

JavaScriptFunction

The event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

ColorSetting getElements ()

Resolves the object specifier, creating an array of object references.

Boolean removeEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Removes the event listener.

Parameter

Type

Description

eventType

String

The registered event type.

handler

File

JavaScriptFunction

The registered event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

String toSource ()

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

String toSpecifier ()

Retrieves the object specifier.

Object of

Application.colorSettings

Event.parent

EventListener.parent

MutationEvent.parent

Return

ColorSetting.getElements()