Spots¶

app.activeDocument.spots

Description¶

A collection of SpotColor objects in a document.

Properties¶

Spots.length¶

app.activeDocument.spots.length

Description¶

Number of elements in the collection.

Type¶

Number; read-only.

Spots.parent¶

app.activeDocument.spots.parent

Description¶

The object's container.

Type¶

Object; read-only.

Spots.typename¶

app.activeDocument.spots.typename

Description¶

The class name of the object.

Type¶

String; read-only.

Methods¶

Spots.add()¶

app.activeDocument.spots.add()

Description¶

Creates a new object.

Returns¶

Spot

Spots.getByName()¶

app.activeDocument.spots.getByName(name)

Description¶

Get the first element in the collection with the provided name.

Parameters¶

Parameter	Type	Description
`name`	String	Name of element to get

Returns¶

Spot

Spots.index()¶

app.activeDocument.spots.index(itemKey)

Description¶

Gets an element from the collection.

Parameters¶

Parameter	Type	Description
`itemKey`	String, Number	Key of element to get

Returns¶

Spot

Spots.removeAll()¶

app.activeDocument.spots.removeAll()

Description¶

Deletes all elements in the collection.

Returns¶

Nothing.

Example¶

Removing spot colors¶

// Deletes all spots colors from the current document
if ( app.documents.length > 0 ) {
    var spotCount = app.activeDocument.spots.length;

    if (spotCount > 0) {
        app.activeDocument.spots.removeAll();
    }
}

Creating and applying spot colors¶

// Defines and applies a new spot color in the current document,
// then applies the color to the first path item
if (app.documents.length > 0 && app.activeDocument.pathItems.length > 0) {
    // Define the new color value
    var newRGBColor = new RGBColor();
    newRGBColor.red = 255;
    newRGBColor.green = 0;
    newRGBColor.blue = 0;

    // Create the new spot
    var newSpot = app.activeDocument.spots.add();

    // Define the new SpotColor as 80% of the RGB color
    newSpot.name = "Scripted Red spot";
    newSpot.tint = 80;
    newSpot.color = newRGBColor;

    // Apply a 50% tint of the new spot color to the frontmost path item.
    // Create a spotcolor object, set the tint value,
    var newSpotColor = new SpotColor();
    newSpotColor.spot = newSpot;
    newSpotColor.tint = 50;

    // Use the spot color to set the fill color
    var frontPath = app.activeDocument.pathItems[0];
    frontPath.filled = true;
    frontPath.fillColor = newSpotColor;
}