Color

A color swatch.

Properties

Property Type Access Description
colorValue Array of number r/w The ink values that create the color, specified as a percentage for each ink. Note: The number of values required and the range depends on the color space. For RGB, specify three values, with each value in the range 0 to 255; for CMYK, specify four values representing C, M, Y, and K, with each value in the range 0 to 100; for LAB, specify three values representing L (Range: 0 to 100), A (Range: -128 to 127), and B (Range: -128 to 127); for mixed ink, specify values for each ink in the ink list, with each value in the range 0 to 100.
id number readonly The unique ID of the Color.
index number readonly The index of the Color within its containing object.
label string r/w A property that can be set to any string.
model ColorModel :
SPOT
PROCESS
REGISTRATION
MIXEDINKMODEL		 r/w The color model.
name string r/w The name of the Color.
parent any readonly The parent of the Color (a Application or Document).
properties Object r/w A property that allows setting of several properties at the same time.
space ColorSpace :
RGB
CMYK
LAB
MIXEDINK		 r/w The color space.

Methods

Color duplicate ()
Duplicates the Color.

string extractLabel (key: string)
Gets the label value associated with the specified key.

Parameter Type Description
key string The key.

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

void insertLabel (key: string, value: string)
Sets the label to the value associated with the specified key.

Parameter Type Description
key string The key.
value string The value.

Swatch merge (with: any)
Merges the specified swatches with the swatch.

Parameter Type Description
with Array of Swatches
Swatch
String		 The swatches to merge. Can accept: Array of Swatches, Swatch or String.

void remove ([replacingWith: Swatch])
Deletes the swatch.

Parameter Type Description
replacingWith Swatch The swatch to apply in place of the deleted swatch. (Optional)

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

string toSpecifier ()
Retrieves the object specifier.

Element of:

Tint.baseColor

Used in:

Colors.previousItem ( obj: Color)
Colors.nextItem ( obj: Color)
Tints.add ( [color: Color][, withProperties: Object])

Returned by:

Color Application.importAdobeSwatchbookProcessColor ( name: string )
Color Application.importAdobeSwatchbookSpotColor ( name: string )
Color Color.duplicate ( )
Array of Color Color.getElements ( )
Color Colors.add ( [withProperties: Object] )
Color Colors.anyItem ( )
Array of Color Colors.everyItem ( )
Color Colors.firstItem ( )
Color Colors.item ( index: any )
Color Colors.itemByID ( id: number )
Color Colors.itemByName ( name: string )
Array of Color Colors.itemByRange ( from: any, to: any )
Color Colors.lastItem ( )
Color Colors.middleItem ( )
Color Colors.nextItem ( obj: Color )
Color Colors.previousItem ( obj: Color )
Color Document.importAdobeSwatchbookProcessColor ( name: string )
Color Document.importAdobeSwatchbookSpotColor ( name: string )