User manual ADOBE COURSEBUILDER

[. . . ] The software described in this document is furnished under license and may only be used or copied in accordance with the terms of such license. This publication and the information herein is furnished AS IS, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies, makes no warranty of any kind (express, implied, or statutory) with respect to this publication, and expressly disclaims any and all warranties of merchantability, fitness for particular purposes, and noninfringement of third party rights. Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization. [. . . ] They allow you to re-use parts of scripts. If you find yourself typing or pasting the same lines of code into several different places in a script, you've identified a good candidate for a subroutine. Note: Subroutines can also be called handlers, functions, or routines; these terms can have slight differences in different scripting languages. In VBScript, a function is a subroutine that returns a value. JavaScript generally uses the term function; AppleScript generally uses the term handler. You can pass one or more values to a subroutine or function; you can receive one or more values in return. For example, you could pass a single measurement value (such as inches) to a function and ask the function to return the equivalent value in a different measurement system (such as centimeters). Or you could ask a function to return the geometric center point of an object from its geometric bounds. The following samples demonstrate simple subroutine syntax, followed by a more complex subroutine example. AS You enclose a handler in the words on and end. Simple Handler This sample defines a handler named helloWorld() that, when called from a script, displays a dialog with the message Hello World. on helloWorld() display dialog "Hello World" end To call the handler, you simply include it in your script. tell Application "Photoshop CS2" helloWorld() end tell When the script runs, the handler enacts the statements in the handler definition. Complex Handler The following script displays a dialog with the message Are you sure?and two buttons: Yes and No. set flag to DoConfirm ("Are you sure?") display dialog flag as string 'create a handler named DoConfirm Photoshop CS2 Adobe Photoshop CS2 Scripting Guide Scripting basics 30 on DoConfirm(prompt) set button to button returned of (display dialog prompt ¬ buttons {"Yes", "No"} default button 1) return button = "Yes" end DoConfirm VBS In VBScript, subroutines begin with the keyword Sub and do not return a value. If you would like your subroutine to return a value, you must make it a function. Functions begin with the keyword Function. Subroutine The following subroutine, which is named HelloWorld(), simply displays a message box with the message Hello World. Sub HelloWorld() Alert "Hello World" End Sub To call the subroutine, you include it in a script. 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. You can use this information as a guideline. 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. [. . . ] Columns are arranged horizontally. 0 indicates the top row in the document. Lower right corner: theDocWidthInPixels / 2, theDocHeightInPixels theDocWidthInPixels / 2 indicates the middle of the document. theDocHeightInPixels indicates the bottom row in the document; that is row whose coordinate is the total number of rows in the document. Note: The value of theDocHeightInPixels is the total number of pixels that determine the vertical dimension of the document. 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. [. . . ]