Adobe 19400084 Scripting Guide - Page 32

Changes Since Earlier Versions

Page 32 highlights

JavaScript Scripting Reference Adobe Photoshop CS3 Introduction 32 If Adobe Photoshop CS3 encounters an error during script execution, it displays the error message. Installing scripts To install a JavaScript in the Scripts menu, place it in the Scripts folder (Photoshop CS3/Presets/Scripts). The names of the scripts in the Scripts folder, without the file name extension, will be displayed in the Scripts menu. Any number of scripts may be installed in the Scripts menu. Scripts added to the Scripts folder while Adobe Photoshop CS3 is running will not appear in the Scripts menu until the next time you launch the application. All scripts found in the Scripts folder and sub-folders are displayed at the top level of the File > Scripts menu. The addition of sub-folders does not add a hierarchical organization to the Scripts menu. Executing other scripts The Browse item at the end of the Scripts menu (File > Scripts > Browse) allows you to execute scripts which are not installed in the Scripts folder. You can also use Browse to select scripts installed in the Scripts folder after the application was last launched. Selecting Browse displays a file browser dialog which allows you to select a script file for execution. Only .js or .jsx files are displayed in the browse dialog. When you select a script file, it is executed the same way as an installed script. Startup scripts On startup, Adobe Photoshop CS3 executes all .jsx files that it finds in the startup folders. ● On Windows, the startup folder for user-defined scripts is: C:\Program Files\Common Files\Adobe\Startup Scripts CS3\Adobe Photoshop ● On Mac OS, the startup folder for user-defined scripts is: ~/Library/Application Support/Adobe/Startup Scripts CS3/Adobe Photoshop If a script is meant to be executed only by Adobe Photoshop CS3, it must include code such as the following: if( BridgeTalk.appName == "photoshop" ) { //continue executing script } For additional details, see the JavaScript Tools Guide CS3. Changes Since Earlier Versions The following changes have been made to the JavaScript object model and language support in Adobe Photoshop CS3: ● Documentation Changes: ● Documentation for ExtendScript objects (such as File and Folder objects, Script UI, and the Dollar ($) object) is now found in a separate manual entitled the JavaScript Tools Guide CS3. ●On Windows, the document can be found in the following folder: C:\Program Files\Adobe\Adobe Utilities\ExtendScript Toolkit 2\SDK

  • 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
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229

Adobe Photoshop CS3
JavaScript Scripting Reference
Introduction
32
If Adobe Photoshop CS3 encounters an error during script execution, it displays the error message.
Installing scripts
To install a JavaScript in the Scripts menu, place it in the Scripts folder (
Photoshop CS3/Presets/Scripts
).
The names of the scripts in the Scripts folder, without the file name extension, will be displayed in the
Scripts menu. Any number of scripts may be installed in the Scripts menu.
Scripts added to the Scripts folder while Adobe Photoshop CS3 is running will not appear in the Scripts
menu until the next time you launch the application.
All scripts found in the Scripts folder and sub-folders are displayed at the top level of the
File > Scripts
menu. The addition of sub-folders does not add a hierarchical organization to the Scripts menu.
Executing other scripts
The
Browse
item at the end of the
Scripts
menu (
File > Scripts > Browse
) allows you to execute scripts
which are not installed in the Scripts folder. You can also use Browse to select scripts installed in the Scripts
folder after the application was last launched.
Selecting
Browse
displays a file browser dialog which allows you to select a script file for execution. Only
.js
or
.jsx
files are displayed in the browse dialog. When you select a script file, it is executed the same
way as an installed script.
Startup scripts
On startup, Adobe Photoshop CS3 executes all
.jsx
files that it finds in the startup folders.
On Windows, the startup folder for user-defined scripts is:
C:\Program Files\Common Files\Adobe\Startup Scripts CS3\Adobe Photoshop
On Mac OS, the startup folder for user-defined scripts is:
~/Library/Application Support/Adobe/Startup Scripts CS3/Adobe Photoshop
If a script is meant to be executed only by Adobe Photoshop CS3, it must include code such as the
following:
if( BridgeTalk.appName == "photoshop" ) {
//continue executing script
}
For additional details, see the
JavaScript Tools Guide CS3
.
Changes Since Earlier Versions
The following changes have been made to the JavaScript object model and language support in Adobe
Photoshop CS3:
Documentation Changes:
Documentation for ExtendScript objects (such as File and Folder objects, Script UI, and the Dollar ($)
object) is now found in a separate manual entitled the
JavaScript Tools Guide CS3
.
On Windows, the document can be found in the following folder:
C:\Program Files\Adobe\Adobe Utilities\ExtendScript Toolkit 2\SDK