.. _Preferences: ================================================ Preferences ================================================ Description ----------- 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. Properties ^^^^^^^^^^ +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`additionalPluginFolder` readonly | The path to the additional plug-in folder. Valid only when 'use additional plugin folder' = true. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`appendExtension` readonly | Save files with extensions on Windows. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`askBeforeSavingLayeredTIFF` readonly | If true, asks the user to verify layer preservation options when saving a file in TIFF format. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`autoUpdateOpenDocuments` readonly | If true, automatically updates open documents. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`beepWhenDone` readonly | If true, alerts the user when a process finishes. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`colorChannelsInColor` readonly | If true, displays component channels in the Channels palette in color. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`colorPicker` readonly | The color picker to use. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`columnGutter` readonly | The gutter of columns (in points) | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`columnWidth` readonly | The width of columns (in points) | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`createFirstSnapshot` readonly | If true, automatically makes the first snapshot when a new document is created. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`dynamicColorSliders` readonly | If true, dynamic color sliders appear in the Color palette. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`editLogItems` readonly | Options for edit log items. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`exportClipboard` readonly | If true, retains Adobe Photoshop contents on the clipboard after you exit the application. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`fontPreviewSize` readonly | Show font previews in the type tool font menus. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`fullSizePreview` readonly | If true, shows the image preview as a full size image. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`gamutWarningOpacity` readonly | The opacity (as a percentage) of the warning color for out-of-gamut colors. Range: 0 to 100. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`gridSize` readonly | The size of grid squares. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`gridStyle` readonly | The formatting style for non-printing grid lines. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`gridSubDivisions` readonly | The value by which to subdivide the grid. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`guideStyle` readonly | The formatting style for non-printing guide lines. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`iconPreview` readonly | If true, shows the image preview as a thumbnail. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`imageCacheForHistograms` readonly | If true, shows the current image cache used to create the histogram. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`imageCacheLevels` readonly | The number of images to hold in the cache. Range: 1 to 8. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`imagePreviews` readonly | The behavior mode to use when saving files. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`interpolation` readonly | The method to use to assign color values to any new pixels created when an image is resampled or resized. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`keyboardZoomResizesWindows` readonly | If true, automatically resizes the window when zooming in or out using keyboard shortcuts. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`macOSThumbnail` readonly | If true, creates a thumbnail when saving the image in Mac OS. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`maxRAMuse` readonly | Maximum percentage of available RAM used by Photoshop. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`maximizeCompatibility` readonly | The behavior to use to check whether to maximize compatibility when opening Adobe Photoshop (PSD) files. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`nonLinearHistory` readonly | If true, allows non-linear history. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`numberOfHistoryStates` readonly | The number of history states to preserve. Range: 1 to 100. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`otherCursors` readonly | The type of pointer to use. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`paintingCursors` readonly | The type of pointer to use. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`parent` readonly | The object's container. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`pixelDoubling` readonly | If true, halves the resolution or (doubles the size of pixels) to make previews display more quickly. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`pointSize` readonly | The point/pica size. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`recentFileListLength` readonly | The number of items in the recent file list. Range: 0 to 30. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`rulerUnits` readonly | The unit that the scripting system uses when receiving and returning values. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`saveLogItems` readonly | Options for saving the history items. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`saveLogItemsFile` readonly | File to save the history log. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`savePaletteLocations` readonly | If true, makes new palette locations the default location. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`showAsianTextOptions` readonly | If true, Asian text options are displayed in the Paragraph palette. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`showEnglishFontNames` readonly | If true, Asian font names are listed in English. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`showSliceNumber` readonly | If true, displays slice numbers in the document window when using the Slice tool. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`showToolTips` readonly | If true, pop-up definitions are displayed on mouseover. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`smartQuotes` readonly | If true, curly quote marks are used. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`textFontSize` readonly | Size of the small font used in panels and dialogs. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`typeUnits` readonly | The unit type-size that the numeric inputs are assumed to represent. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`typename` readonly | The class name of the object. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`useAdditionalPluginFolder` readonly | If true, uses an additional folder for compatible plug-ins stored with a different application. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`useDiffusionDither` readonly | If true, uses diffusion dither. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`useHistoryLog` readonly | Turn on and off the history logging. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`useLowerCaseExtension` readonly | If true, the file extension is lowercase. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`useShiftKeyForToolSwitch` readonly | If true, enables cycling through a set of hidden tools. | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`useVideoAlpha` readonly | If true, enables Adobe Photoshop to send transparency information to your computer?s video board. (Requires hardware support.) | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ | :ref:`windowsThumbnail` readonly | If true, creates a thumbnail when saving the image in Windows. (Requires hardware support.) | +------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ .. container:: hide .. toctree:: :hidden: :maxdepth: 1 Preferences/parent.rst Preferences/typename.rst Preferences/colorPicker.rst Preferences/interpolation.rst Preferences/exportClipboard.rst Preferences/showToolTips.rst Preferences/keyboardZoomResizesWindows.rst Preferences/autoUpdateOpenDocuments.rst Preferences/showAsianTextOptions.rst Preferences/beepWhenDone.rst Preferences/dynamicColorSliders.rst Preferences/savePaletteLocations.rst Preferences/showEnglishFontNames.rst Preferences/useShiftKeyForToolSwitch.rst Preferences/textFontSize.rst Preferences/numberOfHistoryStates.rst Preferences/createFirstSnapshot.rst Preferences/nonLinearHistory.rst Preferences/smartQuotes.rst Preferences/imagePreviews.rst Preferences/iconPreview.rst Preferences/fullSizePreview.rst Preferences/macOSThumbnail.rst Preferences/windowsThumbnail.rst Preferences/appendExtension.rst Preferences/useLowerCaseExtension.rst Preferences/askBeforeSavingLayeredTIFF.rst Preferences/maximizeCompatibility.rst Preferences/recentFileListLength.rst Preferences/colorChannelsInColor.rst Preferences/useDiffusionDither.rst Preferences/pixelDoubling.rst Preferences/paintingCursors.rst Preferences/otherCursors.rst Preferences/gridSize.rst Preferences/useVideoAlpha.rst Preferences/gamutWarningOpacity.rst Preferences/rulerUnits.rst Preferences/typeUnits.rst Preferences/columnWidth.rst Preferences/columnGutter.rst Preferences/pointSize.rst Preferences/guideStyle.rst Preferences/gridStyle.rst Preferences/gridSubDivisions.rst Preferences/showSliceNumber.rst Preferences/useAdditionalPluginFolder.rst Preferences/additionalPluginFolder.rst Preferences/imageCacheLevels.rst Preferences/imageCacheForHistograms.rst Preferences/maxRAMuse.rst Preferences/useHistoryLog.rst Preferences/saveLogItems.rst Preferences/editLogItems.rst Preferences/saveLogItemsFile.rst Preferences/fontPreviewSize.rst