Adobe Data Distiller

0 views

Skip to first unread message

Jaunita Rousu

unread,

Aug 3, 2024, 5:04:06 PM8/3/24

to facbartsigu

This chapter describes the Adobe PDF settings that belong to the Common namespace. (See Namespaces.) These settings have historically been documented in Acrobat Distiller Parameters . They are supported by Distiller and may be supported by one or more of the applications in the Creative Suite, version 2.0 and later. The settings in other namespaces are described in Other Namespaces.

The settings are grouped into the same categories that appear in the Distiller user interface (UI). The Creative Suite applications have similar interfaces for PDF creation settings, although they may differ in some respects. More information on the use of Adobe PDF settings can be found in Help for Distiller and the Creative Suite applications.

Allows Distiller to automatically orient (rotate) pages based on the predominant text orientation. Auto-rotation is not done if the file contains the %%ViewingOrientation DSC comment and ParseDSCComments is true. If AutoRotatePages is set to None , pages are not automatically oriented and the %%ViewingOrientation DSC comment is ignored.

Controls object-level compression, introduced in PDF 1.5. PDF objects that are not individually compressible can be combined into object streams that can be efficiently compressed. Only PDF consumers that support PDF 1.5 can process object streams.

PDF 1.5 object compression is applied to the logical structure tree in a document. Versions 5 and earlier of Acrobat and Adobe Reader can open and use these documents, but cannot use the logical structure (tag) information. Versions 6 and later have full access to the tag information.

Creative Suite applications do not provide a user interface for this setting. For InDesign, if GenerateStructure (in the CreativeSuite namespace) is true , Tagged PDF is generated and this setting is set to Tags (if CompatibilityLevel is 1.5 or higher). A value of All will be treated as Tags by Creative Suite applications.

Provides a description of the Adobe PDF settings file that can be displayed in the UI. Each key in the dictionary is a standard 3-letter language code; for example, ENU for English (see the Acrobat and PDF Library API Reference for a listing of these codes). The value associated with each language key is a string that contains the description of the settings file in that language. It is assumed that the string will be reflowed to fit the width of the display field.

StartPage and EndPage together determine the range of pages in the PostScript file that are converted to PDF. If StartPage is greater than 1 (the default), no PDF output is produced for the first (StartPage -1 ) pages of PostScript. StartPage becomes page 1 of the PDF file. If EndPage is greater than -1 , distilling stops after the EndPage of PostScript. Distiller checks these two settings at the time that the first PostScript marking operator is executed in a job.

This setting identifies the namespace to which all other settings in the same settings dictionary belong. This setting may appear in any namespace. For the Common namespace, it is optional. For all other namespaces, it is required. See Namespaces for more information.

Anti-aliasing increases the number of bits per component in downsampled images to preserve some of the information that is otherwise lost by downsampling. Anti-aliasing is only performed if the image is actually downsampled and ColorImageDepth has a value greater than the number of bits per color component in the input image.

If true , the compression filter for color images is chosen based on the properties of each image, in conjunction with the ColorImageAutoFilterStrategy setting. See Automatic compression for more information.

Dictionary of parameters for JPEG compression when JPEG is chosen from the Automatic filter selection (see AutoFilterColorImages). ColorACSImageDict is based on the DCTEncode parameter dictionary described in Section 3.13.3 in the PostScript Language Reference .

Applies only when CompatibilityLevel is set to 1.5 or higher. Lossy JPEG2000 compression is used for low-frequency images (images with smooth color changes) and lossless JPEG2000 compression for high-frequency images.

Sets the downsample threshold for color images. This is the ratio of image resolution to output resolution above which downsampling may be performed. Must be between 1.0 through 10.0, inclusive. If you set the threshold out of range, it reverts to a default of 1.5.

For compatibility with Distiller 3.0 Adobe PDF settings files, Distiller 6.0 and later (as well as Creative Suite applications) revert to Flate compression if this setting is set to LZWEncode. Other values cause Distiller to stop with a range error.

A warning is issued every time a sampled color image with resolution smaller than the value specified by ColorImageMinResolution is placed in the PDF file. The job continues after issuing the warning.

Specifies the resolution to which downsampled color images are reduced; valid values are 9 to 2400 pixels per inch. A color image is downsampled if DownsampleColorImages is true and the resolution of the input image meets the criteria described in Downsampling and subsampling images.

If true , Distiller converts images that use fewer than 257 colors to an indexed color space for compactness. This conversion, when enabled, produces smaller PDF files but may make distillation slower.

If true , color images are downsampled using the resolution specified by ColorImageResolution , assuming the threshold specified by ColorImageDownsampleThreshold is met. If false , downsampling is not done and the resolution of color images in the PDF file is the same as the source images.

If true , Distiller permits anti-aliasing on grayscale images. Anti-aliasing increases the number of bits per component in downsampled images to preserve some of the information that is otherwise lost by downsampling. Anti-aliasing is only performed if the image is actually downsampled and GrayImageDepth has a value greater than the number of bits per sample in the input image. For more information, see Controlling bit depth.

If true , the compression filter for gray images is chosen based on the properties of each image, in conjunction with the GrayImageAutoFilterStrategy setting. See Automatic compression for more information. If false , all color sampled images are compressed using the filter specified by GrayImageFilter. This setting is relevant only if EncodeGrayImages is true.

If true , grayscale images are downsampled using the resolution specified by GrayImageResolution. If false , downsampling does not occur, and the resolution of grayscale images in the PDF file is the same as the source images.

Applies only if CompatibilityLevel is set to 1.5 or higher. Lossy JPEG2000 compression is used for low-frequency images (images with smooth color changes) and lossless JPEG2000 compression for high-frequency images.

DCTEncode is used only if the output image has 8 bits per sample; otherwise FlateEncode is used. For compatibility with Distiller 3.0 Adobe PDF settings files, Distiller 6.0 and later (as well as Creative Suite applications) revert to Flate compression if this setting is set to LZWEncode.

Imposes a lower limit to the resolution of sampled grayscale images. The legal values are from 9 to 64000, inclusive. How this value is used by Distiller is determined by GrayImageMinResolutionPolicy. For more information, see Specifying a minimum resolution of sampled images.

A warning is issued every time a sampled grayscale image with resolution smaller than the value specified by GrayImageMinResolution is placed in the PDF file. The job continues after issuing the warning.

Specifies the resolution to which downsampled gray images are reduced. Valid values are 9 to 2400 pixels per inch. A gray image is downsampled if DownsampleGrayImages is true and the resolution of the input image meets the criteria described in Downsampling and subsampling images.

This section lists the compression and downsampling settings for monochrome images (images with only one color component and one bit per sample). See Monochrome (black and white) images for more information.

With the exception of the AntiAliasMonoImages and MonoImageDepth settings, the compression settings also can be applied to stencil masks created by the imagemask operator. Settings behavior is the same in both cases. For details on imagemask , see the PostScript Language Reference .

Anti-aliasing increases the number of bits per sample in downsampled images to preserve some of the information that is otherwise lost by downsampling. Anti-aliasing is only performed if the image is actually downsampled and MonoImageDepth has a value greater than 1. For more information on anti-aliasing see Controlling bit depth.

If true , monochrome images are downsampled using the resolution specified by MonoImageResolution. If false , downsampling is not done and the resolution of monochrome images in the PDF file is the same as the source images.

Dictionary of parameters for CCITT compression. MonoImageDict is based on the CCITTFaxEncode parameter dictionary. A value of -1 for K corresponds to CCITT Group 4; 0 corresponds to CCITT group 3. See Monochrome (black and white) images for more information.

Sets the image downsample threshold for monochrome images. This is the ratio of image resolution to output resolution above which downsampling may be performed. See Downsampling and subsampling images for more information.

Imposes a lower limit to the resolution of sampled monochrome images. The legal values are from 9 to 64000, inclusive. How this value is used by Distiller is determined by MonoImageMinResolutionPolicy. For more information, see Specifying a minimum resolution of sampled images.

A warning is issued every time a sampled monochrome image with resolution smaller than the value specified by MonoImageMinResolution is placed in the PDF file. The job continues after issuing the warning.