Adobe Smoke Alarm CS3 用户手册

 Scripting Photoshop CS3     56

●

A type ruler, which is active when using the type tool.

You set measurement unit types for the type ruler using the 

type units (TypeUnits/typeUnits)

 

property. 

These settings correspond to those found in the Photoshop CS3 preference dialog under 
Photoshop > Preferences > Units & Rulers on Mac OS or Edit > Preferences > Units & Rulers in 
Windows.

All languages support plain numbers for unit values. These values are treated as being of the type 
currently specified for the appropriate ruler.

For example, if the ruler units are currently set to inches and the following VBScript statement sets a 
document’s size to 3 inches by 3 inches:

docRef.ResizeImage 3,3

If the ruler units had been set to pixels, the document would be 3 pixels by 3 pixels. To ensure that your 
scripts produce the expected results you should check and set the ruler units to the type appropriate for 
your script. After executing a script the original values of the ruler settings should be restored if changed in 
the script. See 

 for directions on setting unit values.

Please refer to Photoshop CS3 Help for information about available unit value types. 

The unit values used by Photoshop CS3 are length units, representing values of linear measurement. 
Support is also included for pixel and percent unit values. These two unit value types are not, strictly 
speaking, length values but are included because they are used extensively by Photoshop CS3 for many 
operations and values.

AppleScript provides an additional way of working with unit values. You can provide values with an 
explicit unit type where unit values are used. When a typed value is provided its type overrides the ruler’s 
current setting.

For example, to create a document which is 4 inches wide by 5 inches high you would write:

make new document with properties {width:inches 4, ¬

height:inches 5}

The values returned for a Photoshop CS3 property that uses units is returned as a value of the current ruler 
type. Getting the height of the document created above:

set docHeight to height of current document

returns a value of 5.0, which represents 5 inches based on the current ruler settings.

In AppleScript, you can optionally ask for a property value as a particular type.

set docHeight to height of current document as points

This returns a value of 360 (5 inches x 72 points per inch).

The 

points

 and 

picas

 unit value types are PostScript points, with 72 points per inch. The 

traditional 

points

 and 

traditional picas 

unit value types are based on classical type setting values, with 72.27 

points per inch.

You can convert, or coerce, a unit value from one value type to another. For example, the following script 
converts a point value to an inch value.

set pointValue to 72 as points
set inchValue to pointValue as inches