User manual ADOBE PHOTOSHOP CS 2.0 SCRIPTING GUIDE

[. . . ] Scripting Guide ® ® bc Adobe Photoshop cs2 © Copyright 2005 Adobe Systems Incorporated. Adobe® Creative Suite 2 Photoshop® Scripting Guide for Windows® and Macintosh®. NOTICE: All information contained herein is the property of Adobe Systems Incorporated. No part of this publication (whether in hardcopy or electronic form) may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written consent of Adobe Systems Incorporated. [. . . ] The values for ExectionMode are: NeverShowDebugger Disables debugging from the JavaScript. Any error that occurs in the JavaScript results in a JavaScript exception being thrown. Note: Refer to a JavaScript language guide for information on how to handle JavaScript exceptions. See `Bibliography' on page 34 for a listing of language guides. DebuggerOnError Automatically stops the execution of your JavaScript when a runtime error occurs and shows the JavaScript debugger. BeforeRunning Shows the JavaScript debugger at the beginning of your JavaScript. See `Testing and Troubleshooting' on page 32 for more information about debugging. Testing and Troubleshooting The AppleScript and VBScript scripting environments provide tools for monitoring the progress of your script while it is running--which makes it easier for you to track down any problems your script might be encountering or causing. AppleScript Debugging Apple's Script Editor application provides a syntax checking tool that you can use before you run your script. Additionally, Script Editor calls out problems in the script when you run the script. To view more details of how your script runs, display the Event Log and Results windows. To have Script Editor check your syntax: 1. Note: It is possible to create and compile scripts in AppleScript that will not run properly. You can double-check your syntax by using the Event Log and when you run your script. To use the Event Log window when you run a script: 1. As the script executes, you'll see the commands sent to Photoshop CS2 and the responses. Note: You can display the contents of one or more variables in the log window by including the log command in your script. Specify the variables you want to display in brackets following the Photoshop CS2 Adobe Photoshop CS2 Scripting Guide Scripting basics 33 command. The following sample requests the display of the variables myVariable and otherVariable. log {myVariable, otherVariable} To view results in the Results window rather than the Event Log: 1. Note: Third-party editors offer additional debugging features. VBScript Debugging The Windows Script Host cancels your script and displays an error message when you try to run a VBScript that contains faulty syntax or other code errors. The error message names the script and indicates the line in and character position in which it believes the error is located, along with an error description. However, often, the syntax error is in the line preceding the error description in the message. You can trace the execution of your script elements when the script is running by adding MsgBox commands. A MsgBox command stops your script at point where the command has been inserted and displays a dialog with the message you included in the command. The syntax for a message box that displays the message My Message is: MsgBox ("My Message") Check your VBScript documentation for more information. Windows Scripting Host also provides debugging information. JavaScript Debugging JavaScript debugging is described in detail in the Adobe Photoshop CS2 JavaScript Scripting Reference on the Photoshop installation CD. Please refer to that document for further information. Error Handling Imagine that you've written a script that formats the current text selection. What should the script do if the current selection turns out not to be text at all, but a path item?You can add error handling code to your script to respond to conditions other than those you expect it to encounter. The following example shows how you can stop a script from executing when a specific file cannot be found. [. . . ] Rows are stacked vertically. Lower left corner: theDocWidthInPixels / 2, 0 theDocWidthInPixels / 2 0 Upper left corner of the selection: 0, 0 AS To select an area and apply a wave filter to it: 1. Type the following code into the script file HelloWorldDoc just above the commented statements that restore original preferences: --create new variables to contain the document object's width and height --determine width and height values by multiplying the --width and height in inches by the resolution --(which equals the number of pixels per inch) Photoshop CS2 Adobe Photoshop CS2 Scripting Guide Scripting Photoshop CS2 80 set theDocWidthInPixels to theDocWidthInInches *¬ theDocResolution set theDocHeightInPixels to theDocHeightInInches *¬ theDocResolution --use the rasterize command of the art layer object rasterize theTextLayer affecting text contents --create a variable named theSelRegion --assign an array of coordinates as its value set theSelRegion to {{0, 0}, ¬ {theDocWidthInPixels / 2, 0}, ¬ {theDocWidthInPixels / 2, theDocHeightInPixels}, ¬ {0, theDocHeightInPixels}, ¬ {0, 0}} --replace the document object with the selection object --so that the wave is applied only to the selected text select theDocRef region theSelRegion combination type replaced --apply the wave filter using the filter command of the --wave filter class (inherited from the filter options super class) filter current layer of theDocRef using wave filter ¬ with options {class:wave filter, number of generators:1 ¬ , minimum wavelength:1, maximum wavelength:100, ¬ minimum amplitude:5, maximum amplitude:10 ¬ , horizontal scale:100, vertical scale:100 ¬ , wave type:sine, undefined areas:repeat edge pixels, ¬ random seed:0} 2. After viewing the document in Photoshop CS2, close the document without saving it. Note: Look up the following classes in the Adobe AppleScript Scripting Reference to see if you understand how you used them in this script: wave filter class art layer class rasterize command filter command document class > select command, combination type parameter VBS To select an area and apply a wave filter to it: 1. [. . . ]