Adobe 23102480 Scripting Guide - Page 57

Using Unit Values in Calculations, Unit Value Usage

Get Adobe 23102480 - Photoshop CS3 - PC PDF manuals and user guides
UPC - 883919080222
View all Adobe 23102480 manuals
Add to My Manuals
Save this manual to your list of manuals

Page 57 highlights

Adobe Photoshop CS3 Scripting Guide Photoshop CS3 Scripting Photoshop CS3 57 When this script is run, the variable inchValue will contain inches 1, which is 72 points converted to inches. This conversion ability is built in to the AppleScript language. Note: The unit values cm units and mm units cannot be used in this way with a corresponding reference to cm or mm. They are not supported by the AppleScript terminology. Using Unit Values in Calculations To use a unit value in a calculation in Applescript it is necessary to first convert the value to a number (unit value cannot be used directly in calculations). To multiply an inch value write: set newValue to (inchValue as number) * 5 Note: In AppleScript you can get and set values as pixels or percent as you would any other unit value type. You cannot, however, convert a pixel or percent value to another length unit value as you can with other length value types. Trying to run the following script will result in an error. set pixelValue to 72 as pixels -- Next line will result in a coercion error when run set inchValue to pixelValue as inches Note: Because Photoshop CS3 is a pixel-oriented application you may not always get back the same value as you pass in when setting a value. For example, if ruler units is set to mm units, and you create a document that is 30 x 30, the value returned for the height or width will be 30.056 if your document resolution is set to 72 ppi. The scripting interface assumes settings are measured by ppi. Unit Value Usage The following tables list the properties of the classes/objects that are defined to use unit values. Unit values for these properties, unless otherwise indicated in the table, are based the graphics ruler setting. To use this table, do one of the following: ● Look up the properties of the class in the Adobe Photoshop CS3 AppleScript Scripting Reference, or in the Photoshop CS3 AppleScript Dictionary. ● Look up the property of the object in the Adobe Photoshop CS3 Visual Basic Scripting Reference, the Adobe Photoshop CS3 JavaScript Scripting Reference, the Visual Basic Object Browser, or the ExtendScript Object Model Viewer. Class/Object AppleScript Properties Document height width EPS open options height width PDF open options height width lens flare open height options width VBScript Properties Height Width Height Width Height Width Height Width JavaScript Properties height width height width height width height width

  • 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
Photoshop CS3
Adobe Photoshop CS3
Scripting Guide
Scripting Photoshop CS3
57
When this script is run, the variable
inchValue
will contain inches 1, which is 72 points converted to
inches. This conversion ability is built in to the AppleScript language.
Note:
The unit values
cm units
and
mm units
cannot be used in this way with a corresponding reference
to
cm
or
mm
. They are not supported by the AppleScript terminology.
Using Unit Values in Calculations
To use a unit value in a calculation in Applescript it is necessary to first convert the value to a number (unit
value cannot be used directly in calculations). To multiply an inch value write:
set newValue to (inchValue as number) * 5
Note:
In AppleScript you can get and set values as pixels or percent as you would any other unit value
type. You cannot, however, convert a pixel or percent value to another length unit value as you can
with other length value types. Trying to run the following script will result in an error.
set pixelValue to 72 as pixels
-- Next line will result in a coercion error when run
set inchValue to pixelValue as inches
Note:
Because Photoshop CS3 is a pixel-oriented application you may not always get back the same value
as you pass in when setting a value. For example, if
ruler units
is set to mm units, and you create
a document that is 30 x 30, the value returned for the height or width will be 30.056 if your
document resolution is set to 72 ppi. The scripting interface assumes settings are measured by ppi.
Unit Value Usage
The following tables list the properties of the classes/objects that are defined to use unit values. Unit
values for these properties, unless otherwise indicated in the table, are based the graphics ruler setting.
To use this table, do one of the following:
●
Look up the properties of the class in the
Adobe Photoshop CS3 AppleScript Scripting Reference
, or in the
Photoshop CS3 AppleScript Dictionary.
●
Look up the property of the object in the
Adobe Photoshop CS3 Visual Basic Scripting Reference
, the
Adobe Photoshop CS3 JavaScript Scripting Reference
, the Visual Basic Object Browser, or the ExtendScript
Object Model Viewer.
Class/Object
AppleScript
Properties
VBScript
Properties
JavaScript
Properties
Document
height
width
Height
Width
height
width
EPS open options
height
width
Height
Width
height
width
PDF open options
height
width
Height
Width
height
width
lens flare open
options
height
width
Height
Width
height
width