Preferences

Options to define for the preferences property of the application object, basically equivalent to selecting Edit > Preferences (Windows) or Photoshop > Preferences in the Adobe Photoshop application.

Property Listing

Property

Type

Access

Description

additionalPluginFolder

File

read/write

The path to the additional plug-in folder. Valid only when 'use additional plugin folder' = true.

appendExtension

SaveBehavior

SaveBehavior.NEVERSAVE

SaveBehavior.ALWAYSSAVE

SaveBehavior.ASKWHENSAVING

read/write

Save files with extensions on Windows.

askBeforeSavingLayeredTIFF

Boolean

read/write

If true, asks the user to verify layer preservation options when saving a file in TIFF format.

autoUpdateOpenDocuments

Boolean

read/write

If true, automatically updates open documents.

beepWhenDone

Boolean

read/write

If true, alerts the user when a process finishes.

colorChannelsInColor

Boolean

read/write

If true, displays component channels in the Channels palette in color.

colorPicker

ColorPicker

ColorPicker.ADOBE

ColorPicker.APPLE

ColorPicker.WINDOWS

ColorPicker.PLUGIN

read/write

The color picker to use.

columnGutter

Number

read/write

The gutter of columns (in points)

columnWidth

Number

read/write

The width of columns (in points)

createFirstSnapshot

Boolean

read/write

If true, automatically makes the first snapshot when a new document is created.

dynamicColorSliders

Boolean

read/write

If true, dynamic color sliders appear in the Color palette.

editLogItems

EditLogItemsType

EditLogItemsType.SESSIONONLY

EditLogItemsType.CONCISE

EditLogItemsType.DETAILED

read/write

Options for edit log items.

exportClipboard

Boolean

read/write

If true, retains Adobe Photoshop contents on the clipboard after you exit the application.

fontPreviewSize

FontPreviewType

FontPreviewType.NONE

FontPreviewType.SMALL

FontPreviewType.MEDIUM

FontPreviewType.LARGE

FontPreviewType.EXTRALARGE

FontPreviewType.HUGE

read/write

Show font previews in the type tool font menus.

fullSizePreview

Boolean

read/write

If true, shows the image preview as a full size image.

gamutWarningOpacity

Number (range 0 - 100)

read/write

The opacity (as a percentage) of the warning color for out-of-gamut colors. Range: 0 to 100.

gridSize

GridSize

GridSize.NONE

GridSize.SMALL

GridSize.MEDIUM

GridSize.LARGE

read/write

The size of grid squares.

gridStyle

GridLineStyle

GridLineStyle.SOLID

GridLineStyle.DASHED

GridLineStyle.DOTTED

read/write

The formatting style for non-printing grid lines.

gridSubDivisions

Int

read/write

The value by which to subdivide the grid.

guideStyle

GuideLineStyle

GuideLineStyle.SOLID

GuideLineStyle.DASHED

read/write

The formatting style for non-printing guide lines.

iconPreview

Boolean

read/write

If true, shows the image preview as a thumbnail.

imageCacheForHistograms

Boolean

read/write

If true, shows the current image cache used to create the histogram.

imageCacheLevels

Int (range 1 - 8)

read/write

The number of images to hold in the cache. Range: 1 to 8.

imagePreviews

SaveBehavior

SaveBehavior.NEVERSAVE

SaveBehavior.ALWAYSSAVE

SaveBehavior.ASKWHENSAVING

read/write

The behavior mode to use when saving files.

interpolation

ResampleMethod

ResampleMethod.NONE

ResampleMethod.NEARESTNEIGHBOR

ResampleMethod.BILINEAR

ResampleMethod.BICUBIC

ResampleMethod.BICUBICSHARPER

ResampleMethod.BICUBICSMOOTHER

ResampleMethod.BICUBICAUTOMATIC

ResampleMethod.AUTOMATIC

ResampleMethod.PRESERVEDETAILS

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

If true, automatically resizes the window when zooming in or out using keyboard shortcuts.

macOSThumbnail

Boolean

read/write

If true, creates a thumbnail when saving the image in Mac OS.

maxRAMuse

Int (range 5 - 100)

read/write

Maximum percentage of available RAM used by Photoshop.

maximizeCompatibility

QueryStateType

QueryStateType.ALWAYS

QueryStateType.ASK

QueryStateType.NEVER

read/write

The behavior to use to check whether to maximize compatibility when opening Adobe Photoshop (PSD) files.

nonLinearHistory

Boolean

read/write

If true, allows non-linear history.

numberOfHistoryStates

Int (range 1 - 100)

read/write

The number of history states to preserve. Range: 1 to 100.

otherCursors

OtherPaintingCursors

OtherPaintingCursors.STANDARDOTHER

OtherPaintingCursors.PRECISEOTHER

read/write

The type of pointer to use.

paintingCursors

PaintingCursors

PaintingCursors.STANDARD

PaintingCursors.PRECISE

PaintingCursors.BRUSHSIZE

read/write

The type of pointer to use.

parent

 

readonly

The object's container.

pixelDoubling

Boolean

read/write

If true, halves the resolution or (doubles the size of pixels) to make previews display more quickly.

pointSize

PointType

PointType.POSTSCRIPT

PointType.TRADITIONAL

read/write

The point/pica size.

recentFileListLength

Int (range 0 - 30)

read/write

The number of items in the recent file list. Range: 0 to 30.

rulerUnits

Units

Units.PIXELS

Units.INCHES

Units.CM

Units.MM

Units.POINTS

Units.PICAS

Units.PERCENT

read/write

The unit that the scripting system uses when receiving and returning values.

saveLogItems

SaveLogItemsType

SaveLogItemsType.METADATA

SaveLogItemsType.LOGFILE

SaveLogItemsType.LOGFILEANDMETADATA

read/write

Options for saving the history items.

saveLogItemsFile

File

read/write

File to save the history log.

savePaletteLocations

Boolean

read/write

If true, makes new palette locations the default location.

showAsianTextOptions

Boolean

read/write

If true, Asian text options are displayed in the Paragraph palette.

showEnglishFontNames

Boolean

read/write

If true, Asian font names are listed in English.

showSliceNumber

Boolean

read/write

If true, displays slice numbers in the document window when using the Slice tool.

showToolTips

Boolean

read/write

If true, pop-up definitions are displayed on mouseover.

smartQuotes

Boolean

read/write

If true, curly quote marks are used.

textFontSize

FontSize

FontSize.SMALL

FontSize.MEDIUM

FontSize.LARGE

read/write

Size of the small font used in panels and dialogs.

typeUnits

TypeUnits

TypeUnits.PIXELS

TypeUnits.MM

TypeUnits.POINTS

read/write

The unit type-size that the numeric inputs are assumed to represent.

typename

String

readonly

The class name of the object.

useAdditionalPluginFolder

Boolean

read/write

If true, uses an additional folder for compatible plug-ins stored with a different application.

useDiffusionDither

Boolean

read/write

If true, uses diffusion dither.

useHistoryLog

Boolean

read/write

Turn on and off the history logging.

useLowerCaseExtension

Boolean

read/write

If true, the file extension is lowercase.

useShiftKeyForToolSwitch

Boolean

read/write

If true, enables cycling through a set of hidden tools.

useVideoAlpha

Boolean

read/write

If true, enables Adobe Photoshop to send transparency information to your computer’s video board. (Requires hardware support.)

windowsThumbnail

Boolean

read/write

If true, creates a thumbnail when saving the image in Windows. (Requires hardware support.)

Object of

Application.preferences