Scriptographer.org - News

Version 2.8.055 is Up

Tue, 20 Jul 2010 15:36:17 +0200

Version 2.8.055 of Scriptographer was just released, including one new feature and a row of bug fixes:

The very convenient pathItem.getIntersections(other) function was added, which returns all intersections between two path items as CurveLocation objects, whether they are open or closed, simple or compound paths. Behind the scenes, this function performs a simple form of bezier clipping. CurveLocation objects are now used in many other places as well. See the reference for further information, and bear with us while we prepare tutorials to explain their function better. This is functionality that the Pathfinder does not offer itself. In fact, none of the Adobe Illustrator tools offer this exact functionality, so we believe this should open doors to a nice new family of scripts.

The release also fixes these known isues:

Fix wrong active components in prompt dialogs.
Fix an issue where list components were not correctly initialised based on their initially set value.
Fix an issues with keyboard short-cuts: Bringing up the main palette window and the console should work now when documents are open.
Fix various issues with SpinEdits positions and enabled / disabled states.
Fix an issue where displaying prompt dialogs would mess up the undo history.

As always, happy coding, and do not hesitate to get in touch if things do not work as they should or are not clear.

Version 2.8.052

Tue, 08 Jun 2010 16:46:32 +0200

Here a short note to inform you that the new version 2.8.052 was just uploaded. The previously released 2.8.050 introduced a few regressions due to the many under the hood changes, which were quickly identified and fixed. There are not enough changes for a real change-log, but below a list of what was fixed.

If you encountered problems with the previous release, please test again with this one first before reporting.

Fixed a bug in document.getItems(attributes) that prevented attributes.type from being recognised correctly.
Fixed UI layout issues with older scripts that directly work with the ADM package, where certain items would appear to have their bounding rectangles set incorrectly.
Fixed an error in the undo history tracking code that prevented item deletion from being detected in some situations and therefore leading to item.isValid() falsely returning true for such items.
Got version for Mac CS to compile correctly again.
Fixed a row of issues in the code that generates the Reference templates and improved documentation for some of the new features.

2.8.050 Is Out, Welcome on Board, CS5!

Thu, 03 Jun 2010 22:05:55 +0200

It has been a busy couple of weeks here at the Scriptographer HQ, as we were adding new features and writing tutorials, squashing bugs, simplifying things further and also adding support for the new Illustrator CS5.

We are quite excited about the mixture of new things, simplifications and more stability that we added to this release and think it was well worth the wait.

Refer to the change-log for a more complete list of what is new, but here some of the highlights:

Script Repository Manager

We introduced a new way to organise your scripts that is far more flexible and also more secure, as it prevents you from accidentally overriding your own script files: The Scriptographer Repository Manager lets you define multiple script repositories that serve as root folders for your scripts. These root folders show up in the Scriptographer Main Palette as if they were all nested together in one parent folder, but in fact they can be located anywhere on your hard-drive, and really should be located outside of the Scriptographer folder. In the future this will allow far simpler updates of Scriptographer to new versions, without the risk of any changes to your scripts lost – that is as long as you do not store your changes inside the default Examples folder.

Here is how it looks like with my personal configuration of multiple projects done with Scriptographer, all located in different parts of my harddrive:

Palette Improvements

We also spent a lot of time thinking about how the already great new Palette class could be made even more useful, simple and flexible. And we believe we came up with some really great ideas that we are soon going to write more about in the tutorial about User Input and Feedback. We also changed many of the example scripts in the Tools folder to use this powerful new feature, so until the tutorials are done, the best way to see how to use it is to look at these scripts.

Components in palettes now support a couple of new values for component.type: 'font', 'color', 'ruler', 'menu-entry' and 'menu-separator'. But what's even better: If a script changes properties in the values object that is passed to palettes on creation, the palette gets updated automatically and efficiently. In the same way, the components object that is passed to the it now offers simpe access to the created Components, allowing the components to be disabled and enabled again, hidden and shown, list options can be changed, etc.

Please note:

From this release on, the classes previously available through the UI package are now deprecated. The reason for this is that the technology they are based on (ADM) will go away in CS6 when Illustrator will be ported to Cocoa.
In order to prepare for this transition early, and also to simplify the way people work with Scriptographer, we decided to come up with this new way of making UI in Illustrator that we believe is very powerful and incredibly easy. The only classes you need to know of are Palette, Component and Dialog.
Documentation for the previous UI package, now dubbed ADM, is still available at http://scriptographer.org/legacy/adm/.

Timers

Lastly we would like to highlight a feature that might produce a whole new category of scripts: In this release, timers finally became reliable, much faster and stable, allowing them to be used to write background scripts that can continuously change items in the document. This can for example be used for animations, or other playful things, such as the new Throw.js script in the Examples folder. Timers are currently not documented in the reference, but you can use them in the same way as you would in browsers: setInterval() / setTimeout() to set a periodic / one-shot timer, and clearTimeout() / clearTimeout() to abort them again.

This should give a good overview of what is new. We are aware that a lot of things still need better documentation and will now again focus on that part.

We hope you will have as much fun with this release as we had making it.

So that's about it for now from us, time to download and start writing your own scripts!

Version 2.7.044

Sat, 24 Apr 2010 01:39:03 +0200

We just released another maintenance release. This finally solves a row of issues with mysterious crashes that we encountered for quite a while, making this the most stable release ever.

We have given it quite a hard time in our tests and have yet to experience a single crash.

Refer to the change-log for a detailed list of improvements, and expect a bigger update with a row of nice new features soon!

Workshop «Outils Utiles» at ECAL

Mon, 22 Mar 2010 10:39:00 +0100

The 5th Scriptographer workshop was held by Jonathan Puckey and Jürg Lehni. from March 8 to 12 2010 at ECAL in Lausanne.

The students were asked to come up with ideas for useful tools in Illustrator, either for their own needs or for something they identify as generally missing in Illustrator's functionality. During one intense week of teaching a mixture of geometry, scripting and designing simple user interfaces and interactions, the students then worked on turning their ideas into functioning products.

With Time Bandit 0.1, the first result of this week just started to arrive on the Scriptographer.org website now, and a quite astonishing one too. Who would have thought that Illustrator would be useful as an animation tool?

Thanks again to all the students for their enthusiasm for the scripts. We hope your work will inspire you and others to take this way of working further, beyond the scope of these workshops.

Version 2.7.040 Released

Sat, 20 Mar 2010 02:07:29 +0100

Version 2.7.040 was just uploaded. This is a maintenance release that solves a row of issues in the previous release without adding any big features:

Improved undo history tracking and item validation, solving the "invalid item" exceptions that often occurred in connection with undoing.
Fixed issues with tablet data arrays, where setting one type of tablet data would erase all the others.
Display spin edit controls correctly on PC.
Improved working with layers, fixed layer.clone() and hierarchy traversal using layer.previousSibling / layer.nextSibling.
Palette windows now remember their last position.
Prompt and alert dialogs now appear centred on the screen.
Scriptographer window is displayed by default when first launched.
The Hide / Show Scriptographer menu entry is not confused anymore on the first launch.
Added item.index, returning the index within the parent's list of children.

Version 2.7.037 Is Here

Mon, 08 Mar 2010 00:00:26 +0100

Just in time for this week's workshop at ECAL, we released the latest version of Scriptographer. As always this includes a row of bug fixes, and this time also some quite substantial performance improvement in various fields.

But most of all, this includes new functions and classes for creating user interfaces and palettes in very easy ways, as described by the new User Input and Feedback tutorial. Speaking of tutorials, we also wrote quite a few new ones.

As this is the main new feature in this release we are not going to include a detailed change-log this time.

We believe that the new Dialog.prompt(title, items) and new Palette(title, items, values) functionality offers a really great way to make more interactive scripts and we cannot wait to see the outcomes.

This should basically eradicate the need to tinker with any of the complex types in the UI package, which is a good thing, as Adobe will likely move away from ADM in CS6 onwards due to the necessary switch to Cocoa on Mac in order to support 64 Bit. This will break all of Scriptographer's UI code and making it literally impossible to maintain backward compatibility for the UI package. Therefore the methods described in the User Input and Feedback tutorial will be the only ones guaranteed to work in the future in order to create user interfaces in Scriptographer.

As always, download and have fun!

ECAL Research Project and Workshops

Mon, 22 Feb 2010 23:19:52 +0100

We just posted the results of a Scriptographer workshop held at the ECAL in September / October 2009.

This is part of an ongoing effort at the ECAL to use Scriptographer for teaching programming to students of graphic design and interaction design in a way that allows them to use it as a integral part of their daily workflow, in areas where scripting makes sense.

These workshops are part of a research project conducted by Jonathan Puckey and Jürg Lehni and assisted by Florian Pittet. The project started a bit less than one year and will carry on for the whole of 2010.

Each semester there is one workshop in which new ideas for methods and approaches of teaching scripting are tested, and of which the outcome is fed back into the further work on both Scriptographer and the documentation and tutorials that we are currently preparing for it.

One of the early results is a modification of Rhino, the JavaScript engine inside Scriptographer. This modification allows vector algebra to be written in a far more intuitive way, facilitating its use as a base in a one week workshop where students have no pre-requirements in programming or vector geometry. Due to this feature, a complicated line like the following can be rewritten in far more readable way:

var middlePoint = event.lastPoint.add(event.point).divide(2);

becomes:

var middlePoint = (event.lastPoint + event.point) / 2;

Other changes that stem from this project are the recently introduced simplifications in the way the Scriptographer interface works, based on observations made in an early workshop.

We believe that by continuously testing our concepts and code with students, Scriptographer will benefit more and more, both in the API and in the way its interface works.

Big thanks to the ECAL for supporting our efforts and providing brilliant students as guinea pigs ;-)

Expect more materials from other workshops to be posted on this site soon.

Version 2.6.036 Is Out

Mon, 15 Feb 2010 21:22:39 +0100

After many weeks of work, version 2.6 of Scriptographer was finally released today. This is mainly a maintenance release with many changes that should increase stability and not affect existing scripts so much.

For a detailed list of changes, please refer to the changelog.

The most obvious change for users is probably the change of folder structure in the scripts folder. We decided to introduce two root folders, Examples and My Scripts, to encourage people to separate own scripts from predefined examples. In a future release there will be a third folder called Tutorials, which will server as a base for people to learn scripting in Scriptographer, and a simple way of adding other folders in different locations as code repositories or projects, to avoid the risk of overwriting existing self written scripts when updating Scriptographer.

Speaking of tutorials, we also spent a lot of work on improving the documentation and the tutorials and this site, of which you are now only seeing the beginning. In the coming weeks we will be more and more focusing on this effort in order to remove many of the initial hurdles when learning Scriptographer.

And finally I would like to point out the new path.smooth() function which comes in very handy when trying to put a smooth curve through a group of points.

I hope you all enjoy this release.

Scriptographer 2.5 for Illustrator CS4, CS3, CS2 and CS

Thu, 23 Jul 2009 23:15:56 +0200

It took far longer than anticipated and far too long for anyone who was waiting for it to be released, especially after after all the false predictions about possible release dates in the past months. But here it is finally, the all new version, with lots of bug fixes, many new features and improvements, and finally proper CS4 support.

Many of the changes are under the hood and not visible straight away, but the more you work (and hopefully write code) with this new version, the more you will notice these improvements on all levels: A better structured and simplified API, syntax simplifications and improvements through tweaks to the Scripting Engine, a series of coding conventions that we will start writing about in tutorials, better structured documentation, etc. With this release we are only lying the base for many more improvements to come, and the more of the hard work is done, the more this becomes the actual fun-part of the project: Designing the architecture itself, coming up with conventions about how to make and use things in easy ways and communicating these, etc.

Several parts of the API have changed, so please do not expect your scripts written for previous versions to just work without some tweaks. We believe that the changes were worth the risk of breaking existing scripts, and we are willing to help with porting to the new version. As a start, we ported most of the scripts that users have uploaded to this site. Each script page still contains the original file, marked with -previous in the name.

We have prepared an extensive changelog with explanations about the API changes and how to adapt and use these.

We believe that this version was well worth the wait. But from now on, we will go back to a scheme of releasing often and early, to keep users in the loop as much as possible.