ColorSampler

Represents a ColorSampler object in the Photoshop DOM.

ColorSamplers are created through the ColorSamplers collection via the ColorSamplers.add method:

const app = require("photoshop").app;
app.activeDocument.colorSamplers.add({x: 100, y: 100});
CopyCopied to your clipboard
1const app = require("photoshop").app;
2app.activeDocument.colorSamplers.add({x: 100, y: 100});

Properties such as color, position and parent document can be then accessed on the ColorSampler instance:

let cs = app.activeDocument.colorSamplers[0];
console.log(cs.position);  // {x: 100, y: 100}
console.log(cs.color.rgb); // SolidColor {red: 0, green: 255, blue: 0}
console.log(cs.parent);    // Document
CopyCopied to your clipboard
1let cs = app.activeDocument.colorSamplers[0];
2console.log(cs.position);  // {x: 100, y: 100}
3console.log(cs.color.rgb); // SolidColor {red: 0, green: 255, blue: 0}
4console.log(cs.parent);    // Document

An existing ColorSampler instance can be moved to a different position:

cs.move({x: 200, y: 200});
console.log(cs.position);  // {x: 200, y: 200}
CopyCopied to your clipboard
1cs.move({x: 200, y: 200});
2console.log(cs.position);  // {x: 200, y: 200}

Or removed altogether from the document:

cs.remove();
console.log(app.activeDocument.colorSamplers.length); // 0
CopyCopied to your clipboard
1cs.remove();
2console.log(app.activeDocument.colorSamplers.length); // 0

Properties

Methods

move

void

Moves the ColorSampler object to the given position

Parameters

remove

void

Deletes the given ColorSampler object.