Other Namespaces¶
This chapter describes the settings that belong to namespaces other than the Common
namespace. See Namespaces for information on how namespaces are organized.
CreativeSuite namespace settings¶
The following settings belong to the CreativeSuite
namespace. They are supported by one or more of the applications in Creative Suite version 2.0 and later (llustrator, InDesign, and Photoshop). The entries for each setting indicate which applications support it.
AddBleedMarks¶
If true
, bleed marks are included in the PDF file.
Supported by
InDesign
Type
Boolean
UI name
Add Bleed Marks
Default value
false
AddColorBars¶
If true
, color bars are included in the PDF file.
Supported by
Illustrator, InDesign
Type
Boolean
UI name
Color Bars
Default value
false
AddCropMarks¶
If true
, crop marks are included in the PDF file.
Supported by
Illustrator, InDesign
Type
Boolean
UI name
InDesign: Crop Marks
Illustrator: Trim Marks
Default value
false
AddPageInfo¶
If true
, page information (document name, page number, and time stamp) are included in the PDF file.
Supported by
Illustrator, InDesign
Type
Boolean
UI name
Page Information
Default value
false
AddRegMarks¶
If true
, registration marks are included in the PDF file.
Supported by
Illustrator, InDesign
Type
Boolean
UI name
Registration Marks
Default value
false
BleedOffset¶
An array of four floating point numbers with values between 0.0 to 432.0, representing the offsets of the bleed in points from the top, left, bottom, and right edges of the document.
In InDesign, if UseDocumentBleed
is true
, the bleed values are taken from the document bleed rather than the value of this setting.
Supported by
Illustrator, InDesign
Type
array
UI name
Bleeds
Default value
[0.0, 0.0, 0.0, 0.0]
ConvertColors¶
Specifies whether colors should be converted to CMYK or RGB. The following table shows the valid values.
Value |
UI equivalent |
Description |
---|---|---|
NoConversion |
No Color Conversion |
Colors are not converted. |
ConvertToCMYK |
See below |
Colors are converted to CMYK |
ConvertToRGB |
See below |
Colors are converted to RGB. |
ConvertToCMYK
or ConvertToRGB
do not map precisely to the UI options, which are “Convert to Destination” or “Convert to Destination (preserve numbers)”. The “destination” referred to is a specified by the appropriate profile (CMYK or RGB) and additional settings. See Using the color conversion settings for more details.
Note
When converting to CMYK, the resulting Common settings are supported by Distiller 7.0, but previous versions of Distiller did not support conversion to CMYK.
Supported by
Illustrator, InDesign, Photoshop
Type
name
UI name
Color Conversion
Default value
NoConversion
DestinationProfileName¶
When the value of DestinationProfileSelector
is UseName
, this setting specifies the name of the destination profile to be used.
When the value of DestinationProfileSelector
is one of the document or working space profiles, Creative Suite applications store the profile name in this setting when saving the settings. This enables determining whether a setting has been changed outside the application. For example, when converting to CMYK:
If the value of this setting is a profile name, it should be the same as that of
CalCMYKProfile
. Different profile names imply thatCalCMYKProfile
was changed in Distiller; therefore, Creative Suite applications will useCalCMYKProfile
instead ofDestinationProfileName
.If the value of this setting is the empty string, Creative Suite applications will use the document CMYK profile regardless of the value of
CalCMYKProfile
.
Supported by
Illustrator, InDesign, Photoshop
Type
string
UI name
Destination
DestinationProfileSelector¶
Specifies which destination color profile should be used. The following table shows the valid values.
Value |
UI equivalent |
Description |
---|---|---|
NA |
N/A |
No profile |
UseName |
Any named profile |
The profile specified by |
WorkingCMYK |
Working CMYK |
The effective working CMYK profile is used. The profile name is also written to |
WorkingRGB |
Working RGB |
The effective working RGB profile is used. |
DocumentCMYK |
Document CMYK |
The effective document CMYK profile is used. The profile name is also written to |
DocumentRGB |
Document RGB |
The effective document RGB profile is used. |
Supported by
all applications
Type
name
UI name
Destination
Default value
NA
Downsample16BitImages¶
If true
, 16 bits-per-channel images are converted to 8 bits-per-channel images. If false
, 16-bit images are not converted, and Flate (ZIP) is the only compression method available.
This setting is available only if CompatibilityLevel
is 1.5 or greater. For 1.4 or earlier, 16-bit images are always converted to 8 bits per channel.
Supported by
Photoshop
Type
Boolean
UI name
Convert 16 Bit/Channel Image to 8 Bit/Channel
Default value
true
FlattenerPreset¶
A dictionary that specifies a preset or set of options for flattening transparency. One of the entries is PresetSelector
, which is a string corresponding to a preset file. It can correspond to one of the preset files that specify transparency flattening: LowResolution
, MediumResolution
, or HighResolution
. It can also take the value UseName
, which means that the PresetName
entry specifies the name of the preset file.
The other entries are: ClipComplexRegions
, ConvertStrokesToOutlines
, ConvertTextToOutlines
, GradientResolution
, LineArtTextResolution
, and RasterVectorBalance
. See Creative Suite application Help for more information on these transparency flattening options.
Note
This setting applies only when CompatibilityLevel
is 1.3; that is, for PDF versions where transparency is not supported.
Supported by
Illustrator, InDesign
Type
dictionary
UI name
Transparency Flattener: Preset
Default value
<</PresetSelector /MediumResolution>>
GenerateStructure¶
If true
, a Tagged PDF document is generated. Tagged PDF contains information about the logical structure of the document that can be used to provide document reflow, improved accessibility, and interchange with other file formats. See the PDF Reference for more information on Tagged PDF.
If CompatibilityLevel
is 1.5 or later (that is, Acrobat 6 or later compatibility is chosen), tags are compressed for smaller file size.
Supported by
InDesign
Type
Boolean
UI name
Create Tagged PDF
Default value
false
IncludeBookmarks¶
A Boolean value to include bookmarks, defined in an InDesign document, in generated PDF.
Supported by
InDesign
Type
Boolean
UI name
Bookmarks
Default value
false
If true
, bookmarks are included in generated PDF.
IncludeHyperlinks¶
A Boolean value to include hyperlinks in generated PDF.
Supported by
InDesign
Type
Boolean
UI name
Hyperlinks
Default value
false
If true
, hyperlinks are included in generated PDF.
IncludeInteractive¶
If true
, interactive elements should be included in the PDF document. These can be:
Multimedia elements : If true
, the MultimediaHandling
setting controls how the elements should be included.
Supported by
InDesign
Type
Boolean
UI name
Interactive Elements
Default value
false
IncludeLayers¶
If true
, layers (optional content) are included in generated PDF; available in PDF 1.5 or later.
Supported by
Illustrator, InDesign
Type
Boolean
UI name
Create Acrobat Layers
Default value
false
IncludeProfiles¶
If false
, color profiles are not included in generated PDF. This corresponds to Don’t Include Profiles in the UI. If true
, which profiles are included is dependent on the value of other settings. See Creative Suite color conversion settings for details.
Supported by
Illustrator, InDesign, Photoshop
Type
Boolean
UI name
Profile Inclusion Policy
Default value
false
MarksOffset¶
A floating-point number between 0.0
and 6.0
indicating the printer offset in points.
Supported by
Illustrator, InDesign
Type
number
UI name
Offset
Default value
0
MarksWeight¶
A floating-point number between 0.125
and 0.5
indicating the line weight in points to be used for printer’s marks.
Supported by
Illustrator, InDesign
Type
number
UI name
InDesign: Weight
Illustrator: Trim Mark Weight
Default value
0.25
MultimediaHandling¶
Specifies how multimedia objects (movies and sounds) are referenced in the PDF file. This setting is relevant only if IncludeInteractive
is true
. Valid values are:
Value |
UI equivalent |
Description |
---|---|---|
UseObjectSettings |
Automatic |
If
|
LinkAll |
Link All |
All objects are linked when |
EmbedAll |
Embed All |
All objects are embedded. This setting is valid only when |
Embedding means that the multimedia object is included in the PDF file itself. Linking means that the PDF file contains a reference to an external file. (The user should make sure that the media files are in the same directory as the PDF file.)
Supported by
InDesign
Type
name
UI name
Multimedia
Default value
UseObjectSettings
PageMarksFile¶
Specifies selection of the page marks file. Valid values are:
RomanDefault
: Use the built-in Roman page marks fileJapaneseWithCircle
: Use the built-in Japanese (with circle) page marks file.JapaneseNoCircle
: Use the built-in Japanese (with no circle) page marks file.UseName
: Use the value ofPageMarksFileName
for the page marks file
The files presented in the user interface vary according to application and language.
Supported by
Illustrator, InDesign
Type
name
UI name
InDesign: “Type” pop-up
Illustrator: Printer Mark Type
Default value
RomanDefault
PageMarksFileName¶
If PageMarksFile
has the value UseName
, this setting represents the page marks file that should be used.
Supported by
Illustrator, InDesign
Type
string
UI name
Page mark file name
Default value
""
PDFXOutputIntentProfileSelector¶
Specifies the PDF/X output intent profile to be used for PDF/X compliance. The values are similar to those for the DestinationProfileSelector
setting.
Valid values are:
Value |
UI equivalent |
Description |
---|---|---|
NA |
N/A |
Indicates that no PDF/X compliance standard has been specified. |
UseName |
Any named profile |
The profile specified by |
WorkingCMYK |
Working CMYK |
The effective working CMYK profile is used as the PDF/X output intent profile. |
WorkingRGB |
Working RGB |
The effective working RGB profile is used as the PDF/X output intent profile. |
DocumentCMYK |
Document CMYK |
The effective document CMYK profile is used as the PDF/X output intent profile. |
DocumentRGB |
Document RGB |
The effective document RGB profile is used as the PDF/X output intent profile. |
Note
When color management is on and PDF/X compliance has been specified, the effective profiles specified by DestinationProfileName
, CalCMYKProfile
and PDFXOutputIntentProfile
must be the same.
See Using the PDF/X output intent settings for more information about how this setting is used along with the other standards settings.
Supported by
Illustrator, InDesign, Photoshop
Type
name
UI name
Output Intent Profile Name
Default value
DocumentCMYK
PreserveEditing¶
If true
, data is saved in the PDF that allows you to subsequently re-open and edit the data in the authoring application.
Note
This capability is not available when specifying PDF/X compliance (see CheckCompliance).
Supported by
Illustrator, Photoshop
Type
Boolean
UI name
Preserve application name Editing Capabilities
Default value
true
UntaggedCMYKHandling¶
Specifies whether untagged CMYK content (content with no embedded profiles) should be tagged. Valid values are:
LeaveUntagged
: Do not add profiles to untagged objects.UseDocumentProfile
: Use document CMYK profile for untagged objects.
Note
In InDesign and Illustrator, this value applies to placed content originating in other applications. Native content is treated as inherently untagged unless the option to include all profiles is chosen.
See Using the color conversion settings for details of how these settings interact with the other color settings and how they appear in the UI.
Supported by
Illustrator, InDesign, Photoshop
Type
name
UI name
Output panel: Color
Default value
LeaveUntagged
UntaggedRGBHandling¶
Specifies whether untagged RGB content (content with no embedded profiles) should be tagged. Valid values are:
LeaveUntagged
: Do not add profiles to untagged objects.UseDocumentProfile
: Use document RGB profile for untagged objects.
See Using the color conversion settings for details of how these settings interact with the other color settings and how they appear in the UI.
Supported by
all applications
Type
name
UI name
Output panel: Color
Default value
UseDocumentProfile
UseDocumentBleed¶
If true
, the bleed values (otherwise specified by BleedOffset
) are populated based on the document’s bleed.
Supported by
InDesign
Type
Boolean
UI name
Use Document Bleed
Default value
false
InDesign namespace settings¶
The following settings belong to the InDesign
namespace. They are supported by InDesign only.
AsReaderSpreads¶
If true
, spreads are exported as single PDF pages. A spread is a set of pages that are viewed together, such as the two pages that are visible when a magazine is opened.
Type
Boolean
UI name
Spreads
Default value
false
CropImagesToFrames¶
If true
, only data that represents the visible (non-cropped) part of an image is exported in the PDF file.
Note
InDesign crops images to the visible portion of the frame. Distiller has settings for cropping (see Disabling of image cropping) that use the clip area.
Type
Boolean
UI name
Crop Image Data to Frames
Default value
true
ErrorControl¶
Specifies what should be done when errors occur when generating a PDF file. The following table shows the valid values.
Value |
Description |
---|---|
WarnAndContinue |
A warning dialog box is issued. The user can choose to continue and the PDF file will be produced. If the UI is disabled in scripting, the dialog box is automatically dismissed. |
Ignore |
Errors are ignored. |
CancelJob |
No PDF file is produced. |
Type
name
UI name
none (supported via scripting)
Default value
WarnAndContinue
FlattenerIgnoreSpreadOverrides¶
If true
, transparency flattener settings are applied to all spreads in a document, overriding the flattener settings for individual spreads.
Type
Boolean
UI name
Ignore Spread Overrides
Default value
false
IncludeGuidesGrids¶
If true
, visible grids and guides will appear in the PDF document.
Type
Boolean
UI name
Visible Guides and Baseline Grids
Default value
false
IncludeNonPrinting¶
If true
, non-printing objects (which have had the Nonprinting option applied in the Attributes palette) will appear in the PDF document.
Type
Boolean
UI name
Non-Printing Objects
Default value
false
IncludeSlug¶
If true
, the slug area (an area outside the page and bleed that contains information such as printer instructions) is included in the PDF document.
Type
Boolean
UI name
Include Slug area
Default value
false
OmitPlacedBitmaps¶
If true
, imported bitmap images are not included in the PDF document but are replaced by OPI comments.
Type
Boolean
UI name
Omit for OPI: bitmap images
Default value
false
OmitPlacedEPS¶
If true
, imported Encapsulated PostScript (EPS) images are not included in the PDF document but are replaced by OPI comments.
Type
Boolean
UI name
Omit for OPI: EPS
Default value
false
OmitPlacedPDF¶
If true
, PDF that has been placed (imported) into the document is not included in the PDF document but are replaced by OPI comments.
Type
Boolean
UI name
Omit for OPI: PDF
Default value
false
SimulateOverprint¶
Simulates the appearance of printing separations by maintaining the appearance of overprinting in composite output. The following values are valid.
Value |
UI equivalent |
Description |
---|---|---|
Legacy |
unchecked |
Preserve overprint & spot colors when flattening. |
SimulatePress |
checked |
Spot colors are changed to process equivalents. The transparency flattener simulates the appearance of overprinted objects using process colors. |
This setting applies only when the following conditions are met:
CompatibilityLevel
is 1.3 (Acrobat 4) or earlier (that is, when transparency is not supported)There is a CMYK or RGB output color space.
Type
name
UI name
Simulate Overprint check box
Default value
Legacy