photoshop-dom-event

Node.js module for listening to Adobe Photoshop DOM events from a CEP HTML/JavaScript Extension (Custom Panel)

Usage no npm install needed!

<script type="module">
  import photoshopDomEvent from 'https://cdn.skypack.dev/photoshop-dom-event';
</script>

README

Photoshop-DOM-Event

npm-image version-image

Install


npm install photoshop-dom-event --save

Requirements


CSInterface v5.x or higher

Description


Node.js module for listening to Adobe Photoshop DOM events from a CEP HTML/JavaScript Extension (Custom Panel).

For registering a Photoshop event callback is necessary to specify the charID or stringID that is expected to listen.

Various charIDs that can be used are documented in Photoshop Javascript reference, Appendix A: Event ID Codes or by usign Adobe Photoshop Scripting Listener Plug-in to identify the corresponding eventID.

To mantain Photoshop stability, event listeners can be started or stopped during extension execusion by using the corresponding methods described below.

Usage


var csInterface  = new CSInterface();
var photoshopDOM = require('photoshop-dom-event');

// Start listening for an event passing the corresponding charID or stringID
photoshopDOM.onEvent('placedLayerEditContents', function(eventData) {
  console.log('Editing Photoshop Smart Layer', eventData);
});

// Later in your code
photoshopDOM.stopListeningEvent('placedLayerEditContents');

Example


Example Photoshop extension demostrating module basic functionality.

The extension listens for the Layer Selection (slct) eventID and logs the eventData retrived to the console, the 'Remove Listener' button fires the method that unregisters the 'slct' event from the extension.

Scope


Tested in Adobe Photoshop CC2014 (v15.x), Adobe Photoshop CC2015 (v16.x) and Adobe Photoshop CC2015.5 (v17.x)

Changelog


v1.1.1 (Jul 24 2016)

  • Minor fixes for CC2015.5 compatibility.

v1.1.0 (Jul 24 2016)

  • Including extension example demostrating module basic functionality for registering and unregistering event listeners.

v1.0.0 (Jul 24 2016)

  • Listening to Photoshop DOM events by passsing the corresponding charID or stringID of the event to register.
  • Stop listening to events based on the provided charID or stringID.
  • Handling unique event callbacks for Adobe Photoshop CC2014.

v0.0.0 (Jul 23 2016)

  • Initial development.

License

MIT © Antonio Gomez