Class
Color management settings. Base Class: Preference addEventListener, getElements, removeEventListener, toSource, toSpecifier
ColorSetting
QuickLinks
Hierarchy
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: ColorSettingsPolicy.COLOR_POLICY_OFF ColorSettingsPolicy.PRESERVE_EMBEDDED_PROFILES ColorSettingsPolicy.CONVERT_TO_WORKING_SPACE ColorSettingsPolicy.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. |
| eventListeners | EventListeners | readonly | A collection of event listeners. |
| events | Events | readonly | A collection of events. |
| 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: DefaultRenderingIntent.PERCEPTUAL DefaultRenderingIntent.SATURATION DefaultRenderingIntent.RELATIVE_COLORIMETRIC DefaultRenderingIntent.ABSOLUTE_COLORIMETRIC |
r/w | The default rendering intent. |
| isValid | bool | readonly | Returns true if the object specifier resolves to valid objects. |
| 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: ColorSettingsPolicy.COLOR_POLICY_OFF ColorSettingsPolicy.PRESERVE_EMBEDDED_PROFILES ColorSettingsPolicy.CONVERT_TO_WORKING_SPACE ColorSettingsPolicy.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
Instances
EventListener addEventListener (eventType:
string, handler:
varies[, captures:
bool=false])
Adds an event listener.
| Parameter | Type | Description |
|---|---|---|
| eventType | string | The event type. |
| handler | File JavaScript Function | The event handler. Can accept: File or JavaScript Function. |
| captures | bool | This parameter is obsolete. (Optional) (default: false) |
Array
of ColorSetting getElements ()
Resolves the object specifier, creating an array of object references.
bool removeEventListener (eventType:
string, handler:
varies[, captures:
bool=false])
Removes the event listener.
| Parameter | Type | Description |
|---|---|---|
| eventType | string | The registered event type. |
| handler | File JavaScript Function | The registered event handler. Can accept: File or JavaScript Function. |
| captures | bool | This parameter is obsolete. (Optional) (default: false) |
string toSource ()
Generates a string which, if executed, will return the ColorSetting.
Element of
Application.colorSettings
Return
Array of ColorSetting ColorSetting.getElements ()
| Jongware, 23-Mar-2011 v3.0.3d | Contents :: Index |