simple programming interfaces documentation

Background: Was helping my brother-in-law with some adobe illustrator scripting yesterday and we happily discovered Javascript scripting in AI. In the comments of this post, gdav provided some links to AI documentation (thanks gdav). The links are reproduced below mostly for my own reference.

1. Scripting Guide:
http://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/pdf/illustrator/scripting/cs6/Illustrator-Scripting-Guide.pdf

2. The JavaScript Reference:
http://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/pdf/illustrator/scripting/cs6/Illustrator-Scripting-Reference-JavaScript.pdf

The JavaScript Reference is of particular interest. It has a nice clean format to it which I find very suitable for JSON API documentation (something i’ve been meaning to get to for some services I’ve written). Below is a screenshot from the document:

ai-js-ref

First, the header specifies the object : Artboards – with a short description of what it is. Followed by the properties of the object: Artboards properties; which is documented in a table listing the properties, value type and a short description of the properties. Then the section on methods follow with an equally relevant set of documentation – method signature, parameter type, type of return object and a short description of what the method does.

Nice and neat.

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s