Skip to content

Latest commit

 

History

History
 
 

JSON-Action-Manager

README.md

JSON Action Manager

Description

“JSON Action Manager” is an open-source scripting library for Adobe Photoshop, written in JavaScript, and licensed under GPLv3. It allows developers to interact with the underlying Action Manager using a simpler JSON AM Data Format (please refer also to the JSON Project Introduction page to get more information).

What is called “JSON Action Manager” is basically a set of interrelated modules defining global variables acting as namespaces:

  • jamActions defines a set of functions related to decoding actions files into a format usable by scripts written with the scripting library engine.

  • jamBooks defines a set of color books-related functions for scripts written with the scripting library engine.

  • jamColors defines a set of color-related functions for scripts written with the scripting library engine.

  • jamEngine defines all the methods and properties of the scripting library engine.

  • jamHelpers defines a set of helper functions for scripts written with the scripting library engine.

  • jamJSON defines customized methods for translating a JavaScript data structure to and from a JSON text string; it can be used in scripts written with the scripting library engine, but also independently.

  • jamLayers defines a set of functions related to layers for scripts written with the scripting library engine.

  • jamShapes defines a set of functions related to decoding custom shapes files into a format usable by scripts written with the scripting library engine.

  • jamStyles defines a set of functions related to layer styles for scripts written with the scripting library engine.

  • jamText defines a set of functions related to layer text for scripts written with the scripting library engine.

  • jamUtils defines a set of utility functions for scripts written with the scripting library engine.

Note: the “Namespace” and “Syntax-highlighted file” HTML pages listed below are documentation files automatically generated from their respective source files, using a special comment syntax interpreted by jsdoc-toolkit.

Namespace Syntax-highlighted file Source file Minified source file
jamActions jamActions.jsxinc jamActions.jsxinc jamActions-min.jsxinc
jamBooks jamBooks.jsxinc jamBooks.jsxinc jamBooks-min.jsxinc
jamColors jamColors.jsxinc jamColors.jsxinc jamColors-min.jsxinc
jamEngine jamEngine.jsxinc jamEngine.jsxinc jamEngine-min.jsxinc
jamHelpers jamHelpers.jsxinc jamHelpers.jsxinc jamHelpers-min.jsxinc
jamJSON jamJSON.jsxinc jamJSON.jsxinc jamJSON-min.jsxinc
jamLayers jamLayers.jsxinc jamLayers.jsxinc jamLayers-min.jsxinc
jamShapes jamShapes.jsxinc jamShapes.jsxinc jamShapes-min.jsxinc
jamStyles jamStyles.jsxinc jamStyles.jsxinc jamStyles-min.jsxinc
jamText jamText.jsxinc jamText.jsxinc jamText-min.jsxinc
jamUtils jamUtils.jsxinc jamUtils.jsxinc jamUtils-min.jsxinc

Requirements

“JSON Action Manager” can be used from Adobe Photoshop CS or later. It has been successfully tested in CS and CS4 on Mac OS X, but should be platform agnostic.

Copyright

This Software is copyright © 2011-2016 by Michel MARIANI.

License

This Software is licensed under the GNU General Public License (GPL) v3.

Download

Download Zip File

Installation

Download the Zip file and unzip it.

Move the JSON Action Manager folder to your user’s Home directory.

Start using the various functions of the library in your own scripts by inserting the following lines at the beginning of each script:

//@includepath "~/JSON Action Manager/"
//@include "jamEngine.jsxinc"

Depending on your needs, you may also want to add some of the following include statements:

//@include "jamActions.jsxinc"
//@include "jamBooks.jsxinc"
//@include "jamColors.jsxinc"
//@include "jamHelpers.jsxinc"
//@include "jamJSON.jsxinc"
//@include "jamLayers.jsxinc"
//@include "jamShapes.jsxinc"
//@include "jamStyles.jsxinc"
//@include "jamText.jsxinc"
//@include "jamUtils.jsxinc"

Alternatively, you can directly embed the contents of the compact one-line versions of the include files located in the minified subfolder. This is the way to go if you intend to produce stand-alone scripts, like the Utility Scripts or the Creative Scripts.

Basic HTML documentation automatically generated from the source files is available in the jsDoc subfolder.