Adobe 65014293 Scripting Guide - Page 56

Working with Units, Unit values, Special unit value types, AppleScript unit considerations

Get Adobe 65014293 - Photoshop CS4 - Mac PDF manuals and user guides
UPC - 883919153544
View all Adobe 65014293 manuals
Add to My Manuals
Save this manual to your list of manuals

Page 56 highlights

CHAPTER 3: Scripting Photoshop Working with Units 56 Working with Units Photoshop provides two rulers for documents. Using properties on the settings-object (Preferences/Preferences) object, you can set the measurement units for the rulers in your script. The rulers are: ➤ A graphics ruler used for most graphical layout measurements or operations on a document where height, width, or position are specified. You set measurement unit types for the graphics ruler using the ruler units (RulerUnits/rulerUnits) property. ➤ 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. NOTE: These settings correspond to those found in the Photoshop preference dialog under Photoshop > Preferences > Units & Rulers on Mac OS or Edit > Preferences > Units & Rulers in Windows. Unit values 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 "Setting ruler and type units in a script" on page 59 for directions on setting unit values. Please refer to Photoshop Help for information about available unit value types. Special unit value types The unit values used by Photoshop 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 for many operations and values. AppleScript unit considerations 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}

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
C
HAPTER
3: Scripting Photoshop
Working with Units
56
Working with Units
Photoshop provides two rulers for documents. Using properties on the
settings-object
(
Preferences/Preferences
) object, you can set the measurement units for the rulers in your script. The
rulers are:
➤
A graphics ruler used for most graphical layout measurements or operations on a document where
height, width, or position are specified.
You set measurement unit types for the graphics ruler using the
ruler
units
(RulerUnits/rulerUnits)
property.
➤
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.
N
OTE
:
These settings correspond to those found in the Photoshop preference dialog under
Photoshop >
Preferences > Units & Rulers
on Mac OS or
Edit > Preferences > Units & Rulers
in Windows.
Unit values
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
“Setting ruler and type units in a script” on page 59
for directions on setting unit values.
Please refer to Photoshop Help for information about available unit value types.
Special unit value types
The unit values used by Photoshop 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 for many operations and
values.
AppleScript unit considerations
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}