Skip to content

Latest commit

 

History

History
209 lines (129 loc) · 4.02 KB

File metadata and controls

209 lines (129 loc) · 4.02 KB

Spots

app.activeDocument.spots

Description

A collection of jsobjref/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

jsobjref/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

jsobjref/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

jsobjref/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;
}