Adobe Photoshop CS4 VBScript Scripting Reference For Windows Ref
User Manual: adobe Photoshop - CS4 - VBScript Scripting Reference for Windows Free User Guide for Photoshop Software, Manual
Open the PDF directly: View PDF 
.
Page Count: 187
| Download | |
| Open PDF In Browser | View PDF |
ADOBE PHOTOSHOP CS4
VBSCRIPT SCRIPTING REFERENCE
bc
© 2008 Adobe Systems Incorporated. All rights reserved.
Adobe® Creative Suite® 4 Photoshop® VBScript Scripting Reference for Windows®.
NOTICE: All information contained herein is the property of Adobe Systems Incorporated. No part of this publication (whether in hardcopy or
electronic form) may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or
otherwise, without the prior written consent of Adobe Systems Incorporated. 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.
Adobe®, the Adobe logo, Acrobat®, Illustrator®, and Photoshop® are either registered trademarks or trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Apple®, Mac OS®, and Macintosh® are trademarks of Apple Computer, Inc., registered in the United States and other countries. Microsoft®, and
Windows® are either registered trademarks or trademarks of Microsoft Corporation in the United States and other countries. JavaScriptTM and
all Java-related marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. UNIX® is a
registered trademark of The Open Group.
All other trademarks are the property of their respective owners.
If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished
under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part
of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording,
or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected
under copyright law even if it is not distributed with software that includes an end user license agreement.
The content of this guide is furnished for informational use only, 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 that may appear in the informational content contained in this guide.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Contents
1
Introduction ................................................................................................................................. 5
Changes Since Earlier Versions.................................................................................................................................................. 5
2
VBScript Interface........................................................................................................................ 6
Working with the Properties Tables ........................................................................................................................................ 6
Working with the Methods Tables ........................................................................................................................................... 6
ActionDescriptor ............................................................................................................................................................................ 8
ActionList.........................................................................................................................................................................................11
ActionReference ...........................................................................................................................................................................14
Application .....................................................................................................................................................................................16
ArtLayer............................................................................................................................................................................................23
ArtLayers..........................................................................................................................................................................................35
BatchOptions .................................................................................................................................................................................36
BitmapConversionOptions .......................................................................................................................................................38
BMPSaveOptions ..........................................................................................................................................................................39
CameraRAWOpenOptions ........................................................................................................................................................40
Channel............................................................................................................................................................................................42
Channels ..........................................................................................................................................................................................43
CMYKColor......................................................................................................................................................................................49
ColorSampler .................................................................................................................................................................................50
ColorSamplers ...............................................................................................................................................................................51
ContactSheetOptions .................................................................................................................................................................52
CountItem .......................................................................................................................................................................................54
CountItems .....................................................................................................................................................................................55
DCS1_SaveOptions......................................................................................................................................................................56
DCS2_SaveOptions......................................................................................................................................................................57
DICOMOpenOptions ...................................................................................................................................................................58
Document .......................................................................................................................................................................................59
DocumentInfo ...............................................................................................................................................................................68
Documents .....................................................................................................................................................................................71
EPSOpenOptions ..........................................................................................................................................................................72
EPSSaveOptions............................................................................................................................................................................73
ExportOptionsIllustrator ............................................................................................................................................................74
ExportOptionsSaveForWeb ......................................................................................................................................................75
GalleryBannerOptions ................................................................................................................................................................77
GalleryCustomColorOptions ....................................................................................................................................................78
GalleryImagesOptions ................................................................................................................................................................79
GalleryOptions...............................................................................................................................................................................81
GallerySecurityOptions ..............................................................................................................................................................83
GalleryThumbnailOptions.........................................................................................................................................................84
GIFSaveOptions.............................................................................................................................................................................85
GrayColor.........................................................................................................................................................................................87
HistoryState ....................................................................................................................................................................................88
HistoryStates ..................................................................................................................................................................................89
HSBColor..........................................................................................................................................................................................90
IndexedConversionOptions .....................................................................................................................................................91
3
Adobe Photoshop CS4
VBScript Scripting Reference
4
JPEGSaveOptions .........................................................................................................................................................................93
LabColor ..........................................................................................................................................................................................94
LayerComp......................................................................................................................................................................................95
LayerComps....................................................................................................................................................................................96
Layers................................................................................................................................................................................................97
LayerSet ...........................................................................................................................................................................................98
LayerSets ...................................................................................................................................................................................... 100
MeasurementLog ...................................................................................................................................................................... 102
MeasurementScale ................................................................................................................................................................... 103
NoColor ......................................................................................................................................................................................... 104
Notifier........................................................................................................................................................................................... 105
Notifiers......................................................................................................................................................................................... 106
PathItem ....................................................................................................................................................................................... 108
PathItems ..................................................................................................................................................................................... 112
PathPoint...................................................................................................................................................................................... 113
PathPointInfo.............................................................................................................................................................................. 114
PathPoints.................................................................................................................................................................................... 115
PDFOpenOptions ...................................................................................................................................................................... 116
PDFSaveOptions ........................................................................................................................................................................ 117
PhotoCDOpenOptions ............................................................................................................................................................ 120
PhotoshopSaveOptions .......................................................................................................................................................... 121
PICTFileSaveOptions ................................................................................................................................................................ 122
PicturePackageOptions........................................................................................................................................................... 123
PixarSaveOptions ...................................................................................................................................................................... 124
PNGSaveOptions ....................................................................................................................................................................... 125
Preferences .................................................................................................................................................................................. 126
PresentationOptions ................................................................................................................................................................ 131
RawFormatOpenOptions ....................................................................................................................................................... 132
RawSaveOptions........................................................................................................................................................................ 133
RGBColor....................................................................................................................................................................................... 134
Selection ....................................................................................................................................................................................... 135
SGIRGBSaveOptions ................................................................................................................................................................. 140
SolidColor..................................................................................................................................................................................... 141
SubPathInfo................................................................................................................................................................................. 142
SubPathItem................................................................................................................................................................................ 143
SubPathItems.............................................................................................................................................................................. 144
TargaSaveOptions..................................................................................................................................................................... 145
TextFont........................................................................................................................................................................................ 146
TextFonts...................................................................................................................................................................................... 147
TextItem........................................................................................................................................................................................ 148
TiffSaveOptions.......................................................................................................................................................................... 154
XMPMetadata ............................................................................................................................................................................. 156
3
Scripting Constants .................................................................................................................157
Appendix A: Event ID Codes ...................................................................................................174
Index .........................................................................................................................................182
1
Introduction
This reference describes the objects and commands in the Adobe® Photoshop® CS® 4 VBScript dictionary. A
companion document, Photoshop CS4 Scripting Guide, describes basic scripting concepts and the
Photoshop object model. This document provides reference details of the Photoshop object model, and
additional information on VBScript-specific features.
This book contains the following sections:
●
This introduction, which describes scripting support in Adobe Photoshop CS4, and lists changes to the
VBScript interface since the previous release.
●
“VBScript Interface” on page 6, which describes the objects of the VBScript type library for Adobe
Photoshop CS4.
●
“Scripting Constants” on page 157, which describes the enumerated values defined for use with Adobe
Photoshop CS4 VBScript properties and methods.
Changes Since Earlier Versions
The following changes have been made to the VBScript object model and language support in Adobe
Photoshop CS4:
●
●
●
New properties:
●
Build added to the Application object.
●
SystemInformation added to the Application object.
Modified enumerations:
●
psBlackAndWhiteLayer (22)has been added to the psLayerKind enumeration.
●
psVibrance (23)has been added to the psLayerKind enumeration.
●
psLighterColor (27) has been added to the psColorBlendMode enumeration.
●
psDarkerColor (28) has been added to the psColorBlendMode enumeration.
Modified properites:
●
size has been modified for the TextItem property to be of type unit value instead of number
(Double).
5
2
VBScript Interface
The objects of the VBScript type library for Adobe Photoshop CS4 are presented alphabetically and in
tabular format in this chapter.
Object properties and methods are described in separate tables for each object. See ‘Working with the
Properties Tables’ on page 6 and ‘Working with the Methods Tables’ on page 6 for information on how to
use these tables.
Sample code for several object model classes is given to help illustrate the syntax as well as usage of the
object class.
Working with the Properties Tables
The Properties table for an object lists the following:
●
The properties you can use with the object
●
The value type for each property
When the value type is a constant or another object, the value is a hypertext link to the constant’s or
object’s listing, as in the following Properties table sample.
●
The property’s input status: Read-only or Read-write.
●
A description that explains what the property is
Descriptions are omitted for self-explanatory properties.
Property
Value Type
DisplayDialogs PsDialogModes
What it is
Read-write. Controls whether or not Adobe Photoshop CS4
displays dialog boxes.
Working with the Methods Tables
The Methods table for an object lists the following:
●
The method name
●
Parameter(s)
When a parameter type or return value is a constant or another object, the value is a hypertext link to
the constant’s or object’s listing. In the following Methods table sample, the parameter type
ActionDescriptor is an object; the parameter type DialogModes is a constant; the return value
ActionDescriptor is also an object.
Parameters can be required or optional. Optional parameters are indicated in the table by square
brackets ([]). See ‘Working with Method Parameters’ on page 7 for information on using parameters.
●
Return value type(s)
●
A description, if applicable
6
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
ExecuteAction
(EventID
[, Descriptor]
[, DisplayDialogs])
7
Returns
What it does
ActionDescriptor
Plays an ActionManager event.
Number (Long)
ActionDescriptor
PsDialogModes
Working with Method Parameters
Optional parameters are surrounded by square brackets ( [ ] ). In the following Methods table sample, the
parameters Descriptor and DisplayDialogs are optional and the parameter EventID is not. See
Therefore, if you use the ExecuteAction() method for the object associated with the sample Methods
table above, you must include an EventID value in the Parentheses following the method name. The
EventID value must be a number, as indicated by the Number (Long) in the table’s Parameter Type
column.
If you use an optional parameter, you must separate the parameters with a comma, as indicated by the
comma that precedes each optional parameter in the table.
Also, if you use an optional parameter, you must enter the values in the order they are listed in the table so
that the JavaScript compiler knows which value you are entering. To skip an optional parameter, insert an
extra comma to act as a placeholder.
The following sample provides values for an EventID and a DisplayDialog, but skips the Descriptor
parameter (represented by the empty value between two commas). The statement executes action #4233
and allows only error type dialog boxes to be displayed.
appRef.ExecuteAction(4233,,Error)
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
8
ActionDescriptor
A record of key-value pairs for actions, such as those included on the Adobe Photoshop CS4 Actions menu.
Note: The ActionDescriptor class is part of the Action Manager functionality. See the Photoshop CS4
Scripting Guide.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Count
Number (Long)
Read-only. The number of keys contained in the descriptor.
typename
String
Read-only. The class name of the referenced
ActionDescriptor object.
Methods
Method
Parameter Type
Returns
What it does
Clears the descriptor.
Clear
()
Erases a key from the descriptor.
Erase
(Key)
Number (Long)
GetBoolean
(Key)
GetClass
(Key)
Gets the enumeration type of a
key.
Number (Long)
Gets the enumeration value of a
key.
Number (Long)
Gets the value of a key of type
integer.
Number (Long)
Gets the ID of the Nth key.
ActionList
Gets the value of a key of type list.
Number (Long)
Gets the class ID of an object in a
key of type object.
Number (Long)
GetObjectType
(Key)
Number (Long)
Number (Long)
GetList
(Key)
Gets the value of a key of type
double.
Number (Long)
GetKey
(Index)
Number (Double)
Number (Long)
GetInteger
(Key)
Gets the value of a key of type
class.
Number (Long)
GetEnumerationValue
(Key)
Number (Long)
Number (Long)
GetEnumerationType
(Key)
Gets the value of a key of type
boolean.
Number (Long)
GetDouble
(Key)
Boolean
Number (Long)
Number (Long)
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Number (Long)
object.
String
GetPath
(Key)
What it does (Continued)
ActionDescriptor Gets the value of a key of type
GetObjectValue
(Key)
Returns
9
Number (Long)
Gets the value of a key of type
Alias.
Returns a String that represents a
file path.
GetReference
(Key)
GetString
(Key)
ActionDescriptor
PutBoolean
(Key,
Value)
Number (Long)
Boolean
PutClass
((Key,
Value)
Number (Long)
Number (Long)
PutDouble
(Key,
Value)
Number (Long)
Number (Double)
PutEnumerated
(Key,
EnumType,
Value)
Number (Long)
Number (Long)
Number (Long)
PutInteger
(Key,
Value)
Number (Long)
Number (Long)
PutList
(Key,
Value)
Gets the type of a key.
Number (Long)
Gets the unit type of a key of type
UnitDouble.
Number (Double)
Gets the value of a key of type
UnitDouble.
Boolean
Checks whether the descriptor
contains the provided key.
Boolean
Determines whether the
descriptor is the same as another
descriptor.
Number (Long)
IsEqual
(otherDesc)
PsDescValueType
Number (Long)
HasKey
(Key)
Gets the value of a key of type
String.
Number (Long)
GetUnitDoubleValue
(Key)
String
Number (Long)
GetUnitDoubleType
(Key)
Gets the value of a key of type
ActionReference.
Number (Long)
GetType
(Key)
ActionReference
Number (Long)
Number (Long)
ActionList
Sets the value for a key whose type
is Boolean.
Sets the value for a key whose type
is class.
Sets the value for a key whose type
is double.
Sets the enumeration type and
value for a key.
Sets the value for a key whose type
is integer.
Sets the value for a key whose type
is an ActionList object.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
PutObject
(Key,
ClassID,
Value)
Number (Long)
Number (Long)
ActionDescriptor
PutPath
(Key,
Value)
Number (Long)
String
Number (Long)
ActionReference
PutString
(Key,
Value)
Number (Long)
String
PutUnitDouble
(Key,
UnitID,
Value)
What it does (Continued)
Sets the value for a key whose type
is an Action Descriptor.
Sets the value for a key whose type
is path.
The Value argument takes a
String that represents a file path.
PutReference
(Key,
Value)
Returns
10
Number (Long)
Number (Long)
Number (Double)
Sets the value for a key whose type
is an object reference.
Sets the value for a key whose type
is String.
Sets the value for a key whose type
is a unit value formatted as a
double.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
11
ActionList
This object provides an array-style mechanism for storing dta. It can be used for low-leve access into
Photoshop.
This object is ideal when storing data of the same type. All items in the list must be the same type.
You can use the "put" methods, such as putBoolean(), to append new elements, and can clear the entire
list using clear(), but cannoth otherwise modify the list.
Note: The actionList object is part of the Action Manager functionality. For details on using the Action
Manager, see the Photoshop CS4 Scripting Guide.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the object belongs to.
Count
Number (Long)
Read-only. The number of commands that comprise the
action.
typename
String
Read-only. The class name of the referenced
actionList object.
Methods
With the exception of the Clear() method, you use the methods of this object to either get the value of a
specific type of data in the list or set (put) the value type.
Method
Parameter Type
Returns
What it does
Clears the list.
Clear
()
GetBoolean
(Index)
GetClass
(Index)
Gets the value of a list item of type
double.
Number (Long)
Gets the enumeration type of a list
item.
Number (Long)
Gets the enumeration value of a
list item.
Number (Long)
Gets the value of a list item of type
integer.
ActionList
Gets the value of a list item of type
list.
Number (Long)
GetList
(Index)
Number (Double)
Number (Long)
GetInteger
(Index)
Gets the value of a list item of type
class.
Number (Long)
GetEnumerationValue
(Index)
Number (Long)
Number (Long)
GetEnumerationType
(Index)
Gets the value of a list item of type
boolean.
Number (Long)
GetDouble
(Index)
Boolean
Number (Long)
Number (Long)
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
GetObjectType
(Index)
(Index)
What it does (Continued)
Number (Long)
Gets the class ID of a list item of
type object.
ActionDescriptor
Gets the value of a list item of type
object.
String
Gets the value of a list item of type
Alias.
Number (Long)
GetPath
(Index)
Returns
Number (Long)
GetObjectValue
12
Number (Long)
Retuns a String that represents a
file path.
ActionReference
Gets the value of a list item of type
ActionReference.
String
Gets the value of a list item of type
String.
PsDescValueType
Gets the type of a list item.
Number (Long)
Gets the unit value type of a list
item of type Double.
Number (Double)
Number (Long)
Gets the unit value of a list item of
type double.
Boolean
Sets the value to either true or
false.
GetReference
(Index)
Number (Long)
GetString
(Index)
Number (Long)
GetType
(Index)
Number (Long)
GetUnitDoubleType
(Index)
Number (Long)
GetUnitDoubleValue
(Index)
PutBoolean
(Value)
Sets the class or data type.
PutClass
(Value)
Number (Long)
Sets the value type as a double.
PutDouble
(Value)
Number (Double)
PutEnumerated
(EnumType,
Value)
Number (Long)
Number (Long)
Number (Long)
Sets the value of a list item of type
integer.
ActionList
Sets the value of a list item of type
list or array.
PutInteger
(Value)
PutList
(Value)
PutObject
(ClassID,
Value)
Number (Long)
ActionDescriptor
PutPath
(Value)
Sets the value type as an
enumerated, or constant, value.
String
Sets the value of a list item of type
object.
Sets the value of a list item of type
path.
The Value parameter takes a
String that represents a file path.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Sets the value of a list item whose
type a reference to an object
created in the script.
String
Sets the value of a list item of type
String.
Number (Long)
Number (Double)
Sets the value of a list item of type
unit value represented as a
double.
PutString
(Value)
PutUnitDouble
(UnitID,
Value)
What it does (Continued)
ActionReference
PutReference
(Value)
Returns
13
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
14
ActionReference
A reference object that contains the data describing the object you are referring to.
Note: The actionReference object is part of the Action Manager functionality. See the Photoshop CS4
Scripting Guide.
Properties
Property
Value type
What it does
Application
Object
(Application)
Read-only. The application that the object belongs
to.
typename
String
Read-only. The class name of the referenced Action
object.
Methods
Method
GetContainer
Parameter Type
Returns
What it does
ActionReference
Gets a reference contained in
this reference.
()
Container references provide
additional pieces to the
reference. This looks like another
reference, but it is actually part
of the same reference.
GetDesiredClass
Number (Long)
Gets a number representing the
class of the object.
Number (Long)
Gets the enumeration type.
Number (Long)
Gets the enumeration value.
()
GetEnumeratedType
()
GetEnumeratedValue
()
GetForm
()
GetIdentifier
PsReferenceFormType Gets the form of an
ActionReference.
Number (Long)
Gets the identifier value for a
reference whose form is
identifier.
Number (Long)
Gets the index value for a
reference in a list or array.
String
Gets the name of a reference.
Number (Long)
Gets the offset of the object’s
index value.
()
GetIndex
()
GetName
()
GetOffset
()
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
GetProperty
Returns
What it does (Continued)
Number (Long)
Gets the property ID value.
15
()
Number (Long)
Puts a new class form and class
type into the reference.
Number (Long)
Number (Long)
Number (Long)
Puts an enumeration type and ID
into a reference along with the
desired class for the reference.
PutClass
(DesiredClass)
PutEnumerated
(DesiredClass,
EnumType,
Value)
PutIdentifier
(DesiredClass,
Value)
Number (Long)
Number (Long)
PutIndex
(DesiredClass,
Value)
Number (Long)
Number (Long)
PutName
(DesiredClass,
Value)
Number (Long)
String
PutOffset
(DesiredClass,
Value)
Number (Long)
Number (Long)
PutProperty
(DesiredClass,
Value)
Number (Long)
Number (Long)
Puts a new identifier and value
into the reference..
Puts a new index and value into
the reference.
Puts a new name and value into
the reference.
Puts a new offset and value into
the reference.
Puts a new property and value
into the reference.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
16
Application
The Adobe Adobe Photoshop CS4 application object. The Application object contains all other Adobe
Photoshop CS4 objects.
Properties
Property
Value Type
What it is
ActiveDocument
Document
Read-write. The frontmost document. (Setting this
property is equivalent to clicking an open
document in the Adobe Photoshop CS4 application
to bring it to the front of the screen.)
Application
Object
(Application)
Read-only. The application that the object belongs
to.
BackgroundColor
SolidColor
Read-write. The color mode for the document’s
background color.
Build
string
Read-only. The build number of the application.
ColorSettings
String
Read-write. The name of selected color setting’s
set.
DisplayDialogs
PsDialogModes
Read-write. The dialog mode for the document,
which indicates whether or not Adobe Photoshop
CS4 displays dialogs when the script runs.
Documents
Documents
Read-only. The collection of open documents.
Fonts
TextFonts
Read-only. The fonts installed on this system.
ForegroundColor
SolidColor
Read-write. The default foreground color (used to
paint, fill, and stroke selections).
FreeMemory
Number (Double)
Read-only. The amount of unused memory
available to Adobe Photoshop CS4.
Locale
String
Read-only. The language location of the
application.
MacintoshFileTypes
Array of String
Read-only. A list of file image types Adobe
Photoshop CS4 can open.
MeasurementLog
MeasurementLog
Read-only. The log of measurements taken.
Name
String
Read-only. The application's name.
Notifiers
Notifiers
Read-only. The collection of notifiers currently
configured (in the Scripts Events Manager menu in
the Adobe Photoshop CS4 application).
NotifiersEnabled
Boolean
Read-write. Indicates whether all notifiers are
enabled or disabled.
Path
String
Read-only. The full path (as a String) to the
location of the Adobe Photoshop CS4 application.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
17
Property
Value Type
What it is (Continued)
Preferences
Preferences
Read-only. The application preference settings
(equivalent to selecting Edit > Preferences in the
Adobe Photoshop CS4 application in Windows® or
Photoshop > Preferences in Mac OS®).
PreferencesFolder
String
Read-only. The full path to the Preferences folder.
RecentFiles
Array of String
Read-only. Files (as an Array of String) in the
Recent Files list.
ScriptingBuildDate
String
Read-only. The build date of the Scripting interface.
ScriptingVersion
String
Read-only. The version of the Scripting interface.
SystemInformation
string
Read-only. The system information for the
applicaiton and the system.
typename
String
Read-only. The class name of the referenced
Application object.
Version
String
Read-only. The version of Adobe Photoshop
application you are running.
Visible
Boolean
Read-write. Indicates whether the Adobe
Photoshop CS4 application is the front-most/active
application.
WinColorSettings
String
Read-only. Color settings.
WindowsFileTypes
Array of String
Read-only. A list of file image extensions Adobe
Photoshop CS4 can open.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
18
Methods
Method
Parameter Type
Batch
(InputFiles,
Action,
From
[, Options])
Returns
What it does
String
Runs the batch
automation routine
(similar to the Batch
command, or File >
Automate > Batch in
the Adobe Photoshop
CS4 application).
Array of String
String
String
BatchOptions
Note: The
inputFiles
parameter
specifies the
source for the
files (as an
array of
String) to be
manipulated
by the Batch
command.
None
ChangeColorSettings
([Name]
[, File])
String
String
Sets Color Settings to
a named set or to the
contents of a settings
file.
The File parameter
represents the path to
the file as a String.
CharIDToTypeID
(CharID)
DoAction
(Action,
From)
String
Array
PsJavaScriptExecutionMode
Plays an action from
the Actions palette.
String
Executes the specified
JavaScript code.
String
Executes the specified
JavaScript code, from
the file specified by
argument
JavaScriptFile.
ActionDescriptor Plays an
ExecuteAction
(EventID
[, Descriptor]
[, DisplayDialogs])
none
String
Array
PsJavaScriptExecutionMode
DoJavaScriptFile
(JavaScriptFile,
[, Arguments]
[, ExecutionMode]))
Converts from a four
character code
(character ID) to a
runtime ID.
String
String
DoJavaScript
(JavaScriptCode,
[, Arguments]
[, ExecutionMode]))
Number (Long)
String
Number (Long)
ActionDescriptor
PsDialogModes
ActionManager event.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Returns
ActionReference
ActionDescriptor Obtains an
ActionDescriptor.
ExecuteActionGet
(Reference)
Boolean
FeatureEnabled
(Name
)
19
String
What it does
Determines whether
the feature specified
by Name is enabled.
The following
features are
supported as values
for Name:
“photoshop/extend
ed”
“photoshop/standa
rd”
“photoshop/trial”
Loads a support
document from the
specified file path
location.
Load
(Document)
String
MakeContactSheet
(InputFiles
[, Options])
MakePDFPresentation
(InputFiles
OutputFiles
[, Options])
String
Creates a contact
sheet from the
specified files.
String
Creates a PDF
presentation file from
the specified input
files.
Array of String
ContactSheetOptions
Array of String
String
PresentationOptions
Note: The return
string contains
the path to the
PDF file.
MakePhotoGallery
(InputFolder
OutputFolder
[, Options])
MakePhotomerge
String
Creates a Web photo
gallery from the files
in the specified input
folder.
String
Deprecated for Adobe
Photoshop CS4.
String
String
GalleryOptions
Array of String
(InputFiles)
Merges multiple files
into one; user
interaction required.
String
MakePicturePackage
(InputFiles
[, Options])
Array of String
PicturePackageOptions
Creates a picture
package from the
specified input files.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Open
(Document
[, As]
[, AsSmartObject]
)
Returns
What it does
Document
Opens the specified
document as the
optionally specified
file type. Optional
paramater
String
object (open options)
Boolean
Note: See open options for
individual file types, such
as
CameraRAWOpenOptions
or EPSOpenOptions, etc.
AsSmartObject
(default:false)
indicates whether to
create a smart object
around the opened
document.
Array of String
OpenDialog
20
()
Uses the Photoshop
open dialog box to
select files.
Returns an Array of
String representing
the files selected.
Purges one or more
caches.
Purge
(Target)
PsPurgeTarget
Quits the Photoshop
application.
Quit
()
Pauses the script
while the application
refreshes.
Refresh
()
StringIDToTypeID
(StringID)
TypeIDToCharID
(TypeID)
Converts from a
String ID to a runtime
ID.
String
Converts from a
runtime ID to a
character ID.
String
Converts from a
runtime ID to a String
ID.
Number (Long)
TypeIDToStringID
(TypeID)
Number (Long)
String
Number (Long)
First Sample Script
The following script displays a message box that contains the application version number, the path to the
application, the amount of memory available, and the number of documents open.
When the user clicks OK, a second dialog asks whether they would like the foreground and background
colors set.
A third dialog offers to open a sample file. If the user clicks OK, the script opens the file Fish.psd from the
samples folder in the application directory.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Application.vbs
'
'
'
'
Create a Welcome message
Use the name and version properties of the application object to append the
application’s name and version to the Welcome message use vbCrLf to insert a
carriage return
Dim appRef, message, documentsOpen, answer, sampleDocToOpen
Set appRef = CreateObject("Photoshop.Application")
message = "Welcome to " & appRef.Name
message = message & " version " & appRef.Version & vbCrLf & vbCrLf
' find out where Photoshop CS4 is installed and add the path to the message add
' the optional parameter fsName to the path property to display the file system
' name in the most common format
message = message & "I’m installed in " & appRef.Path & vbCrLf & vbCrLf
'see how much memory Photoshop CS4 has to play with
message = message & "You have this much memory available for Photoshop CS4: "
message = message & appRef.FreeMemory & vbCrLf & vbCrLf
' use the Count property of the Documents object to see how many are open
documentsOpen = appRef.Documents.Count
message = message & "You currently have " & documentsOpen & " documents open." & _
vbCrLf & vbCrLf
'display the message to the user
MsgBox (message)
answer = MsgBox _
("Do you want me to set the foreground and background to my favorite colors?", _
vbYesNo, "Change Colors?")
' set the colors
If answer = vbYes Then
Randomize
' Initialize random-number generator.
' I don’t have a favorite color. Why did I ask you may wonder?
appRef.ForegroundColor.RGB.Red = Rnd() * 255
appRef.ForegroundColor.RGB.Green = Rnd() * 255
appRef.ForegroundColor.RGB.Blue = Rnd() * 255
appRef.BackgroundColor.RGB.Red = Rnd() * 255
appRef.BackgroundColor.RGB.Green = Rnd() * 255
appRef.BackgroundColor.RGB.Blue = Rnd() * 255
End If
' Open a document
If documentsOpen = 0 Then
' use the application’s path and the offset to the samples folder
sampleDocToOpen = appRef.Path & "Samples\Fish.psd"
' compose a message with the name of the file
message = "Would you like me to open a sample for you? ("
message = message & sampleDocToOpen & ")"
' ask the user another question
answer = MsgBox (message, vbYesNo, "Open Something?")
' open the document accordingly
If answer = vbYes Then
appRef.Open sampleDocToOpen
End If
End If
21
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Second Sample Script
The following script presents a progression of images as a PDF slide show.
PDFPresentation.vbs
' use all the files in the Samples folder
Dim appRef, inputFiles(), i, outputFile, options, objWshShell
Set appRef = CreateObject("Photoshop.Application")
' get all the files found in this folder
Set fsoRef = CreateObject( "Scripting.FileSystemObject" )
Set folderRef = fsoRef.GetFolder( appRef.Path & "Samples\" )
ReDim inputFiles(folderRef.Files.Count-1)
i = 0
For Each f in folderRef.Files
inputFiles(i) = f.Path
i = i + 1
Next
' Get a shell object so we can point to the desktop
Set shellRef = WScript.CreateObject("Wscript.Shell")
outputFile = shellRef.SpecialFolders("Desktop") & "\VBSPresentation.pdf"
' there are defaults but I like to set the options myself
Set options = CreateObject("Photoshop.PresentationOptions")
options.Presentation = true
options.PDFFileOptions.Encoding = 2 'for PsPDFEncoding --> 2 (psPDFJPEG)
options.AutoAdvance = true
options.Interval = 5
options.Loop = false
options.Transition = 10 'for PsTransitionType --> 10 (psRandom)
' create the presentation
appRef.MakePDFPresentation inputFiles, outputFile, options
Set objWshShell = WScript.CreateObject("Wscript.Shell")
WScript.Echo "Presentation file saved in: " &
_
shellRef.SpecialFolders("Desktop") & "\VBSPresentation.pdf"
22
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
23
ArtLayer
An object within a document that contains the visual elements of the image (equivalent to a layer in the
Adobe Photoshop CS4 application).
Properties
Property
Value Type
What it is
AllLocked
Boolean
Read-write. Indicates whether to completely lock the
layer’s contents and settings.
Application
Object
(Application)
Read-only. The application that this art layer belongs
to.
BlendMode
PsBlendMode
Read-write. The layer’s blending mode.
Bounds
Array
Read-only. An array of coordinates that describes the
bounding rectangle of the ArtLayer.
FillOpacity
Number (Double) Read-write. The interior opacity of the layer (0.0 -
100.0).
Grouped
Boolean
Read-write. Indicates whether to group this layer with
the layer beneath it.
IsBackgroundLayer
Boolean
Read-write. Indicates whether the layer is a
background layer or normal layer.
Note: A document can have only one background
layer.
Kind
PsLayerKind
Read-write. Sets the layer’s kind (such as 'text layer')
for an empty layer.
Note: Valid only when the layer is empty and when
IsBackgroundLayer is false. See
IsBackgroundLayer.
Note: You can use the kind property to make a
background layer a normal layer; however, to
make a layer a background layer, you must set
IsBackgroundLayer to true.
LinkedLayers
Array of
Read-only. The layers linked to this layer.
ArtLayer and/or
LayerSet
Note: See Link.
Read-write. The layer’s name.
Name
String
Opacity
Number (Double) Read-write. The master opacity of the layer (0.0 -
100.0).
Parent
Object
(Document)
Read-only. The object's container.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
24
Property
Value Type
What it is (Continued)
PixelsLocked
Boolean
Read-write. Indicates whether the pixels in the layer’s
image can be edited using the paintbrush tool.
PositionLocked
Boolean
Read-write. Indicates whether the pixels in the layer’s
image can be moved within the layer.
TextItem
TextItem
Read-only. The text item that is associated with the
layer.
Note: Valid only when Kind = 2. See Kind.
TransparentPixelsLocked
Boolean
Read-write. Indicates whether editing is confined to
the opaque portions of the layer.
typename
String
Read-only. The class name of the referenced
ArtLayer object.
Visible
Boolean
Read-write. Indicates whether the layer is visible.
XMPMetadata
Object
(XMPMetadata)
Read-only. XMP data for the layer.
Methods
Method
Parameter Type
AdjustBrightnessContrast
(Brightness,
Contrast)
Number (Long)
Number (Long)
AdjustColorBalance
([Shadows]
[, Midtones]
[, Highlights]
[, PreserveLuminosity]
Array of Number
Array of Number
Array of Number
Boolean
Returns
What it does
Adjusts the brightness (-100 100) and contrast (-100 - 100).
Adjusts the color balance of the
layer’s component channels. For
Shadows, Midtones, and
Highlights, the array must
include three values (-100 - 100),
which represent cyan or red,
magenta or green, and yellow or
blue, when the document mode
is CMYK or RGB.
Note: See mode in the Properties
table of the Document
object.
AdjustCurves
(CurveShape)
Array of points
(Array (Array(x, y)))
Adjusts the tonal range of the
selected channel using up to
fourteen points.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
AdjustLevels
(InputRangeStart,
InputRangeEnd,
InputRangeGamma,
OutputRangeStart,
OutputRangeEnd)
Number
Number
Number
Number
Number
(Long)
(Long)
(Double)
(Long)
(Long)
ApplyAddNoise
(Amount,
Distribution,
Monochromatic)
Number (Double)
PsNoiseDistribution
Boolean
Returns
25
What it does (Continued)
Adjusts the levels of the selected
channels (InputRangeStart: 0 253; InputRangeEnd:
(InputRangeStart + 2) - 255;
InputRangeGamma: 0.10 - 9.99;
OutputRangeStart: 0 - 253;
OutputRangeEnd:
(OutputRangeStart + 2) - 255.
Applies the Add Noise filter
(Amount: 0.1 - 400, as a
percentage).
Applies the Average filter.
ApplyAverage
()
Applies the Blur filter.
ApplyBlur
()
Applies the Blur More filter.
ApplyBlurMore
()
Applies the Clouds filter.
ApplyClouds
()
Applies a custom filter.
ApplyCustomFilter
(Characteristics,
Scale,
Offset)
Array of twenty-five
Numbers (Long)
Number (Long)
Number (Long)
Applies the De-Interlace filter.
ApplyDeInterlace
(EliminateFields,
CreateFields)
Note: Required parameter
values define the filter.
Refer to Adobe
Photoshop CS4 Help for
specific instructions.
PsEliminateFields
PsCreateFields
Applies the Despeckle filter.
ApplyDespeckle
()
Applies the Difference Clouds
filter.
ApplyDifferenceClouds
()
Number (Long)
Number (Long)
Number (Long)
Applies the Diffuse Glow filter
(Graininess: 0 - 10;
GlowAmount: 0 - 20;
ClearAmount: 0 - 20).
Number (Long)
Number (Long)
PsDisplacementMapType
PsUndefinedAreas
String
Applies the Displace filter using
the specified horizontal and
vertical scale (-999 - 999),
mapping type, treatment of
undistorted areas, and path to
the distortion image map.
ApplyDiffuseGlow
(Graininess,
GlowAmount,
ClearAmount)
ApplyDisplace
(HorizontalScale,
VerticalScale,
DisplacementType,
UndefinedAreas,
DisplacementMapFiles)
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Applies the Dust & Scratches
filter (Radius: 1 - 100;
Threshold: 0 - 255).
Number (Double)
Applies the Gaussian Blur filter
within the specified radius (in
pixels) (0.1 - 250.0).
ApplyGaussianBlur
(Radius)
ApplyGlassEffect
(Distortion,
Smoothness,
Scaling
[, Invert]
[, Texture]
[, TextureFile])
Number (Long)
Number (Long)
Number (Long)
Boolean
PsTextureType
String
ApplyHighPass
(Radius)
What it does (Continued)
Number (Long)
Number (Long)
ApplyDustAndScratches
(Radius,
Threshold)
Returns
Number (Double)
26
Applies the Glass filter
(Distortion: 0 - 20;
Smoothness: 1 - 15; Scaling (in
percent): 50 - 200).
Note: The TextureFile
parameter represents the
path to a texture file as a
String.
Applies the High Pass filter
within the specified radius (in
pixels) (0.1 - 250.0).
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
What it does (Continued)
Applies the Lens Blur filter.
ApplyLensBlur
([Source]
[, FocalDistance]
[, InvertDepthMap]
[, Shape]
[, Radius]
[, BladeCurvature]
[, Rotation]
[, Brightness]
[, Threshold]
[, Amount]
[, Distribution]
[, Monochromatic]
)
Returns
27
PsDepthMapSource
Number (Long)
Boolean
PsGeometry
Number (Long)
Number (Long)
Number (Long)
Number (Long)
Number (Long)
Number (Long)
PsNoiseDistribution
Boolean
source: the source for the depth
map. Default: 1 (psNoSource).
focalDistance : the blur focal
distance for the depth map
(default: 0).
invertDepthMask : whether the
depth map is inverted (default:
false).
shape: The shape of the iris.
Default: 2 (psHexagon).
radius: The radius of the iris
(default: 15).
bladeCurvature: The blade
curvature of the iris (default: 0).
rotation: The rotation of the iris
(default: 0)
brightness: The brightness for
the specular highlights (default:
0).
threshold: The threshold for
the specular highlights (default:
0).
amount: The amount of noise
(default: 0)
distribution: The distribution
value for the noise. Default: 1
(psUniformNoise).
monochromatic: Indicates
whether the noise is
monochromatic (default: false).
ApplyLensFlare
(Brightness,
FlareCenter,
LensType)
Number (Long)
Array (Double)
PsLensType
Number (Double)
Applies the Maximum filter
within the specified radius (in
pixels) (1 - 100).
Number (Double)
Applies the Median Noise filter
within the specified radius (in
pixels) (1 - 100).
ApplyMaximum
(Radius)
ApplyMedianNoise
(Radius)
Applies the Lens Flare filter with
the specified brightness (0 - 300,
as a percentage), the x and y
coordinates (unit value) of the
flare center, and the lens type.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Applies the Minimum filter
within the specified radius (in
pixels) (1 - 100).
Number (Long)
Number (Double)
Applies the Motion Blur filter
(Angle: -360 - 360; Radius: 1 999).
ApplyMotionBlur
(Angle,
Radius)
What it does (Continued)
Number (Double)
ApplyMinimum
(Radius)
Returns
28
Applies the NTSC colors filter.
ApplyNTSC
()
ApplyOceanRipple
(Size,
Magnitude)
Number (Long)
Number (Long)
ApplyOffset
(Horizontal,
Vertical,
UndefinedAreas)
Number (Double)
Number (Double)
PsOffsetUndefinedAreas
Applies the Pinch filter in the
specified amount (as a
percentage) (-100 - 100).
PsPolarConversionType
Applies the Polar Coordinates
filter.
Number (Long)
PsRadialBlurMethod
PsRadialBlurQuality
Applies the Radial Blur filter in
the specified amount (1 - 100)
using either a spin or zoom
effect and the specified quality.
Number (Long)
PsRippleSize
Applies the Ripple filter in the
specified amount (-999 to 999)
throughout the image and in the
specified size.
ApplyPolarCoordinates
(Conversion)
ApplyRadialBlur
(Amount,
BlurMethod,
BlurQuality)
ApplyRipple
(Amount,
Size)
Moves the layer the specified
amount horizontally and
vertically (min/max amounts
depend on layer size), leaving an
undefined area at the layer’s
original location.
Number (Long)
ApplyPinch
(Amount)
Applies the Ocean Ripple filter in
the specified size (1 - 15) and
magnitude (0 - 20).
Applies the Sharpen filter.
ApplySharpen
()
Applies the Sharpen Edges filter.
ApplySharpenEdges
()
Applies the Sharpen More filter.
ApplySharpenMore
()
ApplyShear
(Curve,
UndefinedAreas)
Array of points
(Array (Array(x, y)))
PsUndefinedAreas
Applies the Shear filter (curve: 2
- 255 points).
Note: You must define at least
two points in the Curve
parameter.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
ApplySmartBlur
(Radius,
Threshold,
BlurQuality,
Mode)
Number (Double)
Number (Double)
PsSmartBlurQuality
PsSmartBlurMode
Applies the smart blur filter
(Radius: 0.1 - 100.0; Threshold:
0.1 - 100.0).
Applies the Spherize filter in the
specified amount (as
percentage) (-100 - 100).
String
Applies the specified style to the
layer.
ApplyStyle
(StyleName)
What it does (Continued)
Number (Long)
PsSpherizeMode
ApplySpherize
(Amount,
Mode)
Returns
29
Note: You must use a style from
the Styles list in the Layer
Style dialog.
Applies the Texture Fill filter.
ApplyTextureFill
(TextureFile)
String
Number (Long)
Applies the Twirl filter at the
specified angle (-999 - 999).
Number (Double)
Number (Double)
Number (Long)
Applies the Unsharp Mask filter
(Amount: 1 - 500 as percent;
Radius: 0.1 - 250.00; Threshold:
0 - 255).
ApplyTwirl
(Angle)
ApplyUnSharpMask
(Amount,
Radius,
Threshold)
ApplyWave
(GeneratorNumber,
MinimumWavelength,
MaximumWavelength,
MinimumAmplitude,
MaximumAmplitude,
HorizontalScale,
VerticalScale,
WaveType,
UndefinedAreas,
RandomSeed)
Number (Long)
Number (Long)
Number (Long)
Number (Long)
Number (Long)
Number (Long)
Number (Long)
PsWaveType
PsUndefinedAreas
Number (Long)
ApplyZigZag
(Amount,
Ridges,
Style)
AutoContrast
()
AutoLevels
()
Clear
()
Number (Long)
Number (Long)
PsZigZagType
Applies the Wave filter
(GeneratorNumber: 1 - 999;
MinimumWavelength: 1 - 998;
MaximumWavelength:
2 - MinimumWavelength + 1;
MinimumAmplitude: 1 - 998;
MaximumAmplitude:
2 - MinimumAmplitude + 1;
AmountScale: 1 - 100, as a
percentage;
VerticalScale: 1 - 100, as a
percentage).
Applies the Zigzag filter (Amount:
-100 - 100; Ridges: 0 - 20).
Adjusts the contrast of the
selected channels automatically.
Adjusts the levels of the selected
channels using the auto levels
option.
Cuts the layer without moving it
to the clipboard.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Copy
([Merge])
Boolean
Returns
30
What it does (Continued)
Copies the layer to the clipboard.
When the optional argument is
set to true, a merged copy is
performed (that is, all visible
layers are copied to the
clipboard).
Cuts the layer to the clipboard.
Cut
()
Converts a color image to a
grayscale image in the current
color mode by assigning equal
values of each component color
to each pixel.
Desaturate
()
ArtLayer Creates a duplicate of the object
Duplicate
([RelativeObject]
[, InsertionLocation])
Object (ArtLayer or
LayerSet)
PsElementPlacement
Redistributes the brightness
values of pixels in an image to
more evenly represent the entire
range of brightness levels within
the image.
Equalize
()
Inverts the colors in the layer by
converting the brightness value
of each pixel in the channels to
the inverse value on the
256-step color-values scale.
Invert
()
Link
(With)
Merge
()
on the screen.
Object (ArtLayer or
LayerSet)
Links the layer with the specified
layer.
ArtLayer Merges the layer down,
removing the layer from the
document; returns a reference to
the art layer that this layer is
merged into.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
MixChannels
(OutputChannels
[, Monochrome])
Array of Array of
Number (Double)
Boolean
Returns
31
What it does (Continued)
Modifies a targeted (output)
color channel using a mix of the
existing color channels in the
image. (OutputChannels = An
array of channel specifications.
For each component channel,
specify a list of adjustment
values (-200 - 200) followed by a
'constant' value (-200 - 200).)
Note: When Monochrome =
true, the maximum
number of channel value
specifications is 1.
Note: Valid only when
Document.Mode = 2 or
Document.Mode = 3.
Note: RGB arrays must include
four doubles. CMYK arrays
must include five doubles.
Move
(ApplicationObject,
InsertionLocation)
Object (ArtLayer or
LayerSet)
PsElementPlacement
Moves the layer relative to the
object specified in parameters.
Note: For art layers, only the
constant values 3 and 4
are valid.
For layer sets, only the
constant values 3 and 0
are valid.
PhotoFilter
([FillColor]
[, Density]
[, PreserveLuminosity])
SolidColor
Number (Long)
Boolean
Posterize
(Levels)
Number (Long)
Converts the targeted contents
in the layer into a flat, raster
image.
Number (Double)
Number (Double)
PsAnchorPosition
Resizes the layer to the specified
dimensions (as a percentage of
its current size) and places it in
the specified position.
Resize
([Horizontal]
[, Vertical]
[, Anchor])
Specifies the number of tonal
levels (2 - 255) for each channel
and then maps pixels to the
closest matching level.
PsRasterizeType
Rasterize
(Target)
Adjust the layer’s color balance
and temperature as if a color
filter had been applied (Density:
1 - 100, as a percentage).
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Rotate
(Angle
[, Anchor])
Number (Double)
PsAnchorPosition
SelectiveColor
(SelectionMethod
[, Reds]
[, Yellows]
[, Greens]
[, Cyans]
[, Blues]
[, Magentas]
[, Whites]
[, Neutrals]
[, Blacks])
PsAdjustmentReference
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
Array of Number (Long)
ShadowHighlight
([ShadowAmount]
[, ShadowWidth]
[, ShadowRadius]
[, HighlightAmount]
[, HighlightWidth]
[, HighlightRadius]
[, ColorCorrection]
[, MidtoneContrast]
[, BlackClip]
[, WhiteClip])
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
(Long)
(Long)
(Long)
(Long)
(Long)
(Long)
(Long)
(Long)
(Double)
(Double)
Threshold
(Level)
Number (Long)
Translate
([DeltaX]
[, DeltaY])
Unlink
Number (Double)
Number (Double)
Returns
32
What it does (Continued)
Rotates the layer around the
specified anchor point.
Modifies the amount of a
process color in a specified
primary color without affecting
the other primary colors.
Note: Each color array must
have four components.
Adjusts the range of tones in the
image’s Shadows and highlights
(ShadowAmount: 0 - 100 as
percent; ShadowWidth: 0 - 100 as
percent; ShadowRadius: 0 - 2500
in pixels; HighlightAmount: 0 100 as percent;
HighlightWidth: 0 - 100 as
percent; HighlightRadius: 0 2500 in pixels;
ColorCorrection: -100 - 100;
MidtoneContrast: -100 - 100;
BlackClip: 0.000 - 50.000;
WhiteClip: 0.000 - 50.000).
Converts grayscale or color
images to high-contrast, B/W
images by converting pixels
lighter than the specified
threshold to white and pixels
darker than the threshold to
black (level: 1 - 255).
Moves the layer the specified
amount (in pixels) relative to its
current position.
Unlinks the layer.
()
Sample Script
The following script closes any open documents (files), then opens each file in the Samples folder, creating
an art layer for each image and using the image’s file name as the layer name.
ArtLayer.vbs
Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, mergedDoc
Dim fsoRef, folderRef, topLeftH, topLeftV, docH, docV, docName, selRegion
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Dim x, y, layer1, layer2
Set appRef = CreateObject("Photoshop.Application")
' Save the current preferences
startRulerUnits = appRef.Preferences.RulerUnits
startTypeUnits = appRef.Preferences.TypeUnits
startDisplayDialogs = appRef.DisplayDialogs
' Set Photoshop CS4 to use pixels and display no dialogs
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels)
appRef.Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels)
appRef.DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs)
' Close all the open documents
Do While appRef.Documents.Count
appRef.ActiveDocument.Close()
Loop
' Create a new document to merge all the samples into
Set mergedDoc = appRef.Documents.Add(1000, 1000, 72, "Merged Samples", 2, 3, 1)
'enumerated values 2 = PsNewDocumentMode --> 2 (PsNewRGB) and
'3 = PsDocumentFill --> 3 (psTransparent)
' get all the files found in this folder
Set fsoRef = CreateObject( "Scripting.FileSystemObject" )
Set folderRef = fsoRef.GetFolder( appRef.Path & "Samples\" )
Randomize
' open each file
For Each f in folderRef.Files
appRef.Open f.Path
' use the document name for the layer name in the merged document
docName = appRef.ActiveDocument.Name
' flatten the document so we get everything and then copy
appRef.ActiveDocument.flatten()
appRef.ActiveDocument.Selection.SelectAll()
appRef.ActiveDocument.Selection.Copy()
' don’t save anything we did
appRef.ActiveDocument.Close(2)
'the enumerated value Close(2) = PsSaveOptions >2 (psDoNotSaveChanges)
' make a random selection on the document to paste into
' by dividing the document up in 4 quadrants and pasting
' into one of them by selecting that area
topLeftH = Int(Rnd() * 2)
topLeftV = Int(Rnd() * 2)
' MsgBox topLeftH & ":" & topLeftV
docH = appRef.ActiveDocument.Width / 2
docV = appRef.ActiveDocument.Height / 2
selRegion = Array( Array( topLeftH * docH, topLeftV * docV), _
Array( topLeftH * docH + docH, topLeftV * docV), _
Array( topLeftH * docH + docH, topLeftV * docV + docV), _
Array( topLeftH * docH, topLeftV * docV + docV), _
Array( topLeftH * docH, topLeftV * docV))
appRef.ActiveDocument.Selection.Select(selRegion)
33
Adobe Photoshop CS4
VBScript Scripting Reference
appRef.ActiveDocument.Paste()
' change the layer name and opacity
appRef.ActiveDocument.ActiveLayer.Name = docName
appRef.ActiveDocument.ActiveLayer.FillOpacity = 50
Next
' sort the layers by name
x = 0
y = 0
for x = 1 To appRef.ActiveDocument.Layers.Count
for y = 1 To appRef.ActiveDocument.Layers.Count - 1
Set layer1 = appRef.ActiveDocument.Layers(y)
Set layer2 = appRef.ActiveDocument.Layers(y + 1)
If layer1.Name > layer2.Name Then
layer1.move layer2, 4
End If
Next
Next
' Reset the application preferences
appRef.Preferences.RulerUnits = startRulerUnits
appRef.Preferences.TypeUnits = startTypeUnits
appRef.DisplayDialogs = startDisplayDialogs
VBScript Interface
34
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
35
ArtLayers
The collection of ArtLayer objects in the document.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs
to.
Count
Number (Long)
Read-only. The number of elements in the ArtLayers
collection.
Parent
Object
(Document)
Read-only. The object's container.
typename
String
Read-only. The class name of the referenced
ArtLayers object.
Methods
Method
Parameter Type
Add
Returns
What it does
ArtLayer
Creates a new ArtLayer in the
document.
Number
(long)
Gets the index of the ArtLayer into
the collection.
ArtLayer
Gets an element from the ArtLayers
collection.
Nothing
Removes all elements from the
ArtLayers collection.
()
Index
(ItemPtr)
Object
(ArtLayer)
Item
(ItemKey)
RemoveAll
()
Number (Long)
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
36
BatchOptions
Options to specify when running a Batch command.
Properties
Property
Value type
What it is
Application
Object (Application)
Read-only. The application that the object
belongs to.
Destination
PsBatchDestinationType Read-write. The type of destination for the
processed files. Default: 1(psNoDestination).
DestinationFolder
String
Read-write. The folder location for the processed
files.
Note: Valid only when Destination = 3
(psFolder). See Destination.
ErrorFile
String
Read-write. The file in which to log errors
encountered.
Note: To display errors on the screen (and stop
batch processing when errors occur)
leave blank.
FileNaming
Array of
(PsFileNamingType
options)
Read-write. A list of file naming options
(maximum: 6).
Note: Valid only when Destination = 3
(psFolder). See Destination.
MacintoshCompatible
Boolean
Read-write. Indicates whether to make the final
file names Macintosh compatible. Default: true.
Note: Valid only when Destination = 3
(psFolder). See Destination.
OverrideOpen
Boolean
Read-write. Indicates whether to override action
open commands. Default: false.
OverrideSave
Boolean
Read-write. Indicates whether to override save
as action steps with the specified destination.
Default: false.
Note: Valid only when Destination = 3
(psFolder). or Destination = 2
(psSaveAndClose). See Destination.
StartingSerial
Number (Long)
Read-write. The starting serial number to use in
naming files. Default: 1.
Note: Valid only when Destination = 3
(psFolder). See Destination.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
37
Property
Value type
What it is (Continued)
SuppressOpen
Boolean
Read-write. Indicates whether to suppress the
file open options dialogs. Default: false.
SuppressProfile
Boolean
Read-write. Indicates whether to suppress the
color profile warnings. Default: false.
typename
String
Read-only. The class name of the referenced
BatchOptions object.
UnixCompatible
Boolean
Read-write. Indicates whether to make the final
file name Unix® compatible. Default: true.
Note: Valid only when Destination = 3
(psFolder). See Destination.
WindowsCompatible
Boolean
Read-write. Indicates whether to make the final
file names Windows compatible. Default: true.
Note: Valid only when Destination = 3
(psFolder). See Destination.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
38
BitmapConversionOptions
Options to specify when converting an image to Bitmap mode.
Note: Convert color images to grayscale before converting the image to bitmap mode. See ‘Desaturate’
on page 30 (in the Properties table of the ArtLayer object).
Properties
Property
Value Type
What it is
Angle
Number (Double)
Read-write. The angle (in degrees) at which to
orient individual dots (-180 - 180). See Shape.
Note: Valid only when Method = 4. See Method.
Application
Object (Application)
Read-only. The application that the object
belongs to.
Frequency
Number (Double)
Read-write. The number of printer dots (per
inch) to use (1.0 - 999.99).
Note: Valid only when Method = 4. See Method.
Method
PsBitmapConversionType Read-write. The conversion method to use.
Default: 3.
PatternName
String
Read-write. The name of the pattern to use.
Note: Valid only when Method = 5. See Method.
Resolution
Number (Double)
Read-write. The output resolution in pixels per
inch. Default: 72.0.
Shape
PsBitmapHalfToneType
Read-write. The dot shape to use.
Note: Valid only when Method = 1. See Method.
typename
String
Read-only. The class name of the referenced
BitmapConversionOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
BMPSaveOptions
Options that can be specified when saving a document in BMP format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save the
alpha channels.
Application
Object
(Application)
Read-only. The application that the object
belongs to.
Depth
PsBMPDepthType
Read-write. The number of bits per channel.
FlipRowOrder
Boolean
Read-write. Indicates whether to write the
image from top to bottom. Default: false.
Note: Available only when OSType = 2.
See OSType.
OSType
PsOperatingSystem
Read-write. The target OS. Default: 2.
RLECompression
Boolean
Read-write. Indicates whether to use RLE
compression.
Note: Available only when OSType = 2.
See OSType.
typename
String
Read-only. The class name of the referenced
BMPSaveOptions object.
39
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
40
CameraRAWOpenOptions
Options that can be specified when opening a document in Camera Raw format.
Properties
Property
Value type
What it is
Application
Object (Application)
Read-only. The application that the object
belongs to.
BitsPerChannel
PsBitsPerChannelType
Read-write. The number of bits per channel.
BlueHue
Number (Long)
Read-write. The blue hue of the shot (-100 100).
BlueSaturation
Number (Long)
Read-write. The blue saturation of the shot
(-100 - 100).
Brightness
Number (Long)
Read-write. The brightness of the shot (0 150).
ChromaticAberrationBY
Number (Long)
Read-write. The chromatic aberration B/Y of
the shot (-100 - 100).
ChromaticAberrationRC
Number (Long)
Read-write. The chromatic aberration R/C of
the shot (-100 - 100).
ColorNoiseReduction
Number (Long)
Read-write. The color noise reduction of the
shot (0 - 100).
ColorSpace
PsColorSpaceType
Read-write. The colorspace for the image.
Contrast
Number (Long)
Read-write. The contrast of the shot (-50 100).
Exposure
Number (Double)
Read-write. The exposure of the shot (4.0 4.0).
GreenHue
Number (Long)
Read-write. The green hue of the shot (-100 100).
GreenSaturation
Number (Long)
Read-write. The green saturation of the shot
(-100 - 100).
LuminanceSmoothing
Number (Long)
Read-write. The luminance smoothing of the
shot (0 - 100).
RedHue
Number (Long)
Read-write. The red hue of the shot (-100 100).
RedSaturation
Number (Long)
Read-write. The red saturation of the shot
(-100 - 100).
Resolution
Number (Double)
Read-write. The resolution of the document
in pixels per inch (1 - 999).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
41
Property
Value type
What it is (Continued)
Saturation
Number (Long)
Read-write. The saturation of the shot (-100 100).
Settings
PsCameraRAWSettingsType Read-write. The global settings for all Camera
RAW options. Default: 0
(psCameraDefault).
Shadows
Number (Long)
Read-write. The shadows of the shot (0 - 100).
ShadowTint
Number (Long)
Read-write. The shadow tint of the shot (-100
- 100).
Sharpness
Number (Long)
Read-write. The sharpness of the shot (0 100).
Size
PsCameraRAWSize
Read-write. The size of the new document.
Temperature
Number (Long)
Read-write. The temperature of the shot
(2000 - 50000).
Tint
Number (Long)
Read-write. The tint of the shot (-150 - 150).
typename
String
Read-only. The class name of the referenced
CameraRAWOpenOptions object.
VignettingAmount
Number (Long)
Read-write. The vignetting amount of the
shot (-100 - 100).
VignettingMidpoint
Number (Long)
Read-write. The vignetting mid point of the
shot (-100 - 100).
WhiteBalance
PsWhiteBalanceType
Read-write. The white balance options for the
image.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
42
Channel
Object that stores information about a color element in the image, analogous to a plate in the printing
process that applies a single color. The document’s color mode determines the number of default
channels; for example, an RGB document has four default channels:
●
A composite channel: RGB
●
Three component channels: red, green, blue
A channel can also be an alpha channel, which stores selections as masks, or a spot channel, which stores
spot colors.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Color
Object
(SolidColor)
Read-write. The color of the channel.
Note: Not valid when Type = 1.
Histogram
Array of 256
Numbers (Long)
Read-only. A histogram of the color of the channel.
Note: Not valid when Type = 1. For component channel
histogram values, use the Histogram property of
the Document object instead. See Histogram.
Kind
PsChannelType
Read-write. The channel type.
Name
String
Read-write. The channel's name.
Opacity
Number (Double)
Read-write. The opacity to use for alpha channels or the
solidity to use for spot channels (0 - 100).
Note: Valid only when Type = 2 or Type = 3.
Parent
Object (Document)
Read-only. The object's container.
typename
String
Read-only. The class name of the referenced Channel
object.
Visible
Boolean
Read-write. Indicates whether the channel is visible.
Methods
Method
Parameter Type
Returns
What it does
Deletes the channel.
Delete
()
Channel
Duplicate
([TargetDocument])
Merge
()
Duplicates the channel.
Document
Merges a spot channel into the
component channels.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
43
Channels
The collection of Channel objects in the document. See ‘Channel’ on page 42.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs
to.
Count
Number (Long)
Read-only. The number of elements in the Channels
collection.
Parent
Object (Document) Read-only. The object’s container.
typename
String
Read-only. The class name of the referenced Channels
object.
Parameter Type
Returns
What it does
Channel
Creates a new Channel object.
Number (Long)
Gets the index of the specified
Channel object.
Channel
Gets an element from the Channels
collection.
Methods
Method
Add
()
Index
(ItemPtr)
Object (Channel)
Item
(ItemKey)
Number(Long)
RemoveAll
()
Removes all Channel objects from
the Channels collection.
Sample Script
The following script checks for any open documents (files); if no documents are open, it opens fish.psd in
the Samples folder.
The script then creates the histogram for each channel in the document and creates a log file named
Histogram.log on your Desktop. The file maps out the histogram for each channel and includes the
following information:
●
Total pixel count
●
Mean pixel count per row
●
Standard deviation of pixels per row
●
Median pixels per row
●
Pixel count row by row, represented in rows of Xs, produces a strobe effect, as a progression of dialogs
display.
Histogram.vbs
Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, docRef
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Dim totalCount, channelIndex, activeChannels, myChannels, secondaryIndex
Dim largestCount, histogramIndex, pixelsPerX, outputX, a, visibleChannelCount
Dim aChannelArray(), aChannelIndex, oFileSys, fileOut, hist, objWshShell
Set appRef = CreateObject("Photoshop.Application")
' Save the current preferences
startRulerUnits = appRef.Preferences.RulerUnits
startTypeUnits = appRef.Preferences.TypeUnits
startDisplayDialogs = appRef.DisplayDialogs
' Set Photoshop CS4 to use pixels and display no dialogs
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels)
appRef.Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels)
appRef.DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs)
' if there are no documents open then try to open a sample file
If appRef.Documents.Count = 0 Then
appRef.Open(appRef.Path + "/Samples/Fish.psd")
End If
Set docRef = appRef.ActiveDocument
' Get a shell object so we can point to the desktop
Set objWshShell = WScript.CreateObject("Wscript.Shell")
' create the output file
Set oFileSys = CreateObject("Scripting.FileSystemObject")
Set fileOut = oFileSys.CreateTextFile(objWshShell.SpecialFolders("Desktop") & _
"\Histogram.log")
' write out a header
fileOut.Write "Histogram report for " & docRef.Name
' find out how many pixels I have
totalCount = docRef.Width * docRef.Height
' more info to the out file
fileOut.WriteLine " with a total pixel count of " & totalCount
' remember which channels are currently active
activeChannels = appRef.ActiveDocument.ActiveChannels
' document histogram only works in these modes
If docRef.Mode = 2 Or docRef.Mode = 3 Or docRef.Mode = 6 Then
'enumerated values = PsDocumentMode --> 2 (psRGB), 3 (psCMYK), 6 (psIndexedColor)
' activate the main channels so we can get the document’s histogram
' using the TurnOnDocumentHistogramChannels function
Call TurnOnDocumentHistogramChannels(docRef)
' Output the documents histogram
Call OutputHistogram(docRef.Histogram, "Luminosity", fileOut)
End If
' local reference to work from
Set myChannels = docRef.Channels
' loop through each channel and output the histogram
For channelIndex = 1 To myChannels.Count
44
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
' the channel has to be visible to get a histogram
myChannels(channelIndex).Visible = true
' turn off all the other channels
for secondaryIndex = 1 to myChannels.Count
If Not channelIndex = secondaryIndex Then
myChannels(secondaryIndex).Visible = false
End If
Next
' Use the function to dump the histogram
Call OutputHistogram(myChannels(channelIndex).Histogram, _
myChannels(channelIndex).Name, fileOut)
Next
' close down the output file
fileOut.Close
WScript.Echo "Histogram File saved in: " & _
objWshShell.SpecialFolders("Desktop") & "\Histogram.log"
' reset the active channels
docRef.ActiveChannels = activeChannels
' Reset the application preferences
appRef.Preferences.RulerUnits = startRulerUnits
appRef.Preferences.TypeUnits = startTypeUnits
appRef.DisplayDialogs = startDisplayDialogs
' Utility function that takes a histogram and name
' and dumps to the output file
Private Function OutputHistogram (inHistogram, inHistogramName, inOutFile)
' find out which count has the largest number
' I scale everything to this number for the output
largestCount = 0
' a simple indexer I can reuse
histogramIndex = 0
' search through all and find the largest single item
For Each hist In inHistogram
histogramCount = histogramCount + CLng(hist)
If CLng(hist) > largestCount Then
largestCount = CLng(hist)
End If
Next
'These should match
If Not histogramCount = totalCount Then
MsgBox "Something bad is happening!"
End If
inOutFile.WriteLine "This histogram has a pixel count of " & histogramCount
inOutFile.WriteLine
'see how much each "X" is going to count as
pixelsPerX = largestCount / 100
'output this data to the file
45
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
inOutFile.WriteLine "One X = " & pixelsPerX & " pixels."
'output the name of this histogram
inOutFile.WriteLine inHistogramName
inOutFile.WriteLine "Mean Pixels: " & AverageHistogram(inHistogram)
inOutFile.WriteLine "Mean Pixels: " & AverageHistogram(inHistogram)
inOutFile.WriteLine "Std. Dev. Pixels: " & _
StandardDeviationHistogram(inHistogram)
inOutFile.WriteLine "Median Pixels: " & _
MedianHistogram(inHistogram, histogramCount)
' loop through all the items and output in the following format
' 001
' 002
' For histogramIndex = 0 To (inHistogram.Count - 1)
histogramIndex = 0
For Each hist in inHistogram
' I need an extra "0" for this line item to keep everything in line
If histogramIndex < 10 Then
inOutFile.Write "0"
End If
' I need an extra "0" for this line item to keep everything in line
If histogramIndex < 100 Then
inOutFile.Write "0"
End If
' output the index to file
inOutFile.Write histogramIndex
' some spacing to make it look nice
inOutFile.Write " "
'figure out how many X’s I need
outputX = CDbl(hist) / largestCount * 100
'output the X’s
For a = 0 to outputX ' (outputX - 1)
inOutFile.Write "X"
Next
inOutFile.WriteLine
histogramIndex = histogramIndex + 1
Next
inOutFile.WriteLine
End Function
' Function to active all the channels according to the document’s mode
' Takes a document reference for input
Private Function TurnOnDocumentHistogramChannels (inDocument)
' see how many channels we need to activate
visibleChannelCount = 0
'based on the mode of the document
Select Case inDocument.Mode
46
Adobe Photoshop CS4
VBScript Scripting Reference
Case 1
visibleChannelCount
Case 5
visibleChannelCount
Case 6
visibleChannelCount
Case 8
visibleChannelCount
Case 2
visibleChannelCount
Case 4
visibleChannelCount
Case 3
visibleChannelCount
Case 8
visibleChannelCount
Case 7
visibleChannelCount
Case Else
visibleChannelCount
End Select
VBScript Interface
= 1
= 1
= 1
= 2
= 3
= 3
= 4
= 4
= (inDocument.Channels.Count + 1)
= (inDocument.Channels.Count + 1)
' now get the channels to activate into a local array
ReDim aChannelArray(visibleChannelCount)
' index for the active channels array
aChannelIndex = 1
For channelIndex = 1 to inDocument.channels.Count
If channelIndex <= visibleChannelCount Then
Set aChannelArray(aChannelIndex) = inDocument.Channels(channelIndex)
aChannelIndex = aChannelIndex + 1
End If
Next
End Function
Private Function StandardDeviationHistogram(inputArray)
Dim numPixels, sum1, sum2, x, gray
numPixels = 0
sum1 = 0.0
sum2 = 0.0
' Compute totals for the various statistics
For gray = 0 To 255
x = inputArray(gray)
numPixels = numPixels + x
sum1 = sum1 + x * gray
sum2 = sum2 + x * (gray * gray)
Next
StandardDeviationHistogram = _
Sqr((sum2 - (sum1 * sum1) / numPixels) / (numPixels - 1))
End Function
Private Function AverageHistogram(inputArray)
Dim numPixels, sum1, sum2, x, gray
47
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
numPixels = 0
sum1 = 0.0
sum2 = 0.0
' Compute totals for the various statistics
For gray = 0 To 255
x = inputArray(gray)
numPixels = numPixels + x
sum1 = sum1 + x * gray
sum2 = sum2 + x * (gray * gray)
Next
AverageHistogram =
sum1 / numPixels
End Function
Private Function MedianHistogram(inputArray, numPixels)
Dim gray, total, mid
gray = 0
total = inputArray(0)
mid = (numPixels + 1) / 2
Do While (total < mid)
gray = gray + 1
total = total + inputArray(gray)
Loop
MedianHistogram = gray
End Function
48
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
49
CMYKColor
The definition of a CMYK color.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Black
Number (Double) Read-write. The black color value (as percent) (0.0 - 100.0).
Cyan
Number (Double) Read-write. The cyan color value (as percent) (0.0 - 100.0).
Magenta
Number (Double) Read-write. The magenta color value (as percent)
(0.0 - 100.0).
Read-only. The class name of the referenced CMYKColor object.
typename
String
Yellow
Number (Double) Read-write. The yellow color value (as percent)
(0.0 - 100.0).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
50
ColorSampler
A color sampler for the document.
Note: For additional information about color samplers, see Adobe Photoshop CS4 help on the Color
SamplerTool.
Properties
Property
Value type
What it is
Color
SolidColor
Read-only. The color of the color sampler.
Position
Array of Number
(Double)
Read-only. The position of the color sampler in the
document.
Parent
object
(Document)
Read-only. The ColorSampler object’s container.
typename
String
Read-only. The class name of the referenced ColorSampler
object.
Parameter type
Returns
Methods
Method
Move
(position)
Array of Number
(Double)
What it does
Moves the color sampler to a new location
in the document.
The position parameter (x,y) represents
the new horizontal and vertical locations,
respectively, of the moved color sampler.
Delete
()
Deletes the ColorSampler object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
51
ColorSamplers
The collection of ColorSampler objects in the document. See ColorSampler.
Properties
Property
Value Type
What it is
Length
number (Long)
Read-only. The number of elements in the
ColorSamplers collection.
Parent
object (Document) Read-only. The ColorSamplers object’s container.
typename
string
Read-only. The class name of the referenced
ColorSamplers object.
Parameter Type
Returns
What it does
ColorSampler
Creates a new ColorSampler object.
Methods
Method
Add
(position)
Index
(ItemPtr)
Array of Number
(Double)
object
(ColorSampler)
Item
(ItemKey)
RemoveAll
()
number
The position parameter (x,y)
represents the horizontal and vertical
locations, respectively, of the new
color sampler.
Number (Long)
Gets the index of the ColorSampler
into the collection.
ColorSampler
Gets an element from the
ColorSamplers collection.
Removes all ColorSampler objects
from the ColorSamplers collection.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
52
ContactSheetOptions
Options that can be specified for a contact sheet.
Properties
Property
Value Type
What it is
AcrossFirst
Boolean
Read-write. Indicates whether to place the images
horizontally (left to right, then top to bottom) first.
Default: true.
Application
Object
(Application)
Read-only. The application that the object belongs
to.
BestFit
Boolean
Read-write. Indicates whether to rotate images for
the best fit. Default: false.
Caption
Boolean
Read-write. Indicates whether to use the filename as
a caption for the image. Default: true.
ColumnCount
Number (Long)
Read-write. The number of columns to include
(1 - 100; default: 5).
Flatten
Boolean
Read-write. Indicates whether to flatten all layers in
the final document. Default: true.
Font
PsGalleryFontType
Read-write. The font used for the caption. Default: 1.
FontSize
Number (Long)
Read-write. The font size to use for the caption.
Default: 12.
Height
Number (Long)
Read-write. The height (in pixels) of the resulting
document (100 - 2900; default: 720).
Horizontal
Number (Long)
Read-write. The horizontal spacing (in pixels)
between images (0 - 29000; default: 1).
Mode
PsNewDocumentMode
Read-write. The document color mode. Default: 2
(psNewRGB).
Resolution
Number (Double)
Read-write. The resolution of the document in pixels
per inch (35 - 1200; default: 72.0).
RowCount
Number (Long)
Read-write. The number of rows to use (1 - 100;
default: 6).
typename
String
Read-only. The class name of the referenced
ContactSheetOptions object.
UseAutoSpacing
Boolean
Read-write. Indicates whether to auto space the
images. Default: true.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
53
Property
Value Type
What it is (Continued)
Vertical
Number (Long)
Read-write. The vertical spacing (in pixels) between
images (0 - 29000; default: 1).
Note: Valid only when UseAutoSpacing = false.
Width
Number (Long)
Read-write. The width (in pixels) of the resulting
document (100 - 2900; default: 576).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
54
CountItem
A counted item in the document. Also see the method AutoCount, defined on Document.
Note: CountItem is available in the Extended Version only.
For additional information about count items, see Adobe Photoshop CS4 help on the Count Tool.
Properties
Property
Value type
What it is
Position
Array of Number
(Double)
Read-only. The position of the count item in the document.
The array (x,y) represents the horizontal and vertical location
of the count item.
Parent
object
(Document)
Read-only. The CountItem object’s container.
typename
string
Read-only. The class name of the referenced CountItem
object.
Parameter type
Returns
Methods
Method
Delete
()
What it does
Deletes the CountItem object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
55
CountItems
The collection of CountItems objects in the document. See CountItem.
Note: CountItems is available in the Extended Version only.
Properties
Property
Value Type
What it is
Length
Number (Long)
Read-only. The number of elements in the CountItems
collection.
Parent
object (Document) Read-only. The CountItems object’s container.
typename
String
Read-only. The class name of the referenced CountItems
object.
Parameter Type
Returns
What it does
CountItem
Creates a new CountItem object.
Methods
Method
Add
(position)
Index
Array of Number
(Double)
Parameter position (x,y)
represents the horizontal and vertical
positions, respectively, of the new
CountItem object.
object(CountItem)
Number (Long)
Gets the index of the CountItem into
the collection.
Number (Long)
Document
Gets an element from the CountItem
collection.
(ItemPtr)
Item
(ItemKey)
RemoveAll
()
Removes all CountItem objects from
the CountItem collection.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
56
DCS1_SaveOptions
Options that can be specified when saving a CMYK document in DCS1 format.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
DCS
PsDCSType
Read-write. Default: 3.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the color profile
in the document
Encoding
PsSaveEncoding Read-write. The type of encoding to use for document.
Default: 1.
HalftoneScreen
Boolean
Read-write. Indicates whether to include halftone screen.
Default: false.
Interpolation
Boolean
Read-write. Indicates whether to use image interpolation.
Default: false)
Preview
PsPreviewType
Read-write. The type of preview. Default: 3.
TransferFunction
Boolean
Read-write. Indicates whether to include the Transfer
functions to compensate for dot gain between the image
and film. Default: false.
typename
String
Read-only. The class name of the referenced
DCS1_SaveOptions object.
VectorData
Boolean
Read-write. Indicates whether to include vector data.
Note: Valid only if the document includes vector data
(un-rasterized text).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
57
DCS2_SaveOptions
Options that can be specified when saving a CMYK document in DCS2 format.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs
to.
DCS
PsDCSType
Read-write. The type of composite file to create.
Default: 1.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the color
profile in the document.
Encoding
PsSaveEncoding
Read-write. The type of encoding to use. Default: 1.
HalftoneScreen
Boolean
Read-write. Indicates whether to include the halftone
screen. Default: false.
Interpolation
Boolean
Read-write. Indicates whether to use image
interpolation. Default: false.
MultiFileDCS
Boolean
Read-write. Indicates whether to save color channels
as multiple files or a single file. Default: false.
Preview
PsPreviewType
Read-write. The preview type. Default: 3.
SpotColors
Boolean
Read-write. Indicates whether to save spot colors.
TransferFunction
Boolean
Read-write. Indicates whether to include the Transfer
functions to compensate for dot gain between the
image and film. Default: false.
typename
String
Read-only. The class name of the referenced
DCS2_SaveOptions object.
VectorData
Boolean
Read-write. Indicates whether to include vector data.
Note: Valid only if the document includes vector
data (un-rasterized text).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
58
DICOMOpenOptions
Options that can be specified when opening a DICOM format document.
Note: DICOMOpenOptions is available in the Extended Version only.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object
belongs to.
Anonymize
Boolean
Read-write. Indicates whether to make the
patient information anonymous.
Columns
Number (Long)
Read-write. Number of columns in n-up
configuration.
Reverse
Boolean
Read-write. Indicates whether to reverse
(invert) the image.
Rows
Number (Long)
Read-write. The number of rows in n-up
configuration.
ShowOverlays
Boolean
Read-write. Indicates whether to show overlays.
typename
String
Read-only. The class name of the referenced
DICOMOpenOptions object.
WindowLevel
Number (Long)
Read-write. The contrast of the image in
Houndsfield units.
WindowWidth
Number (Long)
Read-write. The brightness of the image in
Houndsfield units.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
59
Document
The active containment object for layers and all most objects in the script; the basic canvas for the file.
Note: In Adobe Photoshop CS4, a document can also be referred to as an image or a canvas.
●
The term image refers to the entire document and its contents. You can trim or crop an image.
You resize an image using the ResizeImage() method.
●
The term canvas refers to the space in which the document sits on the screen. You can rotate or
flip the canvas. You resize the canvas using the ResizeCanvas() method.
Properties
Property
Value Type
What it is
ActiveChannels
Array (Channel
objects)
Read-write. The selected channels.
(HistoryState)
Read-write. The history state to use with the
history brush.
ActiveHistoryState
Object
(HistoryState)
Read-write. The selected HistoryState
object.
ActiveLayer
Object (ArtLayer or
LayerSet)
Read-write. The selected layer.
Application
Object (Application) Read-only. The application that the object
ActiveHistoryBrushSource Object
belongs to.
ArtLayers
Object (ArtLayers)
Read-only. The ArtLayers collection.
BackgroundLayer
Object (ArtLayer)
Read-only. The background layer of the
document.
BitsPerChannel
PsBitsPerChannelType Read-write. The number of bits per channel.
Channels
Object (Channels)
Read-only. The Channels collection.
ColorProfileName
String
Read-write. The name of the color profile.
Note: Valid only when
ColorProfileType = 3 or
ColorProfileType = 2. See
ColorProfileType.
ColorProfileType
PsColorProfileType
Read-write. The type of color model that
defines the document’s working space.
ColorSamplers
ColorSamplers
Read-only. The current color samplers
associated with this document.
ComponentChannels
Array (Channel
objects)
Read-only. A list of the component color
channels.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Property
Value Type
What it is (Continued)
CountItems
CountItems
Read-only. The current count items.
60
Note: For additional information about count
items, see Adobe Photoshop CS4 help
on the Coun Tool.
FullName
String
Read-only. The full path name of the
document.
Height
Number (Double)
Read-only. The height of the document (unit
value).
Histogram
Array of 256
Numbers (Long)
Read-only. A histogram showing the number
of pixels at each color intensity level for the
composite channel.
Note: Valid only when Mode = 2; Mode = 3; or
Mode = 6. See Mode.
Read-only. The HistoryStates collection.
HistoryStates
Object
(HistoryStates)
Info
Object
(DocumentInfo)
Read-only. Metadata about the document.
LayerComps
Object (LayerComps)
Read-only. The LayerComps collection.
Layers
Object (Layers)
Read-only. The Layers collection.
LayerSets
Object (LayerSets)
Read-only. The LayerSets collection.
Managed
Boolean
Read-only. Indicates whether the document a
is workgroup document.
MeasurementScale
MeasurementScale
Read-only. The measurement scale for the
document.
Note: This feature is available in the Extended
Version only.
Mode
PsDocumentMode
Read-only. The color profile.
Name
String
Read-only. The document's name.
Parent
Object (Application) Read-only. The Document object's container.
Path
String
Read-only. The path to the document.
PathItems
Object (PathItems)
Read-only. The PathItems collection.
PixelAspectRatio
Number (Double)
Read-write. The (custom) pixel aspect ratio to
use (0.100 - 10.000).
QuickMaskMode
Boolean
Read-write. Indicates whether the document is
in Quick Mask mode.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
61
Property
Value Type
What it is (Continued)
Resolution
Number (Double)
Read-only. The document’s resolution (in
pixels per inch).
Saved
Boolean
Read-only. Indicates whether the document
has been saved since the last change.
Selection
Object (Selection)
Read-only. The selected area of the document.
typename
String
Read-only. The class name of the Document
object.
Width
Number (Double)
Read-only. The width of the document (unit
value).
XMPMetadata
Object (XMPMetadata) Read-only. XMP data for the image. Camera
Raw settings are contained here.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
62
Methods
Method
Parameter Type
AutoCount
(channel,
threshold)
Channel
Number (Long)
Returns
What it does
Counts the number of
objects in a document.
Creates a CountItem object
for each object counted.
Note: The AutoCount
feature is available
in the Extended
Version only.
For additional
information about
how to set up
objects to count,
please see the
Count Tool in the
Adobe Photoshop
CS4 Help
Changes the color profile.
ChangeMode
(DestinationMode
[, Options])
PsChangeMode
object
(BitmapConversionOptions
or
IndexedConversionOptions
)
Close
([Saving])
PsSaveOptions
Closes the document. If
any changes have been
made, the script presents
an alert with three options:
save, do not save, prompt
to save. The optional
parameter specifies a
selection in the alert box.
Default: 3
(psPromptToSaveChange
s).
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Returns
What it does (Continued)
Changes the color profile.
ConvertProfile
(DestinationProfile,
Intent
[, BlackPointCompensation]
[, Dither])
63
String
PsIntent
Boolean
Boolean
Note: The
DestinationProfi
le parameter must
be either a string
that names the
color mode or
Working RGB,
Working CMYK,
Working Gray, Lab
Color (meaning
one of the working
color spaces or Lab
color)
Crops the document. The
first parameter is an array
of four coordinates that
mark the portion
remaining after cropping,
in the following order: left,
top, right, bottom.
Crop
(Bounds
[, Angle]
[, Width]
[, Height])
Array(Double)
Number (Double)
Number (Double)
Number (Double)
Document
Duplicate
([Name ]
[, MergeLayersOnly]
)
string
boolean
Creates a duplicate of the
Document object.
The optional parameter
Name provides the name
for the duplicated
document.
The optional parameter
MergeLayersOnly
indicates whether to only
duplicate merged layers.
Exports the document.
ExportDocument
(ExportIn
[, ExportAs]
[, Options])
String
PsExportType
ExportOptionsIllustrator
or
ExportOptionsSaveForWeb
Note: The ExportIn
parameter
represents the path
to a file as String.
Flattens all layers.
Flatten
()
PsDirection
Flips the image within the
canvas in the specified
direction.
String
Imports annotations into
the document.
FlipCanvas
(Direction)
ImportAnnotations
(File)
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Returns
()
ArtLayer
Paste
Boolean
Pastes the contents of the
clipboard into the
document. If the optional
argument is set to true
and a selection is active,
the contents are pasted
into the selection.
Prints the document.
PrintOut
([PostScriptEncoding]
[, SourceSpace]
[, PrintSpace]
[, Intent]
[BlackPointCompensation])
What it does (Continued)
Flattens all visible layers in
the document.
MergeVisibleLayers
([IntoSelection])
64
PsPrintEncoding
PsSourceSpaceType
String
PsIntent
Boolean
Note: PrintSpace
specifies the color
space for the
printer. Valid values
are nothing (that is,
the same as the
source); or Working
RGB, Working CMYK,
Working Gray, Lab
Color (meaning
one of the working
color spaces or Lab
color); or a string
specifying a specific
colorspace. Default:
nothing).
Rasterizes all layers.
RasterizeAllLayers
()
RecordMeasurements
([Source]
[, DataPoints])
PsMeasurementSource
array of strings
ResizeCanvas
([Width]
[, Height]
[, Anchor])
Number (Double)
Number (Double)
PsAnchorPosition
ResizeImage
([Width]
[, Height]
[, Resolution]
[, ResampleMethod])
RevealAll
()
Number (Double)
Number (Double)
Number (Double)
PsResampleMethod
Record measurements of
document.
Changes the size of the
canvas to display more or
less of the image but does
not change the image size.
See ResizeImage.
Changes the size of the
image.
Expands the document to
show clipped sections.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Returns
What it does (Continued)
Rotates the canvas
(including the image) in
clockwise direction.
RotateCanvas
(Angle)
65
Number (Double)
Saves the document.
Save
()
Saves the document with
specified save options.
SaveAs
(SaveIn
[, Options]
[, AsCopy]
[, ExtensionType])
String
object (corresponding
SaveOptions object*)
Boolean
PsExtensionType
Note: The Options
parameter’s value
can be a value from
the
* Examples:
BMPSaveOptions
DCS2_SaveOptions
JPEGSaveOptions
TiffSaveOptions
etc.
PsSaveDocumentType
constant list, or any
of the
“SaveOptions”
objects in the
current chapter
such as
BMPSaveOptions,
EPSSaveOptions,
JPEGSaveOptions,
and so on.
Note: The SaveIn
parameter
represents the path
to the file to save in
as String.
Array (
Document
objects)
SplitChannels
()
Trap
(Width)
Number (Long)
Splits the document
channels into separate
images.
Applies trapping to a
CMYK document.
Note: Valid only when
Mode = 3. See
Mode.
Trim
([Type]
[, Top]
[, Left]
[, Bottom]
[, Right])
PsTrimType
Boolean
Boolean
Boolean
Boolean
Trims the transparent area
around the image on the
specified sides of the
canvas.
Note: Default is true for
all Boolean values.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
66
Sample Script
The following script creates a document that contains two images (a flower and a duck) obtained from the
Adobe Photoshop CS4 Samples folder and employs the following steps:
1. Determine which image is larger.
2. Resize the smaller image to match the larger image.
3. Create a merged document twice as high as either image in order to hold both images.
4. Select part of the document and paste the flower into the selection. T
5. Invert the selection and paste the duck into the lower part of the document.
6. Position the flower over the duck.
Document.vbs
Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, flowerDoc
Dim duckDoc, mergedDoc, selRegion
Set appRef = CreateObject("Photoshop.Application")
' Save the current preferences
startRulerUnits = appRef.Preferences.RulerUnits
startTypeUnits = appRef.Preferences.TypeUnits
startDisplayDialogs = appRef.DisplayDialogs
' Set Photoshop CS2 to use pixels and display no dialogs
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels)
appRef.Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels)
appRef.DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs)
' first close all the open documents
Do While appRef.Documents.Count
appRef.ActiveDocument.Close
Loop
' Open the flower and duck files from the samples folder
Set flowerDoc = appRef.Open(appRef.Path + "/Samples/sunflower.psd")
Set duckDoc = appRef.Open(appRef.Path + "/Samples/Ducky.tif")
' Find out which document is larger
' Resize the smaller document the to the larger document’s size
' The resize requires the document be the active/front document
If (flowerDoc.Width * flowerDoc.Height) > (duckDoc.Width * duckDoc.Height) Then
appRef.ActiveDocument = duckDoc
duckDoc.Resize flowerDoc.Width, flowerDoc.Height
Else
appRef.ActiveDocument = flowerDoc
flowerDoc.ResizeImage duckDoc.Width, duckDoc.Height
End If
' Create a new document twice as high as two files
Set mergedDoc = appRef.Documents.Add(duckDoc.Width, duckDoc.Height * 2, _
duckDoc.Resolution, "flowerOverDuck")
' Copy the flower to the top; make it the active document so we can manipulate it
appRef.ActiveDocument = flowerDoc
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
flowerDoc.ActiveLayer.Copy
'Paste the flower to the merged document, making the merged document active
appRef.ActiveDocument = mergedDoc
' Select a square area at the top of the new document
selRegion = Array(Array(0, 0), _
Array(mergedDoc.Width, 0), _
Array(mergedDoc.Width, mergedDoc.Height / 2), _
Array(0, mergedDoc.Height / 2), _
Array(0, 0))
' Create the selection
mergedDoc.Selection.Select(selRegion)
'Paste in the flower
mergedDoc.Paste
' do the same thing for the duck
appRef.ActiveDocument = duckDoc
duckDoc.ActiveLayer.Copy
appRef.ActiveDocument = mergedDoc
mergedDoc.Selection.Select(selRegion)
' Inverting the selection so the bottom of the document is now selected
mergedDoc.Selection.Invert
' Paste the duck
mergedDoc.Paste
' get rid of our originals without modifying them
duckDoc.Close( 2) 'for PsSaveOptions --> 2 (psDoNotSaveChanges)
flowerDoc.Close( 2)
' Reset the application preferences
appRef.Preferences.RulerUnits = startRulerUnits
appRef.Preferences.TypeUnits = startTypeUnits
appRef.DisplayDialogs = startDisplayDialogs
67
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
68
DocumentInfo
Metadata about a Document object. These values can be set by choosing File > File Info in the Adobe
Photoshop CS4 application.
Note: The DocumentInfo object corresponds to the Info property of the Application object. You use
the property name Info, rather thanthe object name, DocumentInfo, in a script, as in the following
sample, which sets the Author, Caption, and Copyrighted properties:
Dim docRef
docRef = Open(fileList[i])
' set the file info
docRef.Info.Author = "Mr. Adobe Programmer"
docRef.Info.Caption = "Adobe photo shoot"
docRef.Info.Copyrighted = 1
The following sample uses the DocumentInfo object incorrectly:
docRef.DocumentInfo.Author = "Mr. Adobe Programmer"
docRef.DocumentInfo.Caption = "Adobe photo shoot"
docRef.DocumentInfo.Copyrighted = 1
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the
object belongs to.
Author
String
authorPosition
String
Read-write.
Caption
String
Read-write.
CaptionWriter
String
Read-write.
Category
String
Read-write.
City
String
Read-write.
Copyrighted
PsCopyrightedType
Read-write. The copyrighted status.
CopyrightNotice
String
Read-write.
Country
String
Read-write.
CreationDate
String
Read-write.
Credit
String
Read-write.
EXIF
Array of Arrays:
Array(Array (tag, tag
data)), ...)
Read-only. Camera data that includes
camera settings used when the image
was taken. Sample array values are: tag =
“camera”; tag value = “Cannon”.
Headline
String
Read-write.
Instructions
String
Read-write.
Read-write.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Property
Value Type
What it is (Continued)
JobName
String
Read-write.
Keywords
Array (Strings)
Read-write. A list of keywords that can
identify the document or its contents.
OwnerUrl
String
Read-write.
Parent
Object (Document)
Read-only. The Info object's container.
ProvinceState
String
Read-write.
Source
String
Read-write.
SupplementalCategories
Array (Strings)
Read-write.
Title
String
Read-write.
TransmissionReference
String
Read-write.
typename
String
Read-only. The class name of the
referenced Info object.
Urgency
PsUrgency
Read-write.
Sample Script
The following script checks to see if any documents are open. If none are open, it opens the sample file
fish.psd.
The script then sets the following document info (metadata):
●
Author: Mr. Adobe programmer
●
Caption: Adobe Photo shoot
●
CaptionWriter: Mr. Adobe programmer
●
City: San Jose
●
CopyrightNotice: Copyright (c) Adobe Programmer Photography
●
Copyrighted status: Copyrighted Work
●
Country: USA
●
State: CA
Note: After the script finishes running, choose File > File Info to display the metadata set by the script.
DocumentInfo.vbs
Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, docRef
Set appRef = CreateObject("Photoshop.Application")
' Save the current preferences
startRulerUnits = appRef.Preferences.RulerUnits
startTypeUnits = appRef.Preferences.TypeUnits
startDisplayDialogs = appRef.DisplayDialogs
' Set Photoshop CS4 to use pixels and display no dialogs
69
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels)
appRef.Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels)
appRef.DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs)
' if there are no documents open then try to open a sample file
If appRef.Documents.Count = 0 Then
appRef.Open(appRef.Path + "/Samples/Fish.psd")
End If
Set docRef = appRef.ActiveDocument
' tag all of the documents with photo shoot information
docRef.Info.Author = "Mr. Adobe Programmer"
docRef.Info.Caption = "Adobe Photo shoot"
docRef.Info.captionWriter = "Mr. Adobe Programmer"
docRef.Info.city = "San Jose"
docRef.Info.CopyrightNotice = "Copyright (c) Adobe Programmer Photography"
docRef.Info.Copyrighted = 1 'for PsCopyrightedType --> 1 (psCopyrightedWork)
docRef.Info.country = "USA"
docRef.Info.provinceState = "CA"
' Reset the application preferences
appRef.DisplayDialogs = startDisplayDialogs
appRef.Preferences.RulerUnits = startRulerUnits
appRef.Preferences.TypeUnits = startTypeUnits
70
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
71
Documents
The collection of open Document objects.
Note: See ‘Document’ on page 59 for information on the Document object.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs
to.
Count
Number (Long)
Read-only. The number of elements in the Documents
collection.
Parent
Object
(Application)
Read-only. The Documents objects’ container.
typename
String
Read-only. The class name of the referenced Documents
object.
Methods
Method
Parameter Type
Add
([Width]
[, Height]
[, Resolution]
[, Name]
[, Mode]
[, InitialFill]
[,PixelAspectRatio]
[,BitsPerChannel]
[,ColorProfileName])
Index
(ItemKey)
What it does
Document
Adds a Document Object.
Number (Double)
Number (Double)
Number (Double)
String
PsNewDocumentMode
PsDocumentFill
Number (Double)
PsBitsPerChannelType
String
PixelAspectRatio: range from
0.100 - 10.00. Default 1.0 for a
square aspect ratio.
BitsPerChannelType has a default
value of 8 (psDocument8Bits).
object(Document)
Number
(Long)
Gets the index of the Document into
the collection.
Number (Long)
Document
Gets an element from the
Documents collection.
(ItemPtr)
Item
Returns
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
72
EPSOpenOptions
Options that can be specified when opening an EPS format document.
Properties
Property
Value Type
What it is
AntiAlias
Boolean
Read-write. Indicates whether to use antialias.
Application
Object
(Application)
Read-only. The application that the object
belongs to.
ConstrainProportions
Boolean
Read-write. Indicates whether to constrain the
proportions of the image.
Height
Number (Double)
Read-write. The height of the image (unit
value).
Mode
PsOpenDocumentMode
Read-write. The color profile to use as the
document mode.
Resolution
Number (Double)
Read-write. The resolution of the document in
pixels per inch.
typename
String
Read-only. The class name of the referenced
EPSOpenOptions object.
Width
Number (Double)
Read-write. The width of the image (unit value).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
73
EPSSaveOptions
Options that can be specified when saving a document in EPS format.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs
to.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the color
profile in this document.
Encoding
PsSaveEncoding
Read-write. The type of encoding to use. Default: 1.
HalftoneScreen
Boolean
Read-write. Indicates whether to include the halftone
screen. Default: false.
Interpolation
Boolean
Read-write. Indicates whether to use image
interpolation. Default: false.
Preview
PsPreviewType
Read-write. The preview type.
PsColorManagement
Boolean
Read-write. Indicates whether to use Postscript color
management. Default: false.
TransferFunction
Boolean
Read-write. Indicates whether to include the Transfer
functions to compensate for dot gain between the
image and film. Default: false.
TransparentWhites
Boolean
Read-write. Indicates whether to display white areas
as transparent.
Note: Valid only when Document.Mode = 5. See
‘Mode’ on page 60 (in the Properties table of
the Document object) or ‘ChangeMode’ on
page 62 (in the Methods table of the Document
object).
typename
String
Read-only. The class name of the referenced
EPSSaveOptions object.
VectorData
Boolean
Read-write. Indicates whether to include vector data.
Note: Valid only if the document includes vector
data (text).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
74
ExportOptionsIllustrator
Options that can be specified when exporting a PathItem object to an Adobe Illustrator® file.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the object
belongs to.
Path
PsIllustratorPathType
Read-write. The type of path to export.
Default: 1.
PathName
String
Read-write. The name of the path to export.
Note: Valid only when Path = 3. See Path.
typename
String
Read-only. The class name of the referenced
ExportOptionsIllustrator object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
75
ExportOptionsSaveForWeb
Options that can be specified when optimizing a document for the Web, or for devices.
Properties
Property
Value type
What it is
Application
Object (Application)
Read-only. The application that the object
belongs to.
Blur
Number (Double)
Read-write. Applies blur to the image to reduce
artifacts. Default: 0.0.
ColorReduction
PsColorReductionType
Read-write. The color reduction algorithm.
Default: 1 (psSelective).
Colors
Number (Long)
Read-write. The number of colors in the palette.
Default: 256.
Dither
PsDitherType
Read-write. The type of dither. Default: 2
(psDiffusion).
DitherAmount
Number (Long)
Read-write. The amount of dither. Default: 100.
Note: Valid only when Dither = 2. See Dither.
Format
PsSaveDocumentType
Read-write. The file format to use. Default: 3
(psCompuServeGIFSave).
IncludeProfile
Boolean
Read-write. Indicates whether to include the
document’s embedded color profile. Default:
false.
Interlaced
Boolean
Read-write. Indicates whether to download in
multiple passes; progressive. Default: false.
Lossy
Number (Long)
Read-write. The amount of lossiness allowed.
Default: 0.
MatteColor
RGBColor
Read-write. The colors to blend transparent
pixels against.
Optimized
Boolean
Read-write. Indicates whether to create smaller
but less compatible files. Default: true.
Note: Valid only when format = 6
(psJPEGSave). See Format.
PNG8
Boolean
Read-write. Indicates the number of bits; true =
8, false = 24. Default: true.
Note: Valid only when format = 13
(psPNGSave). See Format.
Quality
Number (Long)
Read-write. The quality of the produced image (0
- 100 as percentage; default: 60).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
76
Property
Value type
What it is (Continued)
Transparency
Boolean
Read-write. Indicates transparent areas of the
image should be included in the saved image.
Default: true.
TransparencyAmount
Number (Long)
Read-write. The amount of transparency dither.
Default: 100.
Note: Valid only if Transparency = true. See
Transparency.
TransparencyDither
PsDitherType
Read-write. The transparency dither algorithm.
Default: 1.
typename
String
Read-only. The class name of the referenced
ExportOptionsSaveForWeb object.
WebSnap
Number (Long)
Read-write. The tolerance amount within which
to snap close colors to Web palette colors.
Default: 0.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
77
GalleryBannerOptions
Options that define the BannerOptions property of the GalleryOptions object. See ‘GalleryOptions’ on
page 81.
Tip: You can preserve default values for many GalleryBannerOptions properties by setting the
GalleryOptions property PreserveAllMetadata to true or by choosing File > Automate > Web
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo
Gallery dialog.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the
collection belongs to.
ContactInfo
String
Read-write. The Web photo gallery
contact info.
Date
String
Read-write. The Web photo gallery date.
Default: current date.
Font
PsGalleryFontType
Read-write. The font setting for the
banner text. Default: 1.
FontSize
Number (Long)
Read-write. The font size for the banner
text (1 - 7; default: 3).
Photographer
String
Read-write. The Web photo gallery
photographer.
SiteName
String
Read-write. The Web photo gallery site
name. Default:
Adobe Web Photo Gallery.
typename
String
Read-only. The class name of the
referenced GalleryBannerOptions
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
78
GalleryCustomColorOptions
Options that define the customColorOptions property of the GalleryOptions object. See
‘GalleryOptions’ on page 81.
Tip: You can preserve default values for many GalleryCustomColorOptions properties by setting the
GalleryOptions property PreserveAllMetadata to true or by choosing File > Automate > Web
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo
Gallery dialog.
Properties
Property
Value Type
What it is
ActiveLinkColor
Object (RGBColor)
Read-write. The color to use to indicate
an active link.
Application
Object (Application)
Read-only. The application that the
collection belongs to.
BackgroundColor
Object (RGBColor)
Read-write. The background color.
BannerColor
Object (RGBColor)
Read-write. The banner color.
LinkColor
Object (RGBColor)
Read-write. The color to use to indicate a
link.
TextColor
Object (RGBColor)
Read-write. The text color.
typename
String
Read-only. The class name of the
referenced
GalleryCustomColorOptions object.
VisitedLinkColor
Object (RGBColor)
Read-write. The color to use to indicate a
visited link.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
79
GalleryImagesOptions
Options that define the ImagesOptions property of the GalleryOptions object. See ‘GalleryOptions’ on
page 81.
Tip: You can preserve default values for many GalleryImagesOptions properties by setting the
GalleryOptions property PreserveAllMetadata to true or by choosing File > Automate > Web
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo
Gallery dialog.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the
collection belongs to.
Border
Number (Long)
Read-write. The size (in pixels) of the border
that separates images (0 - 99; default: 0).
Caption
Boolean
Read-write. Indication of whether to
generate image captions. Default: false.
Dimension
Number (Long)
Read-write. The resized image dimensions
in pixels. Default: 350.
Note: Valid only when ResizeImages =
true. See ResizeImages.
Font
PsGalleryFontType
Read-write. The font to use for image
captions. Default: 1.
FontSize
Number (Long)
Read-write. The font size for image captions
(1 - 7; default: 3).
Note: Valid only when Caption = true.
See Caption.
ImageQuality
Number (Long)
Read-write. The quality setting for a JPEG
image (0 - 12; default: 5).
IncludeCopyright
Boolean
Read-write. Indication of whether to
include copyright information in captions.
Default: false.
Note: Valid only when Caption = true.
See Caption.
IncludeCredits
Boolean
Read-write. Indication of whether to
include the credits in image captions.
Default: false.
Note: Valid only when Caption = true.
See Caption.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Property
Value Type
What it is (Continued)
IncludeFilename
Boolean
Read-write. Indication of whether to
include the file name in image captions.
Default: true.
80
Note: Valid only when Caption = true.
See Caption.
IncludeTitle
Boolean
Read-write. Indication of whether to
include the title in image captions. Default:
false.
Note: Valid only when Caption = true.
See Caption.
NumericLinks
Boolean
Read-write. Indication of whether to add
numeric links. Default: true.
ResizeConstraint
PsGalleryConstrainType
Read-write. The image dimensions to
constrain in the gallery image. Default: 3.
Note: Valid only when ResizeImages =
true. See ResizeImages.
ResizeImages
Boolean
Read-write. Indication of whether to
automatically resize images for placement
on the gallery pages. Default: true.
typename
String
Read-only. The class name of the
referenced GalleryImagesOptions
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
81
GalleryOptions
Options that can be specified for a Web photo gallery.
Tip: You can preserve default values for many GalleryOptions properties by choosing File > Automate
> Web Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web
Photo Gallery dialog.
Properties
Property
Value Type
What it is
AddSizeAttributes
Boolean
Read-write. Indicates whether width
and height attributes for images will be
added. Default: true.
Application
Object (Application)
Read-only. The application that the
collection belongs to.
BannerOptions
Object (GalleryBannerOptions)
Read-write. The options related to
banner settings.
CustomColorOptions
Object
(GalleryCustomColorOptions)
Read-write. The options related to
custom color settings.
EmailAddress
String
Read-write. The email address to show
on the Web page.
ImagesOptions
Object (GalleryImagesOptions)
Read-write. The options related to
images settings.
IncludeSubFolders
Boolean
Read-write. Indication of whether to
include all files found in sub folders of
the input folder. Default: true.
LayoutStyle
String
Read-write. The style to use for laying
out the Web page. Default: Centered
Frame 1 - Basic.
PreserveAllMetadata Boolean
Read-write. Indicates whether to save
metadata. Default: false.
Read-write. The options related to
security settings.
SecurityOptions
Object (GallerySecurityOptions)
ThumbnailOptions
Object (GalleryThumbnailOptions) Read-write. The options related to
thumbnail image settings.
typename
String
Read-only. The class name of the
referenced GalleryOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
82
Property
Value Type
What it is (Continued)
UseShortExtension
Boolean
Read-write. Indicates whether the
short Web page extension .htm or
Number (Long) Web page extension
.html will be used. Default: true.
UseUTF8Encoding
Boolean
Read-write. Indicates whether the Web
page should use UTF-8 encoding.
Default: false.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
83
GallerySecurityOptions
Options that define the SecurityOptions property of the GalleryOptions object. See ‘GalleryOptions’
on page 81.
Tip: You can preserve default values for many GallerySecurityOptions properties by setting the
GalleryOptions property PreserveAllMetadata to true or by choosing File > Automate > Web
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo
Gallery dialog.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the
collection belongs to.
Content
PsGallerySecurityType
Read-write. The Web photo gallery
security content. Default: 1.
Font
PsGalleryFontType
Read-write. The Web photo gallery
security font. Default: 1.
FontSize
Number (Long)
Read-write. The Web photo gallery
security font size (1 - 72; default: 3).
Opacity
Number (Long)
Read-write. The Web page security
opacity as a percent. Default: 100.
Text
String
Read-write. The Web photo gallery
security custom text.
TextColor
Object (RGBColor)
Read-write. The Web page security text
color.
TextPosition
PsGallerySecurityTextPositionType
Read-write. The Web photo gallery
security text position. Default: 1.
TextRotate
PsGallerySecurityTextRotateType
Read-write. The Web photo gallery
security text orientation to use. Default: 1.
typename
String
Read-only. The class name of the
referenced GallerySecurityOptions
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
84
GalleryThumbnailOptions
Options that define the thumbnailOptions property of the GalleryOptions object. See ‘GalleryOptions’
on page 81.
Tip: You can preserve default values for many GalleryThumbnailOptions properties by setting the
GalleryOptions property PreserveAllMetadata to true or by choosing File > Automate > Web
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo
Gallery dialog.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the collection
belongs to.
Border
Number (Long)
Read-write. The amount of border pixels you
want around your thumbnail images (0 - 99;
default: 0).
Caption
Boolean
Read-write. Indicates whether there is a
caption. Default: false.
ColumnCount
Number (Long)
Read-write. The number of columns on the
page. Default: 5.
Dimension
Number (Long)
Read-write. The Web photo gallery thumbnail
dimension in pixels. Default: 75.
Font
PsGalleryFontType
Read-write. The Web photo gallery font.
Default: 1.
FontSize
Number (Long)
Read-write. The font size for thumbnail
images text (1 - 7; default: 3).
IncludeCopyright
Boolean
Read-write. Indication of whether to include
copyright information for thumbnails.
Default: false.
IncludeCredits
Boolean
Read-write. Indication of whether to include
credits for thumbnails. Default: false.
IncludeFilename
Boolean
Read-write. Indication of whether to include
file names for thumbnails. Default: false.
IncludeTitle
Boolean
Read-write. Indication of whether to include
titles for thumbnails. Default: false.
RowCount
Number (Long)
Read-write. The number of rows on the page.
Default: 3.
Size
PsGalleryThumbSizeType Read-write. The thumbnail image size.
Default: 2.
typename
String
Read-only. The class name of the referenced
GalleryThumbnailOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
85
GIFSaveOptions
Options that can be specified when saving a document in GIF format.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object
belongs to.
Colors
Number (Long)
Read-write. The number of palette colors.
Note: Valid only when Palette =
2
3
4
6
7
(psMacOSPalette);
(psWindowsPalette);
(psWebPalette); 5 (psUniform);
(psLocalPerceptual); or
(psLocalSelective).
See Palette.
Dither
PsDitherType
Read-write. The dither type.
DitherAmount
Number (Long)
Read-write. The amount of dither. (1 - 100;
default: 75).
Note: Valid only for when Dither = 2
(psDiffusion). See Dither.
Forced
PsForcedColors
Read-write. The type of colors to force into the
color Palette.
Interlaced
Boolean
Read-write. Indicates whether rows should be
interlaced. Default: false.
Matte
PsMatteType
Read-write. The color to use to fill antialiased
edges adjacent to transparent areas of the image.
Default: 4 (psWhiteMatte).
Note: When Transparency = false, the matte
color is applied to transparent areas. See
Transparency.
Palette
PsPaletteType
Read-write. The type of palette to use. Default: 7
(psLocalSelective).
PreserveExactColors
Boolean
Read-write. Indicates whether to protect colors in
the image that contain entries in the color table
from being dithered.
Note: Valid only when Dither = 2
(psDiffusion). See Dither.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
86
Property
Value Type
What it is (Continued)
Transparency
Boolean
Read-write. Indicates whether to preserve
transparent areas of the image during conversion
to GIF format.
typename
String
Read-only. The class name of the referenced
GIFSaveOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
87
GrayColor
Options for defining a gray color.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Gray
Number (Double)
Read-write. The gray value (0.0 - 100.0; default: 0.0).
typename
String
Read-only. The class name of the referenced
grayColor object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
88
HistoryState
A version of the document stored automatically (and added to the HistoryStates collection), which
preserves the document’s state, each time the document is saved.
Note: See “HistoryStates” on page 89‘ for information about the HistoryStates collection.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Name
String
Read-only. The HistoryState object's name.
Parent
Object (Document) Read-only. The HistoryState object's container.
Snapshot
Boolean
Read-only. Indicates whether the history state is a snapshot.
typename
String
Read-only. The class name of the referenced HistoryState
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
89
HistoryStates
The collection of HistoryState objects in the document.
Note: See ‘HistoryState’ on page 88 for more information on HistoryState objects.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the HistoryStates
collection.
Parent
Object (Document)
Read-only. The HistoryStates object's container.
typename
String
Read-only. The class name of the referenced
HistoryStates object.
Parameter Type
Returns
What it does
Number (Long)
Gets the index of the HistoryState
into the collection.
HistoryState
Gets an element from the
HistoryStates collection.
Methods
Method
Index
(ItemPtr)
Object
(HistoryState)
Item
(ItemKey)
Number (Long)
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
90
HSBColor
Options that can be specified for a color object using the HSB color model.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Brightness
Number (Double) Read-write. The brightness value (0.0 - 100.0).
Hue
Number (Double) Read-write. The hue value (0.0 - 100.0).
Saturation
Number (Double) Read-write. The saturation value (0.0 - 100.0).
typename
String
Read-only. The class name of the referenced HSBColor object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
91
IndexedConversionOptions
Options that can be specified when converting an RGB image to an indexed color model.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs
to.
Colors
Number (Long)
Read-write. The number of palette colors.
Note: Valid only when Palette =
2
3
4
5
6
7
8
(psMacOSPalette)
(psWindowsPalette)
(psWebPalette)
(psUniform)
(psLocalPerceptual)
(psLocalSelective)
(psLocalAdaptive)
See Palette.
Dither
PsDitherType
Read-write. The dither type.
DitherAmount
Number (Long)
Read-write. The amount of dither. (1 - 100).
Note: Valid only when Dither = 2
(psDiffusion).
Forced
PsForcedColors
Read-write. The type of colors to force into the
color palette.
Matte
PsMatteType
Read-write. Read-write. The color to use to fill
antialiased edges adjacent to transparent areas of
the image. Default: 4 (psWhiteMatte).
Note: When Transparency = false, the matte
color is applied to transparent areas. See
Transparency.
Palette
PsPaletteType
Read-write. The palette type. Default: 1
(psExact).
PreserveExactColors
Boolean
Read-write.Indicates whether to protect colors in
the image that contain entries in the color table
from being dithered.
Note: Valid only when Dither = 2.
(psDiffusion) See Dither.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
92
Property
Value Type
What it is (Continued)
Transparency
Boolean
Read-write. Indicates whether to preserve
transparent areas of the image during conversion
to GIF format.
typename
String
Read-only. The class name of the referenced
IndexedConversionOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
JPEGSaveOptions
Options that can be specified when saving a document in JPEG format.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the color
profile in the document.
FormatOptions
PsFormatOptionsType Read-write.The download format to use. Default: 1
(psStandardBaseline).
Matte
PsMatteType
Read-write. The color to use to fill antialiased edges
adjacent to transparent areas of the image. Default: 4
(psWhiteMatte).
Note: When Transparency = false, the matte color
is applied to transparent areas. See
Transparency.
Quality
Number (Long)
Read-write. The image quality setting to use (affects
file size and compression) (0 - 12; default: 3).
Scans
Number (Long)
Read-write. The number of scans to make to
incrementally display the image on the page
(3 - 5; default: 3).
Note: Valid only for when FormatOptions = 3
(psProgressive).
typename
String
Read-only. The class name of the referenced
JPEGSaveOptions object.
93
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
LabColor
Options that can be specified when defining a color object using the LAB color model.
Properties
Property
Value Type
What it is
A
Number (Double) Read-write. The a-value (-128.0 - 127.0).
Application
Object
(Application)
B
Number (Double) Read-write. The b-value (-128.0 - 127.0).
L
Number (Double) Read-write. The L-value (0.0 - 100.0).
typename
String
Read-only. The application that the object belongs to.
Read-only. The class name of the referenced LabColor
object.
94
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
95
LayerComp
A snapshot of a state of the layers in a document (can be used to view different page layouts or
compositions).
Properties
Property
Value Type
What it is
Appearance
Boolean
Read-write. Indicates whether to use
layer appearance (layer styles) settings.
Application
Object (Application)
Read-only. The application that the
object belongs to.
Comment
String
Read-write. A description of the layer
comp.
Name
String
Read-write. The name of the layer comp.
Parent
Object (Document)
Read-write. The LayerComp object's
container.
Position
Boolean
Read-write. Indicates whether to use
layer position.
Selected
Boolean
Read-only. Indicates whether the layer
comp is currently selected.
typename
String
Read-only. The class name of the
referenced LayerComp object.
Visibility
Boolean
Read-write. Indicates whether to use
layer visibility settings.
Methods
Method
Apply
Parameter Type
Returns
What it does
Applies the layer comp to the document.
()
Delete
Deletes the LayerComp object.
()
Recapture
()
ResetfromComp
()
Recaptures the current layer state(s) for
this layer comp.
Resets the layer comp state to the
document state.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
96
LayerComps
The collection of LayerComp objects in the document.
Note: See “LayerComp” on page 95 for information on LayerComp objects.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs
to.
Count
Number (Long)
Read-only. The number of elements in the LayerComps
collection.
Parent
Object (Document)
Read-only. The LayerComps object's container.
typename
String
Read-only. The class name of the referenced
LayerComps object.
Parameter Type
Returns
What it does
LayerComp
Adds a layer comp.
Number (Long)
Gets the index of the LayerComp into
the collection.
LayerComp
Gets an element from the
LayerComps collection.
Methods
Method
Add
(Name,
Comment,
Appearance,
Position,
Visibility)
String
String
Boolean
Boolean
Boolean
Index
(ItemPtr)
Object (LayerComp)
Item
(ItemKey)
RemoveAll
()
Number (Long)
Removes all LayerComp objects from
the LayerComps collection.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
97
Layers
The collection of layer objects, including ArtLayer and LayerSet objects, in the document.
Note: See “ArtLayer” on page 23 for information on ArtLayer objects. See “LayerSet” on page 98 for
information on LayerSet objects.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the Layers
collection.
Parent
Object (Document Read-only. The Layers object's container.
or LayerSet)
typename
String
Read-only. The class name of the referenced Layers object.
Method
Parameter Type
Returns
What it does
Index
Object
(ArtLayer or
LayerSet)
Number (Long)
Gets the index of the ArtLayer or
LayerSet into the collection.
Number (Long)
Object
(ArtLayer or
LayerSet)
Gets an element from the collection.
Methods
(ItemPtr)
Item
(ItemKey)
RemoveAll
()
Removes all layers from the collection.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
98
LayerSet
A group of layer objects, which can include ArtLayer objects and other (nested) LayerSet objects. A
single command or set of commands manipulates all layers in a LayerSet object.
Properties
Property
Value Type
What it is
AllLocked
Boolean
Read-write. Indicates whether the contents in the layers
contained in the LayerSet object are editable.
Application
Object
(Application)
Read-only. The application that the object belongs to.
ArtLayers
Object (ArtLayers) Read-only. The ArtLayers in this LayerSet.
BlendMode
PsBlendMode
Read-write. The blend mode to use for the layer set.
Bounds
Array(Double)
Read-only. The bounding rectangle of the layer set.
EnabledChannels
Array (Channel
objects)
Read-write. The channels enabled for the layer set; must be
a list of component channels.
Note: See Kind in the Properties table for the Channel
Object (‘Channel’ on page 42).
Read-only. The layers in this LayerSet object.
Layers
Object (Layers)
LayerSets
Object (LayerSets) Read-only. The top level LayerSets in this document.
LinkedLayers
Array (ArtLayer
and/or LayerSet)
Read-only. The layers linked to this LayerSet object.
Name
String
Read-write. The name of the LayerSet object.
Opacity
Number (Double)
Read-write. The master opacity of the LayerSet Object (0.0
- 100.0).
Parent
Object (Document
or LayerSet)
Read-only. The LayerSet object's container.
typename
String
Read-only. The class name of the referenced LayerSet
object.
Visible
Boolean
Read-write. Indicates whether the LayerSet object is
visible.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
99
Methods
Method
Parameter Type
Returns
What it does
Deletes the LayerSet object.
Delete
()
Duplicate
([RelativeObject]
[, InsertionLocation])
object (ArtLayer
or LayerSet)
PsElementPlacement
Object
(LayerSet)
Links the layer set with another
layer.
Link
(With)
Object (ArtLayer or
LayerSet)
ArtLayer
Merge
()
Object
(Application)
PsElementPlacement
Resize
([Horizontal]
[, Vertical]
[, Anchor])
Number (Double)
Number (Double)
PsAnchorPosition
Rotate
(Angle
[, Anchor])
Number (Double)
PsAnchorPosition
Translate
([DeltaX]
[, DeltaY])
Unlink
()
Merges the layerset; returns a
reference to the art layer
created by this method.
Moves the LayerSet object.
Move
(RelativeObject,
InsertionLocation)
Creates a duplicate of the
LayerSet object.
Number (Double)
Number (Double)
Resizes all layers in the layer set
to the specified dimensions (as
a percentage of its current size)
and places the layer set in the
specified position.
Rotates all layers in the layer
set around the specified
anchor point.
Moves the position relative to
its current position.
Unlinks the layer set.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
100
LayerSets
The collection of LayerSet objects in the document.
Note: See “LayerSet” on page 98 for information on LayerSet objects.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the LayerSets
collection.
Parent
Object (Document Read-only. The LayerSets object's container.
or LayerSet)
typename
String
Read-only. The class name of the referenced LayerSets
object.
Parameter Type
Returns
What it does
LayerSet
Creates a new LayerSet object.
Number (Long)
Gets the index of the LayerSet into the
collection.
LayerSet
Gets an element from the LayerSets
collection.
Methods
Method
Add
()
Index
(ItemPtr)
Object
(LayerSet)
Item
(ItemKey)
Number (Long)
RemoveAll
()
Removes the layer set, and any layers or
layer sets it contains, from the document.
Sample Script
The following script creates three layer sets, then nests a second layer set in each layer set, and then
creates a text layer in each nested set that displays the text “Layer in n Set Inside n Set”, where n represents
the ordinal number of the set (first, second, or third).
LayerSets.vbs
Dim appRef, docRef, myLayerSets(3,3),
textArray, i, myLayers(3)
Set appRef = CreateObject("Photoshop.Application")
'close all open documents
Do While appRef.Documents.Count
appRef.ActiveDocument.Close
Loop
' create a working document
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
101
Set docRef = appRef.Documents.Add
' Create an array to hold the text
textArray = Array("First", "Second", "Third")
'Create an indexer variable
i = 0
' Create three layer sets at the top level
for i = 0 to 2
Set myLayerSets(i,0) = docRef.LayerSets.Add
Next
' Rearrange the layer sets with the first one on top, second next, etc.
myLayerSets(1,0).moveAfter(myLayerSets(0,0))
myLayerSets(2,0).moveAfter(myLayerSets(1,0))
' Create a layer set inside each layer set
for i = 0 to 2
myLayerSets(i,0).Name = textArray(i) + " Set"
Set myLayerSets(i,1) = myLayerSets(i,0).LayerSets.Add
myLayerSets(i,1).Name = "Inside " + textArray(i) + " Set"
Next
' Create a text layer with a description inside each layer set
for i = 0 to 2
Set myLayers(i) = myLayerSets(i,1).ArtLayers.Add
myLayers(i).Kind = 2 ' PsLayerKind.psTextLayer
myLayers(i).textItem.Contents = "Layer in " & textArray(i) & " Set Inside " _
& textArray(i) & " Set"
myLayers(i).textItem.position = Array(appRef.ActiveDocument.Width * i * 0.33, _
appRef.ActiveDocument.Height * (i + 1) * 0.25)
myLayers(i).textItem.Size = 12
Next
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
102
MeasurementLog
The measurement log for the application. See MeasurementLog (in the Properties table for the Application
object.)
Note: The MeasurementLog feature is available in the Extended Version only.
Because the MeasurementLog class is a property of the Application object, you use the property
name, measurementLog, rather than the class name, MeasurementLog, in your code.
Methods
Method
Parameter type
String
PsMeasurementRange
array of strings
Delete a measurement.
DeleteMeasurements
([Range])
What it does
Export some measurement(s).
ExportMeasurements
([File]
[, Range])
[, DataPoints])
Returns
PsMeasurementRange
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
MeasurementScale
The measurement scale for the document. See MeasurementScale (in the Properties table for the
Document object.)
Note: The MeasurementScale feature is available in the Extended Version only.
Properties
Property
Value Type
What it is
PixelLength
number (Long)
Read-write. The length in pixels this scale equates to.
LogicalLength
number (Double)
Read-write. The logical length this scale equates to.
LogicalUnits
String
Read-write. The logical units for this scale.
103
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
NoColor
An object that represents a missing color.
Properties
Property
Value type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
typename
String
Read-only. The class name of the referenced noColor
object.
104
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
105
Notifier
An event-handler object that tells the script to execute specified code when a specified event occurs.
Properties
Property
Value type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Event
String
Read-only. The event ID in four characters or a unique String
that the notifier is associated with.
Note: For a list of four-character codes, see Appendix A:
Event ID Codes.
EventClass
String
Read-only. The class ID of the event associated with the
Notifier object, four characters or a unique string.
Note: When an event applies to multiple types of objects,
you use this propety to distinguish which object this
Notifier applies to. For example, the Make event
(“Mk “)applies to documents (“Dcmn”), channels
(“Chnl”) and other objects..
EventFile
File
Read-only. The path to the file to execute when the event
occurs/activates the notifier.
Parent
Object
(Application)
Read-only. The Notifier object’s container.
typename
String
Read-only. The class name of the referenced Notifier
object.
Parameter type
Returns
Methods
Method
Remove
What it does
Deletes the Notifier object.
()
Note: You can remove a Notifier object
from the Script Events Manager
drop-down list by deleting the file
named Script Events
Manager.xml from in the
Photoshop preferences folder. See
Adobe Photoshop CS4 help for
more information.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
106
Notifiers
The collection of Notifier objects in the document; the Notifiers property of the Application object.
Note: See ‘Notifier’ on page 105 for information on Notifier objects. See Notifiers (in the Properties table
of the Application object).
Properties
Property
Value type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the Notifiers
collection.
EventClass
String
Read-only. The class ID of the event.
Parent
Object
(Application)
Read-only. The Notifiers object’s container
typename
String
Read-only. The class name of the referenced Notifiers object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
107
Methods
Method
Parameter type
Add
(Event,
EventFile
[, EventClass])
Returns
What it does
Notifier
Creates a Notifier object.
String
String
String
Note: EventClass defines the class ID
of the event: four characters or a
unique string . For a list of
four-character codes, see
Appendix A: Event ID Codes.
Tip: Remember to omit the single
quotes when including a
four-character ID in your code.
Note: EventFile defines the script file
that executes when the event
occurs.
Note: An eventClass value
corresponds to the class of
object the event is applied to:
four characters or a unique
string.
When an event applies to
multiple types of objects, you
use the EventClass parameter
to distinguish which object this
Notifier applies to. For
example, the Make event (“Mk
“)applies to documents
(“Dcmn”), channels (“Chnl”)
and other objects.
Index
(ItemPtr)
Item
(ItemKey)
RemoveAll
()
Number (Long)
Gets the index of the Notifier into
the collection.
Notifier
Gets an element from the Notifiers
collection.
Object
(Notifier)
Number (Long)
Removes all Notifier objects from
the Notifiers collection.
Note: You can remove a notifier
object from the Script Events
Manager drop-down list by
deleting the file named Script
Events Manager.xml from in
the Photoshop preferences
folder. See Adobe Photoshop
CS4 help for more information.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
108
PathItem
A path or drawing object, such as the outline of a shape or a straight or curved line, which contains sub
paths that comprise its geometry.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs
to.
Kind
PsPathKind
Read-write. The PathItem object’s type.
Name
String
Read-write. The PathItem object’s name.
Parent
Object
(Document)
Read-only. The PathItem object's container.
SubPathItems
Object
Read-only. The sub path objects for this PathItem
(SubPathItems)
object.
typename
String
Read-only. The class name of the referenced
PathItem object.
Methods
Method
Parameter Type
()
Deselects this PathItem
object.
Deselect
()
Duplicate
String
FillPath
([FillColor]
[,
[,
[,
[,
[,
[,
Mode]
Opacity]
PreserveTransparency]
Feather]
WholePath]
AntiAlias])
MakeClippingPath
([Flatness])
What it does
Deletes this PathItem
object.
Delete
(Name)
Returns
Object (SolidColor,
ArtLayer, HistoryState);
or String
PsColorBlendMode
Number (Double)
Boolean
Number (Double)
Boolean
Boolean
Number (Double)
Duplicates this PathItem
object with the new name
specified in the argument.
Fills the area enclosed by
the path (Opacity: 0 - 100
as percent; Feather: 0.0 250.0 in pixels).
Makes this PathItem
object the clipping path
for this document; the
optional parameter tells
the PostScript printer how
to approximate curves in
the path (0.2 - 100).
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
MakeSelection
([Feather]
[, AntiAlias]
[, Operation])
Number (Double)
Boolean
PsSelectionType
Returns
109
What it does (Continued)
Makes a Selection
object, whose border is
the path, from this
PathItem Object
(Feather: 0.0 - 250.0 in
pixels).
Note: See ‘Selection’ on
page 135.
Makes this PathItem
object the active or
selected PathItem object.
Select
()
StrokePath
([Tool]
[, SimulatePressure])
PsToolType
Boolean
Strokes the path with the
specified information.
Sample Script
The following creates a path in three segments: two diagonal lines that form a V, and a curved line above
the V that makes it look like a 2D ice cream cone.
Paths.vbs
Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, docRef
Dim lineArray(1), lineArray2(1), lineArray3(2), lineSubPathArray(2), myPathItem
Set appRef = CreateObject("Photoshop.Application")
' Save the current preferences
startRulerUnits = appRef.Preferences.RulerUnits
startTypeUnits = appRef.Preferences.TypeUnits
startDisplayDialogs = appRef.DisplayDialogs
' Set Photoshop CS4 to use pixels and display no dialogs
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels)
appRef.Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels)
appRef.DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs)
' first close all the open documents
Do While appRef.Documents.Count
appRef.ActiveDocument.Close
Loop
' create a document to work with
Set docRef = appRef.Documents.Add(5000, 7000, 72, "Simple Line")
'line #1--it’s a straight line so the coordinates for anchor, left, and
'right for each point have the same coordinates
Set lineArray(0) = CreateObject("Photoshop.PathPointInfo")
lineArray(0).Kind = 2 ' for PsPointKind --> 2 (psCornerPoint)
lineArray(0).Anchor = Array(100, 100)
lineArray(0).LeftDirection = lineArray(0).Anchor
lineArray(0).RightDirection = lineArray(0).Anchor
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Set lineArray(1) = CreateObject("Photoshop.PathPointInfo")
lineArray(1).Kind = 2
lineArray(1).Anchor = Array(150, 200)
lineArray(1).LeftDirection = lineArray(1).Anchor
lineArray(1).RightDirection = lineArray(1).Anchor
Set lineSubPathArray(0) = CreateObject("Photoshop.SubPathInfo")
lineSubPathArray(0).operation = 2 'for PsShapeOperation --> 2 (psShapeXOR)
lineSubPathArray(0).Closed = false
lineSubPathArray(0).entireSubPath = lineArray
'line#2
Set lineArray2(0) = CreateObject("Photoshop.PathPointInfo")
lineArray2(0).Kind = 2
lineArray2(0).Anchor = Array(150, 200)
lineArray2(0).LeftDirection = lineArray2(0).Anchor
lineArray2(0).RightDirection = lineArray2(0).Anchor
Set lineArray2(1) = CreateObject("Photoshop.PathPointInfo")
lineArray2(1).Kind = 2
lineArray2(1).Anchor = Array(200, 100)
lineArray2(1).LeftDirection = lineArray2(1).Anchor
lineArray2(1).RightDirection = lineArray2(1).Anchor
Set lineSubPathArray(1) = CreateObject("Photoshop.SubPathInfo")
lineSubPathArray(1).operation = 2
lineSubPathArray(1).Closed = false
lineSubPathArray(1).entireSubPath = lineArray2
'draw the "ice cream" curve above the two lines already on the screen
'it’s a curved line, so there are 3 points, not 2 and the
'coordinates for the middle point (lineArray3(1)) are different.
'The left direction is positioned “above” the anchor on the screen.
'The right direction is positioned “below” the anchor
'You can change the coordinates for these points to see
'how the curve works...
Set lineArray3(0) = CreateObject("Photoshop.PathPointInfo")
lineArray3(0).Kind = 2
lineArray3(0).Anchor = Array(200, 100)
lineArray3(0).LeftDirection = lineArray3(0).Anchor
lineArray3(0).RightDirection = lineArray3(0).Anchor
Set lineArray3(1) = CreateObject("Photoshop.PathPointInfo")
lineArray3(1).Kind = 2
lineArray3(1).Anchor = Array(150, 50)
lineArray3(1).LeftDirection = Array(100, 50)
lineArray3(1).RightDirection = Array(200, 50)
Set lineArray3(2) = CreateObject("Photoshop.PathPointInfo")
lineArray3(2).Kind = 2
lineArray3(2).Anchor = Array(100, 100)
lineArray3(2).LeftDirection = lineArray3(2).Anchor
lineArray3(2).RightDirection = lineArray3(2).Anchor
Set lineSubPathArray(2) = CreateObject("Photoshop.SubPathInfo")
lineSubPathArray(2).operation = 2
lineSubPathArray(2).Closed = false
lineSubPathArray(2).entireSubPath = lineArray3
'create the path item
Set myPathItem = docRef.PathItems.Add("A Line", lineSubPathArray)
110
Adobe Photoshop CS4
VBScript Scripting Reference
' stroke it so we can see something
myPathItem.StrokePath(2) 'for PsToolType --> 2 (psBrush)
' Reset the application preferences
appRef.Preferences.RulerUnits = startRulerUnits
appRef.Preferences.TypeUnits = startTypeUnits
appRef.DisplayDialogs = startDisplayDialogs
VBScript Interface
111
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
112
PathItems
The collection of PathItem objects in the document.
Note: See ‘PathItem’ on page 108 for information on PathItem objects.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of PathItem objects in the
PathItems collection.
Parent
Object
(Document)
Read-only. The PathItems object's container.
typename
String
Read-only. The class name of the referenced PathItems
object.
Methods
Method
Parameter Type
Returns
What it does
PathItem Creates a new PathItem object from the
Add
String
(Name,
EntirePath) Array (SubPathInfo
objects)
sub paths defined in the array provided in
the EntirePath parameter.
A new SubPathItem object is created for
each SubPathInfo object provided in
entirePath, and those SubPathItem
objects are added to the SubPathItems
collection of the returned PathItem.
(ItemPtr)
Number
(Long)
Number (Long)
PathItem Gets a PathItem object from the
PathItems collection.
Item
(ItemKey)
RemoveAll
()
Gets the index of the PathIem into the
collection.
Object (PathItem)
Index
Removes all PathItem objects from the
PathItems collection.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
113
PathPoint
Information about an array of PathPointInfo objects.
Note: You do not use the PathPoint object to create points that make up a path. Rather, you use the
PathPoint object to retrieve information about the points that describe path segments. To create
path points, use the PathPointInfo objects. See ‘PathPointInfo’ on page 114.
Properties
Property
Value Type
What it is
Anchor
Array(Double)
Read-only. The point on the curve
(LeftDirection/RightDirection are
points representing the control handle
end points).
Application
Object (Application)
Read-only. The application that the
object belongs to.
Kind
PsPointKind
Read-only. The PathPoint object’s type.
LeftDirection
Array(Double)
Read-only. The x and y coordinates that
define the left handle.
Parent
Object (SubPathItem)
Read-only. The PathPoint object's
container.
RightDirection
Array(Double)
Read-only. The x and y coordinates that
define the right handle.
typename
String
Read-only. The class name of the
referenced PathPoint object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
114
PathPointInfo
A point on a path, expressed as an array of three coordinate arrays: the anchor point, left direction point,
and right direction point. For paths that are straight segments (not curved), the coordinates of all three
points are the same. For curved segments, the coordinates are different. The difference between the
anchor point and the left or right direction points determines the arc of the curve. You use the left
direction point to bend the curve “outward” or make it convex; you use the right direction point to bend
the curve “inward” or make it concave.
Properties
Property
Value Type
What it is
Anchor
Array
Read-write. The x and y coordinates of one end point of the
path segment.
Application
Object
(Application)
Read-only. The application that the object belongs to.
Kind
PsPointKind
Read-write. The PathPointInfo object’s kind.
LeftDirection
Array(Double)
Read-write. The location of the left direction point (’in’
position).
RightDirection Array(Double)
typename
String
Read-write. The location of the right handle (’out’ position).
Read-only. The class name of the referenced PathPointInfo
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
115
PathPoints
A collection of PathPoint objects that comprises the PathPoints property of the SubPathItem object.
Note: See ‘SubPathItem’ on page 143 for more information.
Properties
Property
Value Type
Application Object (Application)
What it is
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the PathPoints
collection.
Parent
Object (SubPathItem)
Read-only. The PathPoints object's container.
typename
String
Read-only. The class name of the referenced PathPoints
object.
Method
Parameter type
Returns
What it does
Object (PathPoint)
Number
(Long)
Gets the index of the PathPoint into the
collection.
PathPoint
Gets an element from the PathPoints
collection.
Index
(ItemPtr)
Item
(ItemKey)
Number (Long)
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
116
PDFOpenOptions
Options that can be specified when opening a document in generic PDF format.
Properties
Property
Value Type
What it is
AntiAlias
Boolean
Read-write. Indicates whether to use antialias.
Application
Object (Application) Read-only. The application that the object
belongs to.
BitsPerChannel
PsBitsPerChannelType Read-write. The number of bits per channel.
ConstrainProportions
Boolean
Deprecated for Adobe Photoshop CS4.
CropPage
PsCropToType
Read-write. The method of cropping to use.
Height
Double
Deprecated for Adobe Photoshop CS4.
Mode
PsOpenDocumentMode
Read-write. The color model to use.
Name
String
Read-write. The name of the document.
Page
Number (Long)
Read-write. The page to which to open the
document.
Resolution
Number (Double)
Read-write. The resolution of the document (in
pixels per inch).
SuppressWarnings
Boolean
Read-write. Indicates whether to suppress
warnings when opening the document.
typename
String
Read-only. The class name of the referenced
PDFOpenOptions object.
UsePageNumber
Boolean
Read-write. Indicates whether the value specified
in the page property will refer to an image
number when usePageNumber = false. See
Page.
Width
Double
Deprecated for Adobe Photoshop CS4.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
117
PDFSaveOptions
Options that can be specified when saving a document in PDF format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save the
alpha channels with the file.
Annotations
Boolean
Read-write. Indicates whether to save
comments with the file.
Application
Object (Application)
Read-only. The application that the object
belongs to.
ColorConversion
Boolean
Read-write. Indicates whether to convert
the color profile to a destination profile.
ConvertToEightBit
Boolean
Read-write. Indicates whether to convert a
16-bit image to 8-bit for better
compatibility with other applications.
Descripton
String
Read-write. Description of the save options
to use.
DestinationProfile
String
Read-write. Description of the final RGB or
CMYK output device, such as a monitor or a
press standard.
DowngradeColorProfile
Boolean
Deprecated for Adobe Photoshop CS4.
DownSample
PsPDFResampleType
Read-write. The down sample method to
use.
DownSampleSize
Number (Double)
Read-write. The size to downsample images
if they exceed the limit in pixels per inch.
DownSampleSizeLimit
Number (Double)
Read-write. Limits downsampling or
subsampling to images that exceed this
value in pixels per inch.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the
color profile in the document.
EmbedFonts
Boolean
Deprecated for Adobe Photoshop CS4.
EmbedThumbnail
Boolean
Read-write. Indicates whether to include a
small preview image in Adobe PDF files.
Encoding
PsPDFEncoding
Read-write. The encoding method to use.
Default: 1 (psPDFZIP).
Interpolation
Boolean
Deprecated for Adobe Photoshop CS4.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
118
Property
Value Type
What it is (Continued)
JPEGQuality
Number (Long)
Read-write. The quality of the produced
image (0 - 12), which is inversely
proportionate to the compression amount.
Note: Valid only when
Encoding = 2 (psPDFJPEG).
Layers
Boolean
Read-write. Indicates whether to save the
document’s layers.
OptimizeForWeb
Boolean
Read-write. Indicates whether to improve
performance of PDF files on Web servers.
OutputCondition
String
Read-write. An optional comment field for
inserting descriptions of the output
condition. The text is stored in the PDF/X
file.
OutputConditionID
String
Read-write. Indentifier for the output
condition.
PDFCompatibility
PsPDFCompatibilityType
Read-write. The PDF version to make the
document compatible with.
PDFStandard
PsPDFStandardType
Read-write. The PDF standard to make the
document compatible with.
PreserveEditing
Boolean
Read-write. Indicates whether to reopen the
PDF in Adobe Photoshop CS4 with native
Photoshop data intact.
PresetFile
String
Read-write. The preset file to use for
settings.
Note: This option overrides other settings.
ProfileInclusionPolicy
Boolean
Read-write. Indicates whether to show
which profiles to include.
RegistryName
String
Read-write. URL where the output condition
is registered.
SpotColors
Boolean
Read-write. Indicates whether to save spot
colors.
TileSize
Number (Long)
Read-write. Compression option.
Note: Valid only when encoding =
PDFEncoding.JPEG2000.
Transparency
Boolean
Deprecated for Adobe Photoshop CS4.
typename
String
Read-only. The class name of the referenced
PDFSaveOptions object.
UseOutlines
Boolean
Deprecated for Adobe Photoshop CS4.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
119
Property
Value Type
What it is (Continued)
VectorData
Boolean
Deprecated for Adobe Photoshop CS4.
View
Boolean
Read-write. Indicates whether to open the
saved PDF in Adobe Acrobat.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
120
PhotoCDOpenOptions
DEPRECATED in Adobe Photoshop CS4. Kodak PhotoCD is now found in the Goodies folder on the Adobe
Photoshop CS4 Install DVD.
Options to be specified when opening a Kodak Photo CD (PCD) files, including high-resolution files from
Pro Photo CD discs.
Properties
Property
Value Type
What it is
Application
Object (Application) Read-only. The application that the object
belongs to.
ColorProfileName
String
Read-write. The profile to use when reading the
image.
ColorSpace
PsPhotoCDColorSpace
Read-write. The colorspace for the image.
Orientation
PsOrientation
Read-write. The image orientation.
PixelSize
PsPhotoCDSize
Read-write. The image dimensions.
Resolution
Number (Double)
Read-write. The image resolution (in pixels per
inch).
typename
String
Read-only. The class name of the referenced
PhotoCDOpenOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
121
PhotoshopSaveOptions
Options that can be specified when saving a document in PSD format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save the alpha
channels.
Annotations
Boolean
Read-write. Indicates whether to save the
annotations.
Application
Object
(Application)
Read-only. The application that the object belongs
to.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the color
profile in the document.
Layers
Boolean
Read-write. Indicates whether to preserve the
layers.
SpotColors
Boolean
Read-write. Indicates whether to save the spot
colors.
typename
String
Read-only. The class name of the referenced
PhotoshopSaveOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
122
PICTFileSaveOptions
Options that can be specified when saving a document in PICT format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save the alpha
channels.
Application
Object
(Application)
Read-only. The application that the object
belongs to.
Compression
PsPICTCompression
Read-write. Default: 1)
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the
color profile in the document.
Resolution
PsPICTBitsPerPixels Read-write. The number of bits per pixel.
typename
String
Read-only. The class name of the referenced
PICTFileSaveOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
123
PicturePackageOptions
Options that can be specified for a Picture Package.
Property
Value type
What it is
Application
Object (Application)
Read-only. The application that the object
belongs to.
Content
PsPicturePackageTextType
Read-write. The content information.
Default: 0 (psNoText).
Flatten
Boolean
Read-write. Indicates whether all layers in
the final document are flattened. Default:
true.
Font
PsGalleryFontType
Read-write. The font used for security text.
Default: 1 (psArial).
FontSize
Number (Long)
Read-write. The font size used for security
text. Default: 12.
Layout
String
Read-write. The layout to use to generate
the picture package. Default: “(2)5x7”.
Mode
PsNewDocumentMode
Read-write. Read-write. The color profile to
use as the document mode. Default: 2
(psNewRGB).
Opacity
Number (Long)
Read-write. The Web page security opacity
as a percent. Default: 100.
Resolution
Number (Double)
Read-write. The resolution of the document
in pixels per inch. Default: 72.0.
Text
String
Read-write. The picture package custom
text.
Note: Valid only when Content = 2
(psUserText). See Content.
TextColor
RGBColor
Read-write. The color to use for security
text.
TextPosition
PsGallerySecurityTextPositionType
Read-write. The security text position.
Default: 1 (psCentered).
TextRotate
PsGallerySecurityTextRotateType
Read-write. The orientation to use for
security text. Default: 1 (psZero).
typename
String
Read-only. The class name of the
referenced PicturePackageOptions
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
PixarSaveOptions
Options that can be specified when saving a document in Pixar format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save
the alpha channels.
Application
Object (Application)
Read-only. The application that the
object belongs to.
typename
String
Read-only. The class name of the
referenced PixarSaveOptions
object.
124
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
PNGSaveOptions
Options that can be specified when saving a document in PNG format.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the object belongs to.
Interlaced
Boolean
Read-write. Indicates whether the should rows be
interlaced. Default: false.
typename
String
Read-only. The class name of the referenced
PNGSaveOptions object.
125
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
126
Preferences
Options to define for the Preferences property of the Application object. See ‘Preferences’ on page 17
(in the Properties table for the Application object).
Note: Defining the Preferences properties is basically equivalent to selecting Edit > Preferences
(Windows) or Photoshop > Preferences in the Adobe Photoshop CS4 application. For explanations
of individual settings, please refer to Adobe Photoshop CS4 Help.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
127
Properties
Property
Value Type
What it is
AdditionalPluginFolder
String
Read-write. The path to an additional
plug-in folder.
Note: Valid only when
UseAdditionalPluginFolder
= true. See
UseAdditionalPluginFolder.
Application
Object (Application)
Read-only. The application that the
object belongs to.
AskBeforeSavingLayeredTIFF
Boolean
Read-write. Indicates whether to ask
the user to verify layer preservation
options when saving a file in TIFF
format.
AutoUpdateOpenDocuments
Boolean
Read-write. Indicates whether to
automatically update open
documents.
BeepWhenDone
Boolean
Read-write. Indicates whether to
beep when a process finishes.
ColorChannelsInColor
Boolean
Read-write. Indicates whether to
display component channels in the
Channels palette in color.
ColorPicker
PsColorPicker
Read-write.
ColumnGutter
Number (Double)
Read-write. The width of the column
gutters (in points). (0.1 - 600.0).
ColumnWidth
Number (Double)
Read-write. Column width (in points)
(0.1 - 600.0).
CreateFirstSnapshot
Boolean
Read-write. Indicates whether to
automatically make the first snapshot
when a new document is created.
DynamicColorSliders
Boolean
Read-write. Indicates whether
dynamic color sliders appear in the
Color palette.
EditLogItems
PsEditLogItemsType
Read-write. The options for editing
history log items.
Note: Valid only when
UseHistoryLog = true. See
UseHistoryLog.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
128
Property
Value Type
What it is (Continued)
ExportClipboard
Boolean
Read-write. Indicates whether to
retain Adobe Photoshop CS4
contents on the clipboard after you
exit the application.
FontPreviewSize
psFontPreviewType
Read-write. Indicates whether to
show font previews in the type tool
font menus.
GamutWarningOpacity
Number (Double)
Read-write. (0 - 100 as percent).
GridSize
PsGridSize
Read-write. The size to use for squares
in the grid.
GridStyle
PsGridLineStyle
Read-write. The formatting style for
non-printing grid lines.
GridSubDivisions
Number (Long)
Read-write. (1 - 100)
GuideStyle
PsGuideLineStyle
Read-write. The formatting style for
non-printing guide lines.
ImageCacheLevels
Number (Long)
Read-write. The number of images to
hold in the cache (1 - 8).
ImagePreviews
PsSaveBehavior
Read-write. The behavior mode to use
when saving files.
Interpolation
PsResampleMethod
Read-write. The method to use to
assign color values to any new pixels
created when an image is resampled
or resized.
KeyboardZoomResizesWindows
Boolean
Read-write. Indicates whether to
automatically resize the window
when zooming in or out using
keyboard shortcuts.
MaximizeCompatibility
PsQueryStateType
Read-write. The behavior to use to
check whether to maximize
compatibility when opening Adobe
Photoshop CS4 (PSD) files.
MaxRAMuse
Number (Long)
Read-write. The maximum
percentage of available RAM used by
Adobe Photoshop CS4 (5 - 100).
NonLinearHistory
Boolean
Read-write. Indicates whether to
allow non-linear history.
NumberOfHistoryStates
Number (Long)
Read-write. The number of history
states to preserve (1 - 100).
OtherCursors
PsOtherPaintingCursors Read-write. The type of pointer to
use.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
129
Property
Value Type
What it is (Continued)
PaintingCursors
PsPaintingCursors
Read-write. The type of pointer to
use.
Parent
Object (Application)
Read-write. The Preferences object's
container.
PixelDoubling
Boolean
Read-write. Indicates whether to
halve the resolution or (double the
size of pixels) to make previews
display more quickly.
PointSize
PsPointType
Read-write. The point/pica size.
RecentFileListLength
Number (Long)
Read-write. The number of items in
the recent file list (0 - 30).
RulerUnits
PsUnits
Read-write. The unit the scripting
system will use when receiving and
returning values.
SaveLogItems
PsSaveLogItemsType
Read-write. The options for saving the
history items.
SaveLogItemsFile
String
Read-write. The path to the history
log file.
SavePaletteLocations
Boolean
Read-write. Indicates whether to
make new palette locations the
default location.
ShowAsianTextOptions
Boolean
Read-write. Indicates whether to
display Asian text options in the
Paragraph palette.
ShowEnglishFontNames
Boolean
Read-write. Indicates whether to list
Asian font names in English.
ShowSliceNumber
Boolean
Read-write. Indicates whether to
display slice numbers in the
document window when using the
Slice tool.
ShowToolTips
Boolean
Read-write. Indicates whether to
show pop up definitions on mouse
over.
SmartQuotes
Boolean
Read-write. Indicates whether to use
curly or straight quote marks.
typename
String
Read-only. The class name of the
referenced Preferences object.
TypeUnits
PsTypeUnits
Read-write. The unit type-size that the
numeric inputs are assumed to
represent.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
130
Property
Value Type
What it is (Continued)
UseAdditionalPluginFolder
Boolean
Read-write. Indicates whether to use
an additional folder for compatible
plug-ins stored with a different
application.
UseHistoryLog
Boolean
Read-write. Indicates whether to
create a log file for history states.
UseLowerCaseExtension
Boolean
Read-write. Indicates whether the file
extension should be lowercase.
UseShiftKeyForToolSwitch
Boolean
Read-write. Indicates whether to
enable cycling through a set of
hidden tools.
UseVideoAlpha
Boolean
Read-write. Indicates whether to
enable Adobe Photoshop CS4 to send
transparency information to your
computer’s video board. (Requires
hardware support.)
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
131
PresentationOptions
Options that can be specified for PDF presentations.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object
belongs to.
AutoAdvance
Boolean
Read-write. Indicates whether to auto advance
images when viewing the presentation. Default:
true.
Note: Valid only when Presentation = true.
See Presentation.
IncludeFilename
Boolean
Read-write. Indicates whether to include the file
name for the image (default: false).
Interval
Number (Long)
Read-write. The time in seconds before the view
is auto advanced (1 - 60; default: 5).
Note: Valid only when AutoAdvance = true.
See AutoAdvance.
Loop
Boolean
Read-write. Indicates whether to begin the
presentation again after the last page. Default:
false.
Note: Valid only when AutoAdvance = true.
See AutoAdvance.
Magnification
PsMagnificationType Read-write. The magnification type to use when
viewing the image.
PDFFileOptions
PDFSaveOptions
Read-write. Options to use when creating the
PDF file.
Presentation
Boolean
Read-write. Indicates whether the output will be
a presentation. Default: false); when false, the
output is a Multi-Page document.
Transition
PsTransitionType
Read-write. The transition from one image to the
next. Default: 9 (psNoTransition).
Note: Valid only when AutoAdvance = true.
See AutoAdvance.
typename
String
Read-only. The class name of the referenced
PDFPresentationOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
132
RawFormatOpenOptions
Options that can be specified when opening a document in RAW format.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
BitsPerChannel
Number (Long)
Read-write. The number of bits for each channel.
Note: The only valid values are BitsPerChannel = 8
or BitsPerChannel = 16.
ByteOrder
PsByteOrder
Read-write. The order in which bytes will be read.
Note: Valid only when
BitsPerChannel = 16. See BitsPerChannel.
ChannelNumber
Number (Long)
Read-write. The number of channels in the image
(1 - 56).
Note: The value of ChannelNumber cannot exceed the
number of channels in the image. When
BitsPerChannel = 16, only the following
values are valid: 1, 3, or 4. See BitsPerChannel.
HeaderSize
Number (Long)
Read-write. The number of bytes of information that
will appear in the file before actual image information
begins; that is, the number of zeroes inserted at the
beginning of the file as placeholders (0 - 1919999).
Height
Number (Long)
Read-write. The height of the image (in pixels).
InterleaveChannels
Boolean
Read-write. Indicates whether to store color values
sequentially.
RetainHeader
Boolean
Read-write. Indicates whether to retain the header
when saving.
Note: Valid only when HeaderSize is 1 or greater.
typename
String
Read-only. The class name of the referenced
RawFormatOpenOptions object.
Width
Number (Long)
Read-write. The image width in pixels.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
RawSaveOptions
Options that can be specified when saving a document in RAW format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether alpha
channels should be saved.
Application
Object (Application)
Read-only. The application that the
object belongs to.
SpotColors
Boolean
Read-write. Indicates whether the spot
colors should be saved.
typename
String
Read-only. The class name of the
referenced RawSaveOptions object.
133
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
134
RGBColor
The definition of a color in RGB color mode.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the
object belongs to.
Blue
Number (Double)
Read-write. The blue color value (
0.0 - 255.0; default: 255.0).
Green
Number (Double)
Read-write. The green color value
(0.0 - 255.0; default: 255.0).
HexValue
String
Read-write. The hex representation of the
color.
Red
Number (Double)
Read-write. The red color value
(0.0 - 255.0; default: 255.0).
typename
String
Read-only. The class name of the
referenced RGBColor object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
135
Selection
The selected area of a document or layer.
Properties
Property
Value Type
What it is
Application
Object (Application)
Read-only. The application that the
object belongs to.
Bounds
Array of
Number(Double)
Read-only. The bounding rectangle of the
entire selection.
Parent
Object (Document)
Read-only. The object's container.
Solid
Boolean
Read-only. Indicates if the bounding
rectangle is a solid.
typename
String
Read-only. The class name of the
referenced Selection object.
Methods
Method
Parameter Type
()
Contract
Number (Double)
Copy
([Merge])
What it does
Clears the selection and does
not copy it to the clipboard.
Clear
(By)
Returns
Boolean
Contracts the selection by the
specified amount.
Copies the selection to the
clipboard. When the optional
argument is used and set to
true, a merged copy is
performed (all visible layers in
the selection are copied).
Clears the current selection and
copies it to the clipboard.
Cut
()
Deselects the current selection.
Deselect
()
Number (Double)
Expands the selection by the
specified amount.
Number (Double)
Feathers the edges of the
selection by the specified
amount.
Expand
(By)
Feather
(By)
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Fill
(Filltype
[, Mode]
[, Opacity]
[, PreserveTransparency])
Object (SolidColor, or
HistoryState)
PsColorBlendMode
Number (Long)
Boolean
Grow
(Tolerance,
AntiAlias)
Number (Long)
Boolean
Returns
136
What it does (Continued)
Fills the selection (Opacity: 1 100 as percent).
Grows the selection to include
all adjacent pixels falling within
the specified tolerance range.
Inverts the selection (deselects
the selection and selects the rest
of the layer or document).
Invert
()
Note: To flip the selection
shape, see Rotate.
Load
(From
[, Combination]
[, Inverting])
MakeWorkPath
Channel
PsSelectionType
Boolean
Number (Double)
([Tolerance])
Resize
([Horizontal]
[, Vertical]
[, Anchor])
Number (Double)
Number (Double)
PsAnchorPosition
Number (Double)
PsAnchorPosition
Rotates the selection by the
specified amount around the
specified anchor point.
Number (Double)
PsAnchorPosition
Rotates the boundary of the
selection around the specified
anchor.
RotateBoundary
(Angle
[, Anchor])
Selects the specified region.
Select
(Region
[, Type]
[, Feather]
[, AntiAlias])
SelectAll
()
Resizes the selected area to the
specified dimensions and
anchor position.
Changes the size of the
selection to the specified
dimensions around the
specified anchor.
Rotate
(Angle
[, Anchor])
Makes this selection item the
work path for this document.
Number (Double)
Number (Double)
PsAnchorPosition
ResizeBoundary
([Horizontal]
[, Vertical]
[, Anchor])
Loads the selection from the
specified channel.
Array (Points:
Array (Array
(x,y),...)
PsSelectionType
Number (Double)
Boolean
Selects the entire layer.
Adobe Photoshop CS4
VBScript Scripting Reference
Method
VBScript Interface
Parameter Type
Returns
SelectBorder
(Width)
Number (Double)
Similar
(Tolerance,
AntiAlias)
Number (Long)
Boolean
Smooth
(Radius)
Number (Long)
Object (SolidColor)
Number (Long)
PsStrokeLocation
PsColorBlendMode
Number (Long)
Boolean
Translate
([DeltaX]
[, DeltaY])
Number (Double)
Number (Double)
TranslateBoundary
([DeltaX]
[, DeltaY])
Selects the selection border only
(in the specified width);
subsequent actions do not
affect the selected area within
the borders.
Grows the selection to include
pixels throughout the image
falling within the tolerance
range.
Cleans up stray pixels left inside
or outside a color-based
selection (within the radius
specified in pixels).
Channel
PsSelectionType
Stroke
(StrokeColor,
Width
[, Location]
[, Mode]
[, Opacity]
[, PreserveTransparency])
What it does (Continued)
Saves the selection as a channel.
Store
(Into
[, Combination])
137
Number (Double)
Number (Double)
Strokes the selection border
(Opacity: 1 - 100 as percent).
Moves the entire selection
relative to its current position.
Moves the selection relative to
its current position.
Sample Script
➤ The following script creates a checkerboard using the following steps:
1. Create an 800 x 800 pixel document.
2. Divide the entire document into 100 x 100 pixel squares.
3. Select every other square in the first row, then shift the selection criteria to select the alternate squares
in the following row. Repeat until every other square in the document is selected.
4. Fill the selected squares with the foreground color from the palette.
5. Invert the selection and fill the newly selected squares with the background color from the palette.
6. Deselect the squares to remove the selection outlines (the “marching ants").
Selection.vbs
Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, docSize
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Dim cells, cellSize, checkersDoc, shiftIt, h, v, eventWait, enumRedrawComplete
Dim typeState, keyState, desc
Set appRef = CreateObject("Photoshop.Application")
' Save the current Preferences
startRulerUnits = appRef.Preferences.RulerUnits
startTypeUnits = appRef.Preferences.TypeUnits
startDisplayDialogs = appRef.DisplayDialogs
' Set Photoshop CS4 to use pixels and display no dialogs
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels)
appRef.Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels)
appRef.DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs)
' Close all the open documents
Do While appRef.Documents.Count
appRef.ActiveDocument.Close
Loop
' Create variables for the 800 pixel board divided in even 100 x 100 squares
docSize = 800
cells = 8
cellSize = docSize / cells
' create a new document
Set checkersDoc = appRef.Documents.Add(docSize, docSize, 72, "Checkers")
' Create a variable to use for selecting the checker board
' That allows me to shift the selection one square to the right
'on every other row, and then shift back for the rows in between.
shiftIt = true
' loop through vertically to create the first row
v = 0
For v = 0 To (docSize - 1) Step cellSize
' Switch the shift For a new row
shiftIt = Not shiftIt
' loop through horizontally
h = 0
For h = 0 To (docSize - 1) Step (cellSize * 2)
' push over the cellSize to start with only
If shiftIt And h = 0 Then
h = h + cellSize
End If
' Select a square
selRegion = Array(Array(h, v), _
Array(h + cellSize, v), _
Array(h + cellSize, v + cellSize), _
Array(h, v + cellSize), _
Array(h, v))
If h = 0 And v = 0 Then
checkersDoc.Selection.Select selRegion
Else
checkersDoc.Selection.Select selRegion, 2
' value 2 is for PsSelectionType --> 2 (psExtendSelection)
End If
138
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
' turn this off for faster execution
' turn this on for debugging
WaitForRedraw
Next
Next
' Fill the current selection with the Foreground color
checkersDoc.Selection.Fill(appRef.ForegroundColor)
'Invert the selection
checkersDoc.Selection.Invert()
' Fill the new selection with the background color
checkersDoc.Selection.Fill(appRef.BackgroundColor)
' Clear the selection to get rid of the non-printing borders
checkersDoc.Selection.Deselect()
' Reset the application preferences
appRef.Preferences.RulerUnits = startRulerUnits
appRef.Preferences.TypeUnits = startTypeUnits
appRef.DisplayDialogs = startDisplayDialogs
' ---------------------------------------------------------------------------' A helper function for debugging
' It also helps the user see what is going on
' if you turn it off for this example you
' get a flashing cursor for a Number (Long) time
' Save a bit of time by creating the variables only once
Private Sub WaitForRedraw
If VarType(eventWait) = vbEmpty Then
eventWait = appRef.charIDToTypeID("Wait")
End If
If VarType(enumRedrawComplete) = vbEmpty Then
enumRedrawComplete = appRef.charIDToTypeID("RdCm")
End If
If VarType(typeState) = vbEmpty Then
typeState = appRef.charIDToTypeID("Stte")
End If
If VarType(keyState) = vbEmpty Then
keyState = appRef.charIDToTypeID("Stte")
End If
If VarType(desc) = vbEmpty Then
Set desc = CreateObject("Photoshop.ActionDescriptor")
desc.putEnumerated KeyState, typeState, enumRedrawComplete
End If
appRef.executeAction eventWait, desc, 3 _
'value of 3 for PsDialogModes --> 3 (psDisplayNoDialogs)
End Sub
139
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
SGIRGBSaveOptions
Options that can be specified when saving a document in SGIRGB format.
Note: The SGIRGB format is not installed automatically with Adobe Photoshop CS4.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save
the alpha channels.
Application
Object (Application)
Read-only. The application that the
object belongs to.
SpotColors
Boolean
Read-write. Indicates whether to save
the spot colors.
typename
String
Read-only. The class name of the
referenced SGIRGBSaveOptions
object.
140
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
141
SolidColor
A color definition used in the document.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
CMYK
Object (CMYKColor)
Read-write. The CMYK color mode.
Gray
Object (GrayColor)
Read-write. The Grayscale color mode.
HSB
Object (HSBColor)
Read-write. The HSB color mode.
Lab
Object (LabColor)
Read-write. The LAB color mode.
Model
PsColorModel
Read-write. The color model.
NearestWebColor Object (RGBColor)
Read-only. The nearest Web color to the current color.
RGB
Object (RGBColor)
Read-write. The RGB color mode.
typename
String
Read-only. The class name of the referenced SolidColor
object.
Methods
Method
Parameter Type
IsEqual
(Color)
SolidColor
Returns
What it does
Boolean
Indicates whether the SolidColor object
is visually equal to the specified color.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
142
SubPathInfo
An array of PathPointInfo objects that describes a straight or curved segment of a path.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Closed
Boolean
Read-write. Indicates whether the path describes an
enclosed area.
EntireSubPath
Array (PathPoint
objects)
Read-write.
Operation
PsShapeOperation
Read-write. The sub path’s operation on other sub
paths.
typename
String
Read-only. The class name of the referenced
SubPathInfo object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
143
SubPathItem
Information about a path.
Note: You do not use the SubPathItem object to create a path. Rather, you create path segments using
the SubPathInfo object. Use the SubPathItem object to retrieve information about a path. (Note
that all of the SubPathItem object’s properties are Read-only.)
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Closed
Boolean
Read-only. Indicates whether the path is closed.
Operation
PsShapeOperation
Read-only. The sub path operation on other sub paths.
Parent
Object (PathItem) Read-only. The object's container.
PathPoints
Object
(PathPoints)
Read-only. The PathPoints collection.
typename
String
Read-only. The class name of the referenced SubPathItem
object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
SubPathItems
A collection of SubPathItem objects. See SubPathItem.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the SubPathItems
collection.
Parent
Object
(PathItem)
Read-only. The SubPathItems object's container.
typename
String
Read-only. The class name of the referenced SubPathItems
object.
Method
Parameter type
Returns
What it does
Index
Object
(SubPathItem)
Number
(Long)
Gets the index of the SubPathItem into the
collection.
Number (Long)
SubPathItem
Gets an element from the SubPathItems
collection.
Methods
(ItemPtr)
Item
(ItemKey)
144
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
145
TargaSaveOptions
Options that can be set when saving a document in TGA (Targa) format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save the alpha
channels.
Application
Object (Application) Read-only. The application that the object belongs to.
Resolution
PsTargaBitsPerPixels Read-write. The number of bits per pixel. Default: 24.
RLECompression
Boolean
Read-write. Indicates whether RLE compression should
be used. Default: true.
typename
String
Read-only. The class name of the referenced
TargaSaveOptions object.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
TextFont
Details about a font in the TextFonts collection.
Note: See TextFonts for more information on the TextFonts collection.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the object belongs to.
Family
String
Read-only. The font family.
Name
String
Read-only. The name of the font.
Parent
Object
(Application)
Read-only. The object's container.
PostScriptName
String
Read-only. The PostScript name of the font.
Style
String
Read-only. The font style.
typename
String
Read-only. The class name of the referenced TextFont
object.
146
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
147
TextFonts
The collection of fonts available on your computer.
Note: The TextFonts object corresponds to the Fonts property of the Application object. In a script,
you use Fonts to refer to a TextFonts object. The following sample demonstrates how to use the
Count property of the TextFonts object to display a dialog that indicates the number of fonts
installed on the machine.
●
Correct:
Alert appRef.Fonts.Count
●
Incorrect:
Alert appRef.TextFonts.Count
See ‘Application’ on page 16’, specifically the Fonts property, for more information.
Properties
Property
Value Type
What it is
Application
Object
(Application)
Read-only. The application that the collection belongs to.
Count
Number (Long)
Read-only. The number of elements in the TextFonts collection.
Parent
Object
(Application)
Read-only. The object's container.
typename
String
Read-only. The class name of the referenced TextFonts object.
Parameter Type
Returns
What it does
Number (Long)
Gets the index of the TextFont into the
collection.
TextFont
Gets an element from the TextFonts
collection.
Methods
Method
Index
(ItemPtr)
Object
(TextFont)
Item
(ItemKey)
Number (Long)
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
148
TextItem
The text in an ArtLayer object whose Kind property’s value is 2.
Note: See ArtLayer, specifically the Kind property, for more information.
Properties
Property
Value Type
What it is
AlternateLigatures
Boolean
Read-write. Indicates whether to use alternate
ligatures.
Note: Alternate ligatures are the same as
Discretionary Ligatures. Please refer to
Adobe Photoshop CS4 Help for more
information.
AntiAliasMethod
PsAntiAlias
Read-write. The method of anti aliasing to use.
Application
Object
(Application)
Read-only. The application that the object belongs
to.
AutoKerning
PsAutoKernType
Read-write. The auto kerning option to use.
AutoLeadingAmount
Number (Double)
Read-write. The percentage to use for auto. Default)
leading (0.01 - 5000.00 in points).
Note: Valid only when UseAutoLeading = true.
See UseAutoLeading.
BaselineShift
Number (Double)
Read-write. The unit value to use in the baseline
offset of text.
Capitalization
PsCase
Read-write. The text case.
Color
Object
(SolidColor)
Read-write. The text color.
Contents
String
Read-write. The actual text in the layer.
DesiredGlyphScaling
Number (Double)
Read-write. The desired amount (percentage) to
scale the horizontal size of the text letters (50 - 200;
at 100, the width of characters is not scaled).
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MinimumGlyphScaling and
MaximumGlyphScaling.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
149
Property
Value Type
What it is (Continued)
DesiredLetterScaling
Number (Double)
Read-write. The amount of space between letters
(100 - 500; at 0, no space is added between letters).
Note: ‘Letter Scaling’ is
basically equivalent to
‘Letter Spacing’ in the
Adobe Photoshop CS4
application Justification
dialog (Select
Justification on the
Paragraphs palette
menu).
DesiredWordScaling
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MinimumLetterScaling and
MaximumLetterScaling.
Number (Double)
Note: ‘Word Scaling’ is
basically equivalent to
‘Word Spacing’ in the
Adobe Photoshop CS4
application Justification
dialog (Select
Justification on the
Paragraphs palette
menu).
Read-write. The amount (percentage) of space
between words (0 -1000; at 100, no additional
space is added between words).
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MinimumWordScaling and
MaximumWordScaling.
Direction
PsDirection
Read-write. The text orientation.
FauxBold
Boolean
Read-write. Indicates whether to use faux bold.
Default: false.
Note: Using FauxBold.true is equivalent to
selecting text and clicking the Faux Bold
button in the Character palette.
FauxItalic
Boolean
Read-write. Indicates whether to use faux italic.
Default: false.
Note: Using FauxItalic.true is equivalent to
selecting text and clicking the Faux Italic
button in the Character palette.
FirstLineIndent
Number (Double)
Read-write. The amount (unit value) to indent the
first line of paragraphs (-1296 - 1296).
Font
String
Read-write. The text face of the character.
HangingPunctuation
Boolean
Read-write. Indicates whether to use roman
Hanging Punctuation.
Height
Number (Double)
Read-write. The height of the bounding box (unit
value) for paragraph text.
Note: Valid only when Kind = 2
(psParagraphText). See Kind.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
150
Property
Value Type
What it is (Continued)
HorizontalScale
Number (Long)
Read-write. Character scaling (horizontal) in
proportion to vertical scale (0 - 1000 in percent).
See VerticalScale.
HyphenateAfterFirst
Number (Long)
Read-write. The number of letters after which
hyphenation in word wrap is allowed (1 - 15).
HyphenateBeforeLast
Number (Long)
Read-write. The number of letters before which
hyphenation in word wrap is allowed (1 - 15).
HyphenateCapitalWords
Boolean
Read-write. Indicates whether to allow hyphenation
in word wrap of capitalized words.
HyphenateWordsLongerThan Number (Long)
Read-write. The minimum number of letters a word
must have in order for hyphenation in word wrap to
be allowed (2 - 25).
Hyphenation
Boolean
Read-write. Indicates whether to use hyphenation
in word wrap.
HyphenationZone
Number (Double)
Read-write. The distance at the end of a line that
will cause a word to break in unjustified type (0 720 pica).
HyphenLimit
Number (Long)
Read-write. The maximum number of consecutive
lines that can end with a hyphenated word.
Justification
PsJustification
Read-write. The paragraph justification.
Kind
PsTextType
Read-write. The text-wrap type.
Language
PsLanguage
Read-write. The language to use.
Leading
Number (Double)
Read-write. The leading amount (unit value).
LeftIndent
Number (Double)
Read-write. The amount (unit value) of space to
indent text from the left (-1296 - 1296).
Ligatures
Boolean
Read-write. Indicates whether to use ligatures.
MaximumGlyphScaling
Number (Double)
Read-write. The maximum amount (percentage) to
scale the horizontal size of the text letters (50 - 200;
at 100, the width of characters is not scaled).
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MinimumGlyphScaling and
DesiredGlyphScaling.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Property
Value Type
What it is (Continued)
MaximumLetterScaling
Number (Double)
Read-write. The maximum amount of space to
allow between letters (100 - 500; at 0, no space is
added between letters).
Note: ‘Letter Scaling’ is
basically equivalent to
‘Letter Spacing’ in the
Adobe Photoshop CS4
application Justification
dialog (Select
Justification on the
Paragraphs palette
menu).
MaximumWordScaling
Note: Valid only when Valid only when
Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MaximumLetterScaling and
DesiredLetterScaling.
Number (Double)
Note: ‘Word Scaling’ is
basically equivalent to
‘Word Spacing’ in the
Adobe Photoshop CS4
application Justification
dialog (Select
Justification on the
Paragraphs palette
menu).
MinimumGlyphScaling
151
Read-write. The maximum amount (percentage) of
space to allow between words (0 -1000; at 100, no
additional space is added between words).
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MaximumWordScaling and
DesiredWordScaling.
Number (Double)
Read-write. The minimum amount (percentage) to
scale the horizontal size of the text letters (50 - 200;
at 100, the width of characters is not scaled).
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MaximumGlyphScaling and
DesiredGlyphScaling.
MinimumLetterScaling
Note: ‘Letter Scaling’ is
basically equivalent to
‘Letter Spacing’ in the
Adobe Photoshop CS4
application Justification
dialog (Select
Justification on the
Paragraphs palette
menu).
Number (Double)
Read-write. The minimum amount (percentage) of
space between letters (100 - 500; at 0, no space is
removed between letters).
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MaximumLetterScaling and
DesiredLetterScaling.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
152
Property
Value Type
What it is (Continued)
MinimumWordScaling
Number (Double)
Read-write. The minimum amount (percentage) of
space between words (0 -1000; at 100, no space is
removed between words).
Note: ‘Word Scaling’ is
basically equivalent to
‘Word Spacing’ in the
Adobe Photoshop CS4
application Justification
dialog (Select
Justification on the
Paragraphs palette
menu).
NoBreak
Note: Valid only when Justification =
4 (psLeftJustified);
5 (psCenterJustified);
6 (psRightJustified); or
7 (psFullyJustified).
See Justification. The following values are
also required: MaximumWordScaling and
DesiredWordScaling.
Boolean
Read-write. Indicates whether to allow words to
break at the end of a line.
Tip: When enacted on large amounts of
consecutive characters, noBreak = true can
prevent word wrap and thus may prevent
some text from appearing on the screen.
OldStyle
Boolean
Read-write. Indicates whether to use old style type.
Parent
Object
(ArtLayer)
Read-write. The TextItem object's container.
Position
Array of Number
(Double)
Read-write. The position of origin for the text. The
array must contain two values (unit value).
Tip: Setting the Position property is basically
equivalent to clicking the text tool at a point in
the document to create the point of origin for
text.
RightIndent
Number (Double)
Read-write. The amount of space (unit value) to
indent text from the right (-1296 - 1296).
Size
Number (Double)
Read-write. The font size (unit value).
SpaceAfter
Number (Double)
Read-write. The amount of space (unit value) to use
after each paragraph (-1296 - 1296).
SpaceBefore
Number (Double)
Read-write. The amount of space (unit value) to use
before each paragraph (-1296 - 1296).
StrikeThru
PsStrikeThruType Read-write. The text strike through option to use.
TextComposer
PsTextComposer
Read-write. The composition method to use to
evaluate line breaks and optimize the specified
hyphenation and Justification options.
Note: Valid only when Kind = 2
(psParagraphText). See Kind.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Property
Value Type
What it is (Continued)
Tracking
Number (Double)
Read-write. The amount of uniform spacing
between multiple characters (-1000 - 10000).
153
Note: Tracking units are 1/1000 of an em space.
The width of an em space is relative to the
current type size. In a 1-point font, 1 em
equals 1 point; in a 10-point font, 1 em
equals 10 points. So, for example, 100 units
in a 10-point font are equivalent to 1 point.
typename
String
Read-only. The class name of the referenced
TextItem object.
Underline
PsUnderlineType
Read-write. The text underlining options.
UseAutoLeading
Boolean
Read-write. Indicates whether to use a font's
built-in leading information.
VerticalScale
Number (Long)
Read-write. Character scaling (vertical) in
proportion to horizontal scale (0 - 1000 in percent).
See HorizontalScale.
WarpBend
Number (Double)
Read-write. The warp bend percentage (-100 - 100).
WarpDirection
PsDirection
Read-write. The warp direction.
WarpHorizontalDistortion Number (Double)
Read-write. The horizontal distortion (as
percentage) of the warp (-100 - 100).
WarpStyle
PsWarpStyle
Read-write. The style of warp to use.
WarpVerticalDistortion
Number (Double)
Read-write. The vertical distortion (as percentage)
of the warp (-100 - 100).
Width
Number (Double)
Read-write. The width of the bounding box (unit
value) for paragraph text.
Note: Valid only when Kind = 2
(psParagraphText). See Kind.
Methods
Method
ConvertToShape
()
CreatePath
()
Parameter Type
Returns
What it does
Converts the text item and its containing layer to
a fill layer with the text changed to a clipping
path.
Creates a clipping path from the outlines of the
actual text items (such as letters or words).
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
154
TiffSaveOptions
Options that can be specified when saving a document in TIFF format.
Properties
Property
Value Type
What it is
AlphaChannels
Boolean
Read-write. Indicates whether to save the alpha
channels.
Annotations
Boolean
Read-write. Indicates whether to save the
annotations.
Application
Object (Application) Read-only. The application that the object
belongs to.
ByteOrder
PsByteOrder
Read-write. The order in which the document’s
bytes will be read. The default is 2
(psMacOSByteOrder) when running on Mac OS
and 1 (psIBMByteOrder) when running on a PC.
EmbedColorProfile
Boolean
Read-write. Indicates whether to embed the color
profile in the document.
ImageCompression
PsTIFFEncodingType
Read-write. The compression type. Default: 1
(psNoTIFFCompression).
InterleaveChannels
Boolean
Read-write. Indicates whether the channels in the
image will be interleaved.
JPEGQuality
Number (Long)
Read-write. The quality of the produced image (0 12), which is inversely proportionate to the
amount of JPEG compression.
Note: Valid only when ImageCompression = 3
(psTiffJPEG).
LayerCompression
PsLayerCompressionTy Read-write. The method of compression to use
pe
when saving layers (as opposed to saving
composite data).
Note: Valid only when Layers = true. See
Layers
Layers
Boolean
Read-write. Indicates whether to save the layers.
SaveImagePyramid
Boolean
Read-write. Indicates whether to preserve
multiresolution information. Default: false.
SpotColors
Boolean
Read-write. Indicates whether to save the spot
colors.
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
Property
Value Type
What it is (Continued)
Transparency
Boolean
Read-write. Indicates whether to save the
transparency as an additional alpha channel
when the file is opened in another application.
typename
String
Read-only. The class name of the referenced
TIFFSaveOptions object.
155
Adobe Photoshop CS4
VBScript Scripting Reference
VBScript Interface
156
XMPMetadata
Camera raw image file settings stored in an XMP file in the same folder as the raw file with the same base
name and an XMP extension.
Properties
Property
Value Type
What it is
Application
Object
Read-only. The application that the object belongs
(Application)
to.
Parent
Object
(Document)
Read-only. The object's container.
RawData
String
Read-write. The raw XML form of file information.
typename
String
Read-only. The class name of the referenced
XMPMetadata object.
3
Scripting Constants
This section lists and describes the enumerations defined for use with Adobe Photoshop CS4 VBScript
properties and methods.
XXX
Constant type
Values
What it means
PsAdjustmentReference
1 (psRelative)
2 (psAbsolute)
Method to use for interpreting selective
color adjustment specifications: 1 = %
of the existing color amount; 2 = % of
the whole.
PsAnchorPosition
1
2
3
4
5
6
7
8
9
(psTopLeft)
(psTopCenter)
(psTopRight)
(psMiddleLeft)
(psMiddleCenter)
(psMiddleRight)
(psBottomLeft)
(psBottomCenter)
(psBottomRight)
The point on the object that does not
move when the object is rotated or
resized.
PsAntiAlias
1
2
3
4
5
(psNoAntialias)
(psSharp)
(psCrisp)
(psStrong)
(psSmooth)
Method to use to smooth edges by
softening the color transition between
edge pixels and background pixels.
PsAutoKernType
1 (psManual)
2 (psMetrics)
3 (psOptical)
The type of kerning to use for
characters.
PsBatchDestinationType
1 (psNoDestination)
2 (psSaveAndClose)
3 (psFolder)
The destination, if any, for
batch-processed files:
1: Leave all files open;
2: Save changes and close the files;
3: Save modified versions of the files to
a new location (leaving the originals
unchanged).
PsBitmapConversionType
1
2
3
4
5
(psHalfThreshold)
(psPatternDither)
(psDiffusionDither)
(psHalftoneScreen)
(psCustomPattern)
Specifies the quality of an image you
are converting to bitmap mode.
PsBitmapHalfToneType
1
2
3
4
5
6
(psHalftoneRound)
(psHalftoneDiamond)
(psHalftoneEllipse)
(psHalftoneLine)
(psHalftoneSquare)
(psHalftoneCross)
Specifies the shape of the dots (ink
deposits) in the halftone screen.
PsBitsPerChannelType
1 (psDocument1Bit)
8 (psDocument8Bits)
16 (psDocument16Bits)
32 (psDocument32Bits)
The number of bits per color channel.
157
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
158
Constant type
Values
What it means
PsBlendMode
1 (psPassThrough)
2 (psNormalBlend)
3 (psDissolve)
4 (psDarken)
5 (psMultiply)
6 (psColorBurn)
7 (psLinearBurn)
8 (psLighten)
9 (psScreen)
10 (psColorDodge)
11 (psLinearDodge)
12 (psOverlay)
13 (psSoftLight)
14 (psHardLight)
15 (psVividLight)
16 (psLinearLight)
17 (psPinLight)
18 (psDifference)
19 (psExclusion)
20 (psHue)
21 (psSaturationBlend)
22 (psColorBlend)
23 (psLuminosity)
26 (psHardMix)
27 (psLighterColor)
28 (psDarkerColor)
Controls how pixels in the image are
blended.
PsBMPDepthType
1 (psBMP1Bit)
4 (psBMP4Bits)
8 (psBMP8Bits)
16 (psBMP16Bits)
24 (psBMP24Bits)
32 (psBMP32Bits)
60 (psBMP_X1R5G5B5)
61 (psBMP_A1R5G5B5)
62 (psBMP_R5G6B5)
63 (psBMP_X4R4G4B4)
64 (psBMP_A4R4G4B4)
65 (psBMP_R8G8B8)
66 (psBMP_X8R8G8B8)
67 (psBMP_A8R8G8B8)
The number of bits per channel (also
called pixel depth or color depth). The
number selected indicates the
exponent of 2. For example, a pixel with
a bit-depth of 8 has 28, or 256, possible
color values.
PsByteOrder
1 (psIBMByteOrder)
2 (psMacOSByteOrder)
The order in which bytes will be read.
PsCameraRAWSettingsType
0 (psCameraDefault)
1 (psSelectedImage)
2 (psCustomSettings)
The default CameraRAW settings to
use: the camera settings, custom
settings, or the settings of the selected
image.
PsCameraRAWSize
0
1
2
3
4
5
The camera RAW size type options:
0 = 1536 x 1024
1 = 2048 x 1365
2 = 3072 x 2048
3 = 4096 x 2731
4 = 5120 x 4096
5 = 6144 x 4096
PsCase
1 (psNormalCase)
2 (psAllCaps)
3 (psSmallCaps)
(psMinimumCameraRAW)
(psSmallCameraRAW)
(psMediumCameraRAW)
(psLargeCameraRAW)
(psExtraLargeCameraRAW)
(psMaximumCameraRAW)
The case usage for type.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
159
Constant type
Values
What it means
PsChangeMode
1
2
3
4
5
6
7
PsChannelType
1 (psComponentChannel)
2
(psMaskedAreaAlphaChannel)
3
(psSelectedAreaAlphaChannel
)
4 (psSpotColorChannel)
The type of channel:
1: related to document color mode; 2:
Alpha channel where color indicates
masked area; 3: Alpha channel where
color indicates selected area; 4: channel
that contains spot colors.
PsColorBlendMode
2 (psNormalBlendColor)
3 (psDissolveBlend)
4 (psDarkenBlend)
5 (psMultiplyBlend)
6 (psColorBurnBlend)
7 (psLinearBurnBlend)
8 (psLightenBlend)
9 (psScreenBlend)
10 (psColorDodgeBlend)
11 (psLinearDodgeBlend)
12 (psOverlayBlend)
13 (psSoftLightBlend)
14 (psHardLightBlend)
15 (psVividLightBlend)
16 (psLinearLightBlend)
17 (psPinLightBlend)
18 (psDifferenceBlend)
19 (psExclusionBlend)
20 (psHueBlend)
21 (psSaturationBlendColor
22 (psColorBlendMode)
23 (psLuminosityBlend
24 (psBehindBlend)
25 (psClearBlend)
26 (psHardMixBlend)
Controls how pixels in the image are
blended.
PsColorModel
1 (psGrayscaleModel)
2 (psRGBModel)
3 (psCMYKModel)
4 (psLabModel)
5 (psHSBModel)
50 (psNoModel)
The color model to use.
PsColorPicker
1
2
3
4
The color picker to use.
PsColorProfileType
1 (psNo)
2 (psWorking)
3 (psCustom)
(psConvertToGrayscale)
The type of color mode to use.
(psConvertToRGB)
(psConvertToCMYK)
Note: Color images must be changed
(psConvertToLab)
to grayscale (1) mode before
(psConvertToBitmap)
you can change them to bitmap
(psConvertToIndexedColor)
(psConvertToMultiChannel)
(5) mode.
(psAdobeColorPicker)
(psAppleColorPicker)
(psWindowsColorPicker)
(psPlugInColorPicker)
The color profile type to use to manage
this document.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
160
Constant type
Values
What it means
PsColorReductionType
0
1
2
3
4
5
6
7
8
(psPerceptualReduction)
(psSelective)
(psAdaptive)
(psRestrictive)
(psCustomReduction)
(psBlackWhiteReduction)
(psSFWGrayscale)
(psMacintoshColors)
(psWindowsColors)
The color reduction algorithm option
to use.
PsColorSpaceType
0
1
2
3
(psAdobeRGB)
(psColorMatchRGB)
(psProPhotoRGB)
(psSRGB)
The type of color space to use.
PsCopyrightedType
1 (psCopyrightedWork)
2 (psPublicDomain)
3 (psUnmarked)
The copyright status of the document.
PsCreateFields
1 (psDuplication)
2 (psInterpolation)
The method to use for creating fields.
PsCropToType
0
1
2
3
4
5
The style to use when cropping a page.
PsDCSType
1 (psNoComposite)
2 (psGrayscaleComposite)
3 (psColorComposite)
(psBoundingBox)
(psMediaBox)
(psCropBox)
(psBleedBox)
(psTrimBox)
(psArtBox)
(psNoSource)
(psTransparencyChannel)
(psLayerMask)
(psImageHighlight)
The DCS format to use:
1: Does not create a composite file; 2:
Creates a grayscale composite file in
addition to DCS files; 3: Creates a color
composite file in addition to DCS files.
What to use for the depth map.
PsDepthMapSource
1
2
3
4
PsDescValueType
1 (psIntegerType)
2 (psDoubleType)
3 (psUnitDoubleType)
4 (psStringType)
5 (psBooleanType)
6 (psListType)
7 (psObjectType)
8 (psEnumeratedType)
9 (psReferenceType)
10 (psClassType)
11 (psAliasType)
12 (psRawType)
The value type of an object.
PsDialogModes
1 (psDisplayAllDialogs)
2 (psDisplayErrorDialogs)
3 (psDisplayNoDialogs)
Controls the type (mode) of dialogs
Photoshop displays when running
scripts.
PsDirection
1 (psHorizontal)
2 (psVertical)
The orientation of the object.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
161
Constant type
Values
What it means
PsDisplacementMapType
1 (psStretchToFit)
2 (psTile)
Describes how the displacement map
fits the image if the image is not the
same size as the map.
PsDitherType
1
2
3
4
The default type of dithering to use.
PsDocumentFill
1 (psWhite)
2 (psBackgroundColor)
3 (psTransparent)
The fill of the document.
PsDocumentMode
1
2
3
4
5
6
7
8
The color mode of the open document.
PsEditLogItemsType
1 (psSessionOnly)
2 (psConcise)
3 (psDetailed)
The history log edit options:
1: Save history log only for the session;
2: Save a concise history log; 3: Save a
detailed history log.
PsElementPlacement
0
1
2
3
4
The object’s position in the Layers
palette.
(psNoDither)
(psDiffusion)
(psPattern)
(psNoise)
(psGrayscale)
(psRGB)
(psCMYK)
(psLab)
(psBitmap)
(psIndexedColor)
(psMultiChannel)
(psDuotone)
(psPlaceInside)
(psPlaceAtBeginning)
(psPlaceAtEnd)
(psPlaceBefore)
(psPlaceAfter)
Note: Not all values are valid for all
object types. Please refer to the
object property definition in
VBScript Interface to make sure
you are using a valid value.
PsEliminateFields
1 (psOddFields)
2 (psEvenFields)
The type of fields to eliminate.
PsExportType
1 (psIllustratorPaths)
2 (psSaveForWeb)
The export options to use.
PsExtensionType
2 (psLowercase)
3 (psUppercase)
The formatting of the extension in the
filename.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
162
Constant type
Values
What it means
PsFileNamingType
1 (psDocumentNameMixed)
2 (psDocumentNameLower)
3 (psDocumentNameUpper)
4 (psSerialNumber1)
5 (psSerialNumber2)
6 (psSerialNumber3)
7 (psSerialNumber4)
8 (psSerialLetterLower)
9 (psSerialLetterUpper)
10 (psMmddyy)
11 (psMmdd)
12 (psYyyymmdd)
13 (psYymmdd)
14 (psYyddmm)
15 (psDdmmyy)
16 (psDdmm)
17 (psExtensionLower)
18 (psExtensionUpper)
File naming options for the batch
command.
psFontPreviewType
0
1
2
3
(psFontPreviewNone)
(psFontPreviewSmall)
(psFontPreviewMedium)
(psFontPreviewLarge)
The type size to use for font previews in
the type tool font menus.
PsForcedColors
1
2
3
4
(psNoForced)
(psBlackWhite)
(psPrimaries)
(psWeb)
The type of colors to be forced
(included) into the color table:
2: Pure black and pure white; 3: Red,
green, blue, cyan, magenta, yellow,
black, and white; 4: the 216 web-safe
colors.
PsFormatOptionsType
1 (psStandardBaseline)
2 (psOptimizedBaseline)
3 (psProgressive)
The option with which to save a JPEG
file: 1: Format recognized by most web
browsers; 2: Optimized color and a
slightly reduced file size; 3: Displays a
series of increasingly detailed scans as
the image downloads.
PsGalleryConstrainType
1 (psConstrainWidth)
2 (psConstrainHeight)
3 (psConstrainBoth)
The type of proportions to constrain for
images.
PsGalleryFontType
1
2
3
4
(psArial)
(psCourierNew)
(psHelvetica)
(psTimesNewRoman)
The fonts to use for the Web photo
gallery captions and other text.
PsGallerySecurityTextPositionType
1
2
3
4
5
(psCentered)
(psUpperLeft)
(psLowerLeft)
(psUpperRight)
(psLowerRight)
The position of the text displayed over
gallery images as an antitheft
deterrent.
PsGallerySecurityTextRotateType
1
2
3
4
5
(psZero)
(psClockwise45)
(psClockwise90)
(psCounterClockwise45)
(psCounterClockwise90)
The orientation of the text displayed
over gallery images as an antitheft
deterrent.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
163
Constant type
Values
What it means
PsGallerySecurityType
1
2
3
4
5
6
7
(psNoSecurity)
(psCustomSecurityText)
(psFilename)
(psCopyright)
(psCaption)
(psCredit)
(psTitle)
The content to use for text displayed
over gallery images as an antitheft
deterrent.
PsGalleryThumbSizeType
1
2
3
4
(psSmall)
(psMedium)
(psLarge)
(psCustomThumbnail)
The size of thumbnail images in the
web photo gallery.
PsGeometry
0
1
2
3
4
5
(psTriangle)
(psPentagon)
(psHexagon)
(psSquareGeometry)
(psHeptagon)
(psOctagon)
Geometric options for shapes, such as
the iris shape in the Lens Blur Filter.
PsGridLineStyle
1 (psGridSolidLine)
2 (psGridDashedLine)
3 (psGridDottedLine)
The line style for the nonprinting grid
displayed over images.
PsGridSize
1
2
3
4
The value of grid line spacing.
PsGuideLineStyle
1 (psGuideSolidLine)
2 (psGuideDashedLine)
The line style for nonprinting guides
displayed over images.
PsIllustratorPathType
1 (psDocumentBounds)
2 (psAllPaths)
3 (psNamedPath)
The paths to export.
PsIntent
1
2
3
4
The rendering intent to use when
converting from one color space to
another.
PsJavaScriptExecutionMode
1 (psNeverShowDebugger)
2 (psDebuggerOnError)
3 (psBeforeRunning)
The debugging behavior to use when
executing a JavaScript.
PsJustification
1
2
3
4
5
6
7
The placement of paragraph text within
the bounding box.
(psNoGrid)
(psSmallGrid)
(psMediumGrid)
(psLargeGrid)
(psPerceptual)
(psSaturation)
(psRelativeColorimetric)
(psAbsoluteColorimetric)
(psLeft)
(psCenter)
(psRight)
(psLeftJustified)
(psCenterJustified)
(psRightJustified)
(psFullyJustified)
Note: All types draw from the image’s
file information except 2.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
Constant type
Values
PsLanguage
1 (psEnglishUSA)
The language to use.
2 (psEnglishUK)
3 (psFrench)
4 (psCanadianFrench)
5 (psFinnish)
6 (psGerman)
7 (psOldGerman)
8 (psSwissGerman)
9 (psItalian)
10 (psNorwegian)
11 (psNynorskNorwegian)
12 (psPortuguese)
13 (psBrazillianPortuguese)
14 (psSpanish)
15 (psSwedish)
16 (psDutch)
17 (psDanish)
PsLayerCompressionType
1 (psRLELayerCompression)
2 (psZIPLayerCompression)
PsLayerKind
1 (psNormalLayer)
The kind of ArtLayer object.
2 (psTextLayer)
3 (psSolidFillLayer)
4 (psGradientFillLayer)
5 (psPatternfillLayer)
6 (psLevelsLayer)
7 (psCurvesLayer)
8 (psColorBalanceLayer)
9
(psBrightnessContrastLayer)
10 (psHueSaturationLayer)
11 (psSelectiveColorLayer)
12 (psChannelMixerLayer)
13 (psGradientMapLayer)
14 (psInversionLayer)
15 (psThresholdLayer)
16 (psPosterizeLayer)
17 (psSmartObjectLayer)
18 (psPhotoFilterLayer)
19 (psExposureLayer)
20 (psLayer3D)
21 (psVideoLayer)
22 (psBlackAndWhiteLayer)
23 (psVibrance)
PsLayerType
1 (psArtLayer)
2 (psLayerSet)
The kind of layer object.
PsLensType
1
2
3
5
The type of lens to use.
PsMagnificationType
0 (psActualSize)
1 (psFitPage)
(psZoomLens)
(psPrime35)
(psPrime105)
(psMoviePrime)
164
What it means
Compression methods for data for
pixels in layers.
The type of magnification to use when
viewing an image.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
165
Constant type
Values
What it means
PsMatteType
1
2
3
4
5
6
7
The color to use for matting.
PsMeasurementRange
1 (psAllMeasurements)
2 (psActiveMeasurements)
The measurement to take action upon
PsMeasurementSource
1 (psMeasureSelection)
2 (psMeasureCountTool)
3 (psMeasureRulerTool)
The source for recording
measurements
PsNewDocumentMode
1
2
3
4
5
The color profile to use for the
document.
PsNoiseDistribution
1 (psUniformNoise)
2 (psGaussianNoise)
Distribution method to use when
applying an Add Noise filter.
PsOffsetUndefinedAreas
1 (psOffsetSetToLayerFill)
2 (psOffsetWraparound)
3
(psOffsetRepeatEdgePixels)
Method to use to fill the empty space
left by offsetting a an image or
selection.
PsOpenDocumentMode
1
2
3
4
The color profile to use.
(psNoMatte)
(psForegroundColorMatte)
(psBackgroundColorMatte)
(psWhiteMatte)
(psBlackMatte)
(psSemiGray)
(psNetscapeGrayMatte)
(psNewGray)
(psNewRGB)
(psNewCMYK)
(psNewLab)
(psNewBitmap)
(psOpenGray)
(psOpenRGB)
(psOpenCMYK)
(psOpenLab)
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
166
Constant type
Values
What it means
PsOpenDocumentType
1 (psPhotoshopOpen)
2 (psBMPOpen)
3 (psCompuServeGIFOpen)
4 (psPhotoshopEPSOpen)
5 (psFilmstripOpen)
6 (psJPEGOpen)
7 (psPCXOpen)
8 (psPhotoshopPDFOpen)
9 (psPhotoCDOpen)
10 (psPICTFileFormatOpen)
11
(psPICTResourceFormatOpen)
12 (psPixarOpen)
13 (psPNGOpen)
14 (psRawOpen)
15 (psScitexCTOpen)
16 (psTargaOpen)
17 (psTIFFOpen)
18 (psPhotoshopDCS_1Open)
19 (psPhotoshopDCS_2Open)
21 (psPDFOpen)
22 (psEPSOpen)
23 (psEPSPICTPreviewOpen)
24 (psEPSTIFFPreviewOpen)
25 (psAliasPIXOpen)
26 (psElectricImageOpen)
27 (psPortableBitmapOpen)
28 (psWavefrontRLAOpen)
29 (psSGIRGBOpen)
30 (psSoftImageOpen)
31 (psWirelessBitmapOpen)
32 (psCameraRAWOpen)
33 (psDICOMOpen)
The format in which to open a
document.
PsOperatingSystem
1 (psOS2)
2 (psWindows)
The operating system.
PsOrientation
1 (psLandscape)
2 (psPortrait)
The page orientation.
PsOtherPaintingCursors
1 (psStandardOther)
2 (psPreciseOther)
The pointer for the following tools:
Eraser, Pencil, Paintbrush, Healing
Brush, Rubber Stamp, Pattern Stamp,
Smudge, Blur, Sharpen, Dodge, Burn,
Sponge.
PsPaintingCursors
1 (psStandard)
2 (psPrecise)
3 (psBrushsize)
The pointer for the following tools:
Marquee, Lasso, Polygonal Lasso, Magic
Wand, Crop, Slice, Patch Eyedropper,
Pen, Gradient, Line, Paint Bucket,
Magnetic Lasso, Magnetic Pen,
Freeform Pen, Measure, Color Sampler.
Note: psPhotoCDOpen (8) is
deprecated. Kodak PhotoCD is
now found in the Goodies folder
on the Adobe Photoshop CS4
Install DVD.
Note: The psDICOMOpen (33) option
is for the Extended version only.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
167
Constant type
Values
What it means
PsPaletteType
1 (psExact)
2 (psMacOSPalette)
3 (psWindowsPalette
4 (psWebPalette)
5 (psUniform)
6 (psLocalPerceptual)
7 (psLocalSelective)
8 (psLocalAdaptive)
9 (psMasterPerceptual)
10 (psMasterSelective)
11 (psMasterAdaptive)
12 (psPreviousPalette)
The palette type to use.
PsPathKind
1
2
3
4
5
(psNormalPath)
(psClippingPath)
(psWorkPath)
(psVectorMask)
(psTextMask)
The type of path.
PsPDFCompatibilityType
1
2
3
4
(psPDF13)
(psPDF14)
(psPDF15)
(psPDF16)
The PDF version to make the document
compatible with.
PsPDFEncoding
0 (psPDFNone)
1 (psPDFZip)
2 (psPDFJPEG)
3 (psPDFPDFZip4Bit)
4 (psPDFJPEGHIGH)
5 (psPDFJPEGMEDHIGH)
6 (psPDFJPEGMED)
7 (psPDFJPEGMEDLOW)
8 (psPDFJPEGLOW)
9 (psPDFJPEG2000High)
10 (psPDFJPEG2000MEDHIGH)
11 (psPDFJPEG2000MED)
12 (psPDFJPEG2000MEDLOW)
13 (psPDFJPEG2000LOW)
14 (psPDFJPEG2000LOSSLESS)
Encoding and compression options to
use when saving a document in PDF
format.
PsPDFResampleType
0
1
2
3
(psNoResample)
(psPDFAverage)
(psPDFSubSample)
(psPDFBicubic)
The down sample method to use.
PsPDFStandardType
0
1
2
3
4
(psNoStandard)
(psPDFX1A2001)
(psPDFX1A2003)
(psPDFX32002)
(psPDFX32003)
The PDF standard to make the
document compatible with.
PsPhotoCDColorSpace
1
2
3
4
(psRGB8)
(psRGB16)
(psLab8)
(psLab16)
The color space to use when creating a
Photo CD.
Note: Deprecated for Adobe
Photoshop CS4. Kodak PhotoCD
is now found in the Goodies
folder on the Adobe Photoshop
CS4 Install DVD.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
Constant type
Values
What it means
PsPhotoCDSize
1
2
3
4
5
6
The pixel dimensions of the image.
(psMinimumPhotoCD)
(psSmallPhotoCD)
(psMediumPhotoCD)
(psLargePhotoCD)
(psExtralargePhotoCD)
(psMaximumPhotoCD)
168
psMinimumPhotoCD = 64x96
psSmallPhotoCD = 128x192
psMediumPhotoCD = 256x384
psLargePhotoCD = 512x768
psExtralargePhotoCD = 1024x1536
psMaximumPhotoCD = 2048x3072
Note: Deprecated for Adobe
Photoshop CS4. Kodak PhotoCD
is now found in the Goodies
folder on the Adobe Photoshop
CS4 Install DVD.
2 (psPICTTwoBits)
4 (psPICTFourBits)
8 (psPICTEightBits)
16 (psPICTSixteenBits)
32 (psPICTThirtyTwoBits)
The number of bits per pixel to use
when compression a PICT file.
PsPICTCompression
1
2
4
5
6
(psNoPICTCompression)
(psJPEGLowPICT)
(psJPEGMediumPICT)
(psJPEGHighPICT)
(psJPEGMaximumPICT)
The type of compression to use when
saving an image as a PICT file.
PsPicturePackageTextType
1
2
3
4
5
6
7
(psNoText)
(psUserText)
(psFilenameText)
(psCopyrightText)
(psCaptionText)
(psCreditText)
(psOriginText)
The function or meaning of text in a
Picture Package.
PsPointKind
1 (psSmoothPoint)
2 (psCornerPoint)
The role a PathPoint plays in a
PathItem.
PsPointType
1 (psPostScriptPoints)
2 (psTraditionalPoints)
The kind of measurement to use for
type points: 1 = 72 points/inch; 2 =
72.27 points/inch.
PsPolarConversionType
1 (psRectangularToPolar)
2 (psPolarToRectangular)
The method of polar distortion to use.
PsPreviewType
1 (psNoPreview)
2 (psMonochromeTIFF)
3 (psEightbitTIFF)
The type of image to use as a
low-resolution preview in the
destination application.
PsPrintEncoding
1 (psBinaryEncoding)
2 (psJPEGEncoding)
3 (psAsciiEncoding)
The type of encoding to use.
PsPurgeTarget
1
2
3
4
Cache to be targeted in a purge
operation.
PsPICTBitsPerPixels
(psUndoCaches)
(psHistoryCaches)
(psClipboardCache)
(psAllCaches)
Note: Use 16 or 32 for RGB images; use
2, 4, or 8 for bitmap and
grayscale images.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
169
Constant type
Values
What it means
PsQueryStateType
1 (psAlways)
2 (psAsk)
3 (psNever)
Permission state for queries.
PsRadialBlurMethod
1 (psSpin)
2 (psZoom)
The blur method to use.
PsRadialBlurQuality
1 (psRadialBlurDraft)
2 (psRadialBlurGood)
3 (psRadialBlurBest)
The smoothness or graininess of the
blurred image.
PsRasterizeType
1
2
3
4
5
6
The layer element to rasterize.
PsReferenceFormType
1 (psReferenceNameType)
The type of an ActionReference object.
2 (psReferenceIndexType)
3
(psReferenceIdentifierType)
4 (psReferenceOffsetType)
5
(psReferenceEnumeratedType)
6 (psReferencePropertyType)
7 (psReferenceClassType)
PsResampleMethod
1
2
3
4
5
6
PsRippleSize
1 (psSmallRipple)
2 (psMediumRipple)
3 (psLargeRipple)
The undulation size to use.
PsSaveBehavior
1 (psNeverSave)
2 (psAlwaysSave)
3 (psAskWhenSaving)
The application’s behavior when a Save
method is called.
(psTextContents)
(psShape)
(psFillContent)
(psLayerClippingPath)
(psEntireLayer)
(psLinkedLayers)
(psNoResampling)
(psNearestNeighbor)
(psBilinear)
(psBicubic)
(psBicubicSharper)
(psBicubicSmoother)
The method to use for image
interpolation.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
170
Constant type
Values
What it means
PsSaveDocumentType
1 (psPhotoshopSave)
2 (psBMPSave)
3 (psCompuServeGIFSave)
4 (psPhotoshopEPSSave)
6 (psJPEGSave)
7 (psPCXSave)
8 (psPhotoshopPDFSave)
10 (psPICTFileFormatSave)
12 (psPixarSave)
13 (psPNGSave)
14 (psRawSave)
15 (psScitexCTSave)
16 (psTargaSave)
17 (psTIFFSave)
18 (psPhotoshopDCS_1Save)
19 (psPhotoshopDCS_2Save)
25 (psAliasPIXSave)
26 (psElectricImageSave)
27 (psPortableBitmapSave)
28 (psWavefrontRLASave)
29 (psSGIRGBSave)
30 (psSoftImageSave)
31 (psWirelessBitmapSave)1
The format in which to save a
document.
PsSaveEncoding
1
2
3
4
5
6
The type of encoding to use when
saving a file.
PsSaveLogItemsType
1 (psMetadata)
2 (psLogFile)
3 (psLogFileAndMetadata)
The location of history log data.
PsSaveOptions
1 (psSaveChanges)
2 (psDoNotSaveChanges)
3 (psPromptToSaveChanges)
The save options to use when the
Close method is called to close a
document.
PsSelectionType
1
2
3
4
(psReplaceSelection)
(psExtendSelection)
(psDiminishSelection)
(psIntersectSelection)
The selection behavior when a
selection already exists:
1: Replace the selected area;
2: Add the selection to an already
selected area;
3: Remove the selection from the
already selected area;
4: Make the selection only the area
where the new selection intersects the
already selected area.
PsShapeOperation
1
2
3
4
(psShapeAdd)
(psShapeXOR)
(psShapeIntersect)
(psShapeSubtract)
A subPathItem object’s behavior
when it intersects another
subPathItem object.
PsSmartBlurMode
1 (psSmartBlurNormal)
2 (psSmartBlurEdgeOnly)
3 (psSmartBlurOverlayEdge)
(psBinary)
(psJPEGLow)
(psAscii)
(psJPEGMedium)
(psJPEGHigh)
(psJPEGMaximum)
The method to use for smart blurring:
1 : Apply blur to entire image;
2, 3 : Apply blur only to edges of color
transitions.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
171
Constant type
Values
What it means
PsSmartBlurQuality
1 (psSmartBlurLow)
2 (psSmartBlurMedium)
3 (psSmartBlurHigh)
The blur quality to use.
PsSourceSpaceType
1 (psDocumentSpace)
2 (psProofSpace)
The color space for source when
printing.
PsSpherizeMode
1 (psNormalSpherize)
2 (psHorizontalSpherize)
3 (psVerticalSpherize)
The curve (or stretch shape) to use for
the distortion.
PsStrikeThruType
1 (psStrikeOff)
2 (psStrikeHeight)
3 (psStrikeBox)
The style of strikethrough to use.
PsStrokeLocation
1 (psInsideStroke)
2 (psCenterStroke)
3 (psOutsideStroke)
The placement of path or selection
boundary strokes.
PsTargaBitsPerPixels
16 (psTarga16Bits)
24 (psTarga24Bits)
32 (psTarga32Bits)
The resolution to use when saving an
image in Targa format.
PsTextComposer
1 (psAdobeSingleLine)
2 (psAdobeEveryLine)
The composition method to use to
optimize the specified hyphenation
and justification options.
PsTextType
1 (psPointText)
2 (psParagraphText)
The type of text: 1: Text that does not
wrap; 2: Text that wraps within a
bounding box.
PsTextureType
1
2
3
4
5
(psBlocksTexture)
(psCanvasTexture)
(psFrostedTexture)
(psTinyLensTexture)
(psTextureFile)
The type of texture or glass surface
image to load for a texturizer or glass
filter.
PsTIFFEncodingType
1
2
3
4
(psNoTIFFCompression)
(psTiffLZW)
(psTiffJPEG)
(psTiffZIP)
The encoding to use for TIFF files.
PsToolType
1 (psPencil)
The tool selection.
2 (psBrush)
3 (psEraser)
4 (psBackgroundEraser)
5 (psCloneStamp)
6 (psPatternStamp)
7 (psHealingBrush)
8 (psHistoryBrush)
9 (psArtHistoryBrush)
10 (psSmudge)
11 (psBlur)
12 (psSharpen)
13 (psDodge)
14 (psBurn)
15 (psSponge)
16 (psColorReplacementTool)
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
172
Constant type
Values
What it means
PsTransitionType
1 (psBlindsHorizontal)
2 (psBlindsVertical)
3 (psDissolveTransition)
4 (psBoxIn)
5 (psBoxOut)
6 (psGlitterDown)
7 (psGlitterRight)
8 (psGlitterRightDown)
9 (psNoTransition)
10 (psRandom)
11 (psSplitHorizontalIn)
12 (psSplitHorizontalOut)
13 (psSplitVerticalIn)
14 (psSplitVerticalOut)
15 (psWipeDown)
16 (psWipeLleft)
17 (psWipeRight)
18 (psWipeUp)
The method to use to transition from
one image to the next in a PDF
presentation.
PsTrimType
0 (psTransparentPixels)
1 (psTopLeftPixel)
9 (psBottomRightPixel
Type of pixels to trim around an image:
9 = bottom right pixel color;
1 = top left pixel color.
PsTypeUnits
1 (psTypePixels)
4 (psTypeMM)
5 (psTypePoints)
The unit to use for measuring text
characters.
PsUndefinedAreas
1 (psWrapAround)
2 (psRepeatEdgePixels)
The method to use to treat undistorted
areas or areas left blank in an image to
which the a filter in the Distort category
has been applied.
PsUnderlineType
1 (psUnderlineOff)
2 (psUnderlineRight)
3 (psUnderlineLeft)
The placement of text underlining.
PsUnits
1
2
3
4
5
6
7
(psPixels)
(psInches)
(psCM)
(psMM)
(psPoints)
(psPicas)
(psPercent)
The measurement unit for type and
ruler increments.
PsUrgency
0
1
2
3
4
5
6
7
8
(psNone)
(psLow)
(psTwo)
(psThree)
(psFour)
(psNormal)
(psSix)
(psSeven)
(psHigh)
The editorial urgency of the artwork.
Note: 3 and 2 are valid only when
PsDirection = 2.
Adobe Photoshop CS4
VBScript Scripting Reference
Scripting Constants
173
Constant type
Values
What it means
PsWarpStyle
1 (psNone)
2 (psArc)
3 (psArcLower)
4 (psArcUpper)
5 (psArch)
6 (psBulge)
7 (psShellLower)
8 (psShellUpper)
9 (psFlag)
10 (psWave)
11 (psFish)
12 (psRise)
13 (psFishEye)
14 (psInflate)
15 (psSqueeze)
16 (psTwist)
The warp style to use.
PsWaveType
1 (psSine)
2 (psTriangular)
3 (psSquare)
The type of wave to use.
PsWhiteBalanceType
0
1
2
3
4
5
6
7
8
The lighting conditions to use (affects
color balance).
PsZigZagType
1 (psAroundCenter)
2 (psOutFromCenter)
3 (psPondRipples)
(psAsShot)
(psAuto)
(psDaylight)
(psCloudy)
(psShade)
(psTungsten)
(psFluorescent)
(psFlash)
(psCustomCameraSettings)
The method of zigzagging to use.
Appendix A: Event ID Codes
The following table lists events and their four-character ID codes or string identifiers for use with the
Notifier object.
Note: Do not include single quotes ( ' ) with four-character IDs in your code. The single quotes are
used in this table to illustrate the placement of required spaces in codes that do not contain four
letters. However, string identifiers, which are longer than four characters, require double quotes in
the code.
Tip: If you can’t find the event you want to use for notification in this table, you can use ScriptListener to
determine the event ID code. See the ScriptListener documentation in the Action Manager chapter of
the Photoshop CS4 Scripting Guide.
Event
4-char ID or String
3DTransform
'TdT '
Average
'Avrg'
ApplyStyle
'ASty'
Assert
'Asrt'
AccentedEdges
'AccE'
Add
'Add '
AddNoise
'AdNs'
AddTo
'AddT'
Align
'Algn'
All
'All '
AngledStrokes
'AngS'
ApplyImage
'AppI'
BasRelief
'BsRl'
Batch
'Btch'
BatchFromDroplet
'BtcF'
Blur
'Blr '
BlurMore
'BlrM'
Border
'Brdr'
Brightness
'BrgC'
CanvasSize
'CnvS'
ChalkCharcoal
'ChlC'
ChannelMixer
'ChnM'
174
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
175
Event
4-char ID or String
Charcoal
'Chrc'
Chrome
'Chrm'
Clear
'Cler'
Close
'Cls '
Clouds
'Clds'
ColorBalance
'ClrB'
ColorHalftone
'ClrH'
ColorRange
'ClrR'
ColoredPencil
'ClrP'
ContactSheet
"0B71D221-F8CE-11d2-B21B-0008C75B322
C"
ConteCrayon
'CntC'
Contract
'Cntc'
ConvertMode
'CnvM'
Copy
'copy'
CopyEffects
'CpFX'
CopyMerged
'CpyM'
CopyToLayer
'CpTL'
Craquelure
'Crql'
CreateDroplet
'CrtD'
Crop
'Crop'
Crosshatch
'Crsh'
Crystallize
'Crst'
Curves
'Crvs'
Custom
'Cstm'
Cut
'cut '
CutToLayer
'CtTL'
Cutout
'Ct
DarkStrokes
'DrkS'
DeInterlace
'Dntr'
DefinePattern
'DfnP'
Defringe
'Dfrg'
Delete
'Dlt '
Desaturate
'Dstt'
'
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
176
Event
4-char ID or String
Deselect
'Dslc'
Despeckle
'Dspc'
DifferenceClouds
'DfrC'
Diffuse
'Dfs '
DiffuseGlow
'DfsG'
DisableLayerFX
'dlfx'
Displace
'Dspl'
Distribute
'Dstr'
Draw
'Draw'
DryBrush
'DryB'
Duplicate
'Dplc'
DustAndScratches
'DstS'
Emboss
'Embs'
Equalize
'Eqlz'
Exchange
'Exch'
Expand
'Expn'
Export
'Expr'
Jumpto
'Jpto'
ExportTransparentImage
"02879e00-cb66-11d1-bc43-0060b0a13dc
4"
Extrude
'Extr'
Facet
'Fct '
Fade
'Fade'
Feather
'Fthr'
Fibers
'Fbrs'
Fill
'Fl
FilmGrain
'FlmG'
Filter
'Fltr'
FindEdges
'FndE'
FitImage
"3caa3434-cb67-11d1-bc43-0060b0a13dc
4"
FlattenImage
'FltI'
Flip
'Flip'
Fragment
'Frgm'
'
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
Event
4-char ID or String
Fresco
'Frsc'
GaussianBlur
'GsnB'
Get
'getd'
Glass
'Gls '
GlowingEdges
'GlwE'
Gradient
'Grdn'
GradientMap
'GrMp'
Grain
'Grn '
GraphicPen
'GraP'
Group
'GrpL'
Grow
'Grow'
HalftoneScreen
'HlfS'
Hide
'Hd
HighPass
'HghP'
HSBHSL
'HsbP'
HueSaturation
'HStr'
ImageSize
'ImgS'
Import
'Impr'
InkOutlines
'InkO'
Intersect
'Intr'
IntersectWith
'IntW'
Inverse
'Invs'
Invert
'Invr'
LensFlare
'LnsF'
Levels
'Lvls'
LightingEffects
'LghE'
Link
'Lnk '
Make
'Mk
Maximum
'Mxm '
Median
'Mdn '
MergeLayers
'Mrg2'
MergeLayersOld
'MrgL'
MergeSpotChannel
'MSpt'
'
'
177
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
178
Event
4-char ID or String
MergeVisible
'MrgV'
Mezzotint
'Mztn'
Minimum
'Mnm '
ModeChange
"8cba8cd6-cb66-11d1-bc43-0060b0a13dc
4"
Mosaic
'Msc '
Mosaic_PLUGIN
'MscT'
MotionBlur
'MtnB'
Move
'move'
NTSCColors
'NTSC'
NeonGlow
'NGlw'
Next
'Nxt '
NotePaper
'NtPr'
Notify
'Ntfy'
Null
typeNull
OceanRipple
'OcnR'
Offset
'Ofst'
Open
'Opn '
Paint
'Pnt '
PaintDaubs
'PntD'
PaletteKnife
'PltK'
Paste
'past'
PasteEffects
'PaFX'
PasteInto
'PstI'
PasteOutside
'PstO'
Patchwork
'Ptch'
Photocopy
'Phtc'
PicturePackage
"4C1ABF40-DD82-11d2-B20F-0008C75B322
C"
Pinch
'Pnch'
Place
'Plc '
Plaster
'Plst'
PlasticWrap
'PlsW'
Play
'Ply '
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
179
Event
4-char ID or String
Pointillize
'Pntl'
Polar
'Plr '
PosterEdges
'PstE'
Posterize
'Pstr'
Previous
'Prvs'
Print
'Prnt'
ProfileToProfile
'PrfT'
Purge
'Prge'
Quit
'quit'
RadialBlur
'RdlB'
Rasterize
'Rstr'
RasterizeTypeSheet
'RstT'
RemoveBlackMatte
'RmvB'
RemoveLayerMask
'RmvL'
RemoveWhiteMatte
'RmvW'
Rename
'Rnm '
ReplaceColor
'RplC'
Reset
'Rset'
ResizeImage
"1333cf0c-cb67-11d1-bc43-0060b0a13dc
4"
Reticulation
'Rtcl'
Revert
'Rvrt'
Ripple
'Rple'
Rotate
'Rtte'
RoughPastels
'RghP'
Save
'save'
Select
'slct'
SelectiveColor
'SlcC'
Set
'setd'
SharpenEdges
'ShrE'
Sharpen
'Shrp'
SharpenMore
'ShrM'
Shear
'Shr '
Show
'Shw '
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
Event
4-char ID or String
Similar
'Smlr'
SmartBlur
'SmrB'
Smooth
'Smth'
SmudgeStick
'SmdS'
Solarize
'Slrz'
Spatter
'Spt '
Spherize
'Sphr'
SplitChannels
'SplC'
Sponge
'Spng'
SprayedStrokes
'SprS'
StainedGlass
'StnG'
Stamp
'Stmp'
Stop
'Stop'
Stroke
'Strk'
Subtract
'Sbtr'
SubtractFrom
'SbtF'
Sumie
'Smie'
TakeMergedSnapshot
'TkMr'
TakeSnapshot
'TkSn'
TextureFill
'TxtF'
Texturizer
'Txtz'
Threshold
'Thrs'
Tiles
'Tls '
TornEdges
'TrnE'
TraceContour
'TrcC'
Transform
'Trnf'
Trap
'Trap'
Twirl
'Twrl'
Underpainting
'Undr'
Undo
'undo'
Ungroup
'Ungr'
Unlink
'Unlk'
UnsharpMask
'UnsM'
180
Adobe Photoshop CS4
VBScript Scripting Reference
Appendix A: Event ID Codes
Event
4-char ID or String
Variations
'Vrtn'
Wait
'Wait'
WaterPaper
'WtrP'
Watercolor
'Wtrc'
Wave
'Wave'
Wind
'Wnd '
ZigZag
'ZgZg'
BackLight
'BacL'
FillFlash
'FilE'
ColorCast
'ColE'
181
Index
A
Action Manager
scripting objects 8
actions
executing 18
active links 78
Add Noise filter 25
adjust
contrast 29
AdjustBrightnessContrast 24
adjusting
brightness 24
color balance 24
colors 157
component channels 31
curves 24
highlights 32
layers color balance 31
levels 25, 29
shadows 32
temperature 31
Adobe Photoshop CS 2
activating 17
new features 5
version 17
alpha channels
defined 42
anchor points
path point info 114
path points 113
anchor position
types 157
annotations 63
anti alias
text 148
types 157
application
activating 17
checking if feature enabled 19
code sample 21
location 16
preferences 127
version 17
art layers, See layers
Asian text 129
Average filter 25
B
background color
application 16
galleries 78
background layer
designating 23
finding 59
Batch command
destination folder 36
batch command
destination types 157
input folder 18
beep 127
bitmap documents
converting to 38
opening 166
saving 39
bitmap images
See bitmap documents 38
BitmapConversionOptions 38
black and white images 32
blend modes 158
Blur filter 25
blur filters
Average 25
Blur 25
Blur More 25
Gaussian Blur 26
Lens Blur 27
Motion Blur 28
Radial Blur 28
Smart Blur 29
Blur More filter 25
BMP documents
opening 166
saving 39
brightness
adjusting 24
camera shots 40
equalizing 30
C
caches
histograms 128
images 128
purging 20
camera raw documents
opening 40, 166
canvases
resizing 64
rotating 63
captions
contact sheets 52
galleries 79
channels
activating 59
adding 43, 55
alpha See alpha channels
code sample 43
182
Adobe Photoshop CS4
VBScript Scripting Reference
component See component channels 24
composite See composite channels
creating 55
deleting 42
displaying in color 127
making visible 42
merging (spot) 42
mixing 31
splitting 65
spot See spot channels
types of 159
clipping paths
creating 108
from text 153
Clouds filter 25
CMYK color 49
color picker 127, 159
color samplers
adding 51
creating 51
deleting 50
moving 50
colors
adjusting 24
blend modes 158
CMYK 49
comparing 141
forced 85, 162
gray 87
HSB 90
Lab 94
links 78
none 104
RGB 134
selective 32
solid color objects 141
component channels
color balance adjustments 24
defined 42
displaying in color 127
enabling 98
listing 59
merging with spot channels 42
mixing 31
composite channel
defined 42
Compuserve GIF documents
opening 166
saving 85
contact sheets
captions 52
dimensions 53
formatting 52
making 19
contrast
adjusting 24
adjusting automatically 29
copyrights 68, 160
cursors 128
curves
Index
adjusting 24
defining 28
Custom filter 25
D
DCS1 documents
opening 166
saving 56
DCS2 documents
opening 166
saving 57
default units 129
De-Interlace filter 25
Deprecated 19
Despeckle filter 25
dialogs
displaying 16
modes 160
DICOM format documents
opening 58
Difference Clouds filter 25
Diffuse Glow filter 25
Displace filter 25
distort filters
Diffuse Glow 25
Displace 25
Glass Effect 26
Ocean Ripple 28
Pinch 28
Polar Coordinates 28
Ripple 28
Shear 28
Spherize 29
Twirl 29
Wave 29
Zigzag 29
documents
activating 16
adding 71
closing 62
color samplers 59
colors 59
counting items 60
counting objects 62
creating 71
cropping 63
exporting 63
loading 19
managed 60
measurement scale 60
metadata 24, 61, 68
open with Photoshop dialog 20
opening 20
printing 64
sample code 66
saving 65
size 60
specifying author 68
title 69
183
Adobe Photoshop CS4
VBScript Scripting Reference
trapping (CMYK) 65
trimming 65
Dust & Scratches filter 26
E
edit log 127
EPS documents
opening 72, 166
saving 73
equalizing, brightness values 30
event IDs
using ScriptListener to find 174
events, associating with actions 107
EXIF 68
exporting
documents 63
paths 74
to Illustrator 74
to the web 74
type of 161
Index
saving 85
Glass Effect filter 26
GrayColor 87
grid options 128
guide options 128
H
High Pass filter 26
highlights 24, 32
histograms
caches 128
channels 42
code sample 43
documents 60
history states
activating 59
number of 128
snapshot 88
HSBColor 90
I
F
IDs
file extensions, case of 161
file types
Macintosh 16
naming 162
Windows 17
files
extensions 130
merging 19
naming types 162
Filmstrips, opening 166
filters
See individual filter names
fonts
contact sheets 52
family 146
finding 16
gallery banners 77
gallery type 163
picture packages 123
PostScript names 146
foreground color 16
string to type 20
type to char 20
type to string 20
images
black and white 32
cache level 128
gallery 79
previews 128
resizing 64
indexed color model 91
G
galleries
banners 77
constrain types 162
font type 163
image options 79
making 19
photographer 77
security options 83
security type 163
thumbnails 84
Gaussian Blur filter 26
GIF documents
opening 166
J
JavaScript
executing from VBScript 18
JPEG documents
opening 166
saving 93
justification 150, 163
K
kerning
types of 157
keyboard options 128
keywords 69
L
Lab color 94
layer comps
adding 96
applying 95
using visibility in 95
layer sets
adding 100
finding layers in 98
linking 99
184
Adobe Photoshop CS4
VBScript Scripting Reference
Index
making visible 98
moving 99
nesting 98
opacity 98
sample code 100
unlinking 99
layer styles 29
layers
activating 59
adding 35
adjusting 24–25
applying filters 25–29
applying styles to 29
background 23
clipboard commands 29–31
counting 97
flattening 64
grouping 23
kind 23
linking 30
locking contents 23–24
making visible 24
merging 30
rasterizing 31, 64
sample code 32
types 164
left direction points 113
path point info 114
Lens Blur filter
applying 27
Lens Flare filter 27
levels
adjusting 25
adjusting automatically 29
link colors
active 78
visited 78
linking layers 30
N
M
P
Macintosh
compatibility in Batch command 36
file types 16
Maximum filter 27
Median Noise filter 27
memory, available 16
merging
channels 42
files 19
layer sets 99
layers 30
layers (in copy command) 135
visible layers 64
metadata 156
midtones 24
Minimum filter 28
Motion Blur filter 28
palette locations 129
paragraph text 171
path items
adding 112
clipping path 108
filling 108
from selections 136
making selection 109
path segments 142
sample code 109
selecting 108
stroking 109
path point info
anchor points 114
left/right direction points 114
subpath info items 142
path points
anchor points 113
defined 115
left/right direction points 113
nearest web color, finding 141
new features 5
noise filters
Add Noise 25
Despeckle 25
Dust & Scratches 26
Median Noise 27
notifiers
adding 107
associating with actions 107
event IDs 174
removing 105
NTSC filter 28
O
Ocean Ripple filter 28
Offset filter 28
opacity
channels 42
layer sets 98
layers 23
picture packages 123
open options
Camera RAW format 40
DICOM format 58
EPS format 72
PDF format 116
Photo CD format 120
raw format 132
optimizing 74, 75
other filters
Custom 25
High Pass 26
Maximum 27
Minimum 28
Offset 28
185
Adobe Photoshop CS4
VBScript Scripting Reference
paths
See path items
PCX documents
opening 166
PDF documents
opening 116, 166
saving 117
PDF presentations
auto advance 131
code sample 22
making 19
transition type 131, 172
photo galleries
See galleries
Photo Merge 19
PhotoCD documents, opening 120, 166
Photoshop CS 2, See Adobe Photoshop CS 2
Photoshop documents
opening 166
saving 121
Photoshop PDF documents, opening 166
PICT files
opening 166
saving 122
PICT resources
opening 166
picture packages
flattening layers in 123
making 19
specifying options 123
Pinch filter 28
Pixar documents
opening 166
saving 124
plug-in
folders 130
PNG documents
opening 166
saving 103, 125
point text 171
points
corner 168
PostScript 168
size 129
smooth 168
Polar Coordinates filter 28
PostScript font names 146
preferences 127
printing 64
Pro Photo CD discs, opening files from 120
property
measurementLog 16
PSD documents
opening 166
saving 121
psVideoLayer 164
purging, caches 20
Index
Q
Quick Mask mode 60
R
Radial Blur filter 28
rasterizing 31
raw documents
opening 132, 166
saving 133
RecordMeasurements 64
render filters
Clouds 25
Difference Clouds 25
Lens Flare 27
RGBColor 134
right direction points
defining 113
path point info 114
Ripple filter 28
ruler units 129, 172
S
save as 65
saving
See individual document formats
Compuserve GIF documents 85
ESP documents 73
GIF documents 85
JPEG documents 93
PDF documents 117
Photoshop documents 121
PICT files 122
Pixar documents 124
PNG documents 125
PSD documents 121
raw documents 133
SGIRGB documents 140
TIFF documents 154
scripting build date 17
scripting interface, new features 5
ScriptingVersion 17
Scripts Events Manager 16
security, galleries 83
selections
clearing 135
creating paths from 136
filling 135
from paths 109
inverting 136
resizing 136
sample code 137
selective color 32
SGIRGB documents
opening 166
saving 140, 157
shadows 24, 32
Sharpen Edges filter 28
Sharpen filter 28
sharpen filters
186
Adobe Photoshop CS4
VBScript Scripting Reference
Sharpen 28
Sharpen Edges 28
Sharpen More 28
Unsharp Mask 29
Sharpen More filter 28
Shear filter 28
Smart Blur filter 29
smart quotes 129
Spherize filter 29
spot channels
defined 42
merging 42
styles, applying 29
SystemInformation 17
T
Targa documents
opening 166
saving 145
text
Asian 129
creating paths from 153
creating selections from 153
fonts 149
formatting 148
gallery security 83
hyphenation 150
justification 150
paragraph 171
picture packages 123
point 171
warping 153
text layers
contents 24, 148
creating 23, 164
sample code 100
Texture Fill filter 29
threshold 32
thumbnails 84
sizes 163
specifications 84
TIFF documents
opening 166
saving 154
tool tips, displaying 129
Index
trapping 65
Twirl filter 29
type units 129, 172
U
units
defaults 129
ruler 129, 172
type 129, 172
Unix, compatibility in Batch commands 37
Unsharp Mask filter 29
urgency 69
UTF8 encoding 82
V
video filters
De-Interlace 25
NTSC 28
visibility
application 17
channels 42
layer sets 98
layers 24
visited links 78
W
warp 153
Wave filter
applying 29
type 173
web snap 76
white balance 41, 173
Windows
color settings 17
compatibility in Batch commands 37
file types 17
X
xml 156
xmp metadata 156
Z
Zigzag filter 29
187
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.4 Linearized : No Encryption : Standard V1.3 (40-bit) User Access : Print, Annotate, Fill forms, Extract, Assemble, Print high-res Page Mode : UseOutlines XMP Toolkit : Adobe XMP Core 4.0-c316 44.253921, Sun Oct 01 2006 17:14:39 Format : application/pdf Creator : Adobe Systems Incorporated Description : Scripting Photoshop CS4 using VBScript Title : Adobe Photoshop CS4 VBScript Scripting Reference Subject : Photoshop, VBScript, Scripting, Creative Suite Create Date : 2008:07:16 09:12:44Z Creator Tool : FrameMaker 7.2 Modify Date : 2008:07:16 09:20:08-07:00 Metadata Date : 2008:07:16 09:20:08-07:00 Producer : Acrobat Distiller 8.1.0 (Windows) Keywords : "Photoshop, VBScript, Scripting, Creative Suite" Copyright : Adobe Systems, Inc. 2007 Document ID : uuid:704cba52-28b6-4fc8-9825-cac57b44dcc2 Instance ID : uuid:9ae9d4b3-a799-418a-98e3-c3b6de6d95c8 Page Count : 187 Author : Adobe Systems IncorporatedEXIF Metadata provided by EXIF.tools