PDF HandShake UB+ Benutzerhandbuch


14 Präferenzen

Hinweis: Dieses Kapitel wurde nicht übersetzt, um die Eindeutigkeit der Beschreibung zu bewahren.

This chapter lists all the preferences that are pertinent to PDF HandShake. Find a description of how to set, view, change or delete preferences, with the HELIOS utility programs " prefdump", "prefvalue", and "prefrestore", in the Base manual.

Important: Make sure that preference keys DO NOT start or end with a slash ("/") character, and note that they are case-sensitive! Also, if any preference key or preference value includes spaces, that key or value must be enclosed in quotes.

14.1 Globale PDF Präferenzen

Key: Global/Opi/<preference>
Preference
Type Default (""=empty string)
PDFNativeWorkflow
bool TRUE

Enforces the generation of PDF-native workflow compatible layout images from vector-based EPS images, even if TIFF layout images are supposed to be generated, e.g. via a "%t" folder syntax.

This key requires a restart of "opisrv" to take effect.

PDFPageBox
str "CropBox"

Specifies the page box of PDF documents to be used for output. PDF page objects always contain a MediaBox entry and may specify boxes within the MediaBox as CropBox, BleedBox, TrimBox and ArtBox. Valid values of this preference are: "MediaBox", "CropBox", "BleedBox", "TrimBox", "ArtBox".

IgnoreUntagged
bool FALSE

If DefaultPrinterProfile is not set or the ImageServer preference CheckICCProfiles is set to FALSE, this preference has no effect. Otherwise this option determines whether errors are generated for color source images that are not tagged with an ICC profile and which are not excluded from color matching via PreserveDeviceN.

AutomaticLayout
bool TRUE

(HELIOS Admin option PDF OPI Layout Generation)

Enables the automatic generation of layout files from PDF files in volumes where layout generation is enabled. You can set the preference to FALSE if you want PDF files to be excluded from automatic layout generation.

For this preference, the key must be extended to:
Global/Opi/Formats/PDF ///AutomaticLayout

14.2 PDF-Manager Präferenzen

Key: Library/OpenImage/ManagerPrivate/HeliosPDF
/<preference>

AntiAlias
bool TRUE

(HELIOS Admin option Antialias Screen Preview)

If set to TRUE, the screen preview in layout files, generated from PDF documents, is smoothed to offer an enhanced readability. This is recommended for monitor screen resolutions up to 96 dpi.

RGBProfilePath
str "sRGB_IEC61966-2-1_noBPC.icc"

(HELIOS Admin option Default RGB Profile)

Specifies the profile which is used as source profile for color data transformation of all RGB objects in PDF files that have not been tagged with a specific RGB profile.

CMYKProfilePath
str "Euro 2.6 UCR-370"

(HELIOS Admin option Default CMYK Profile)

Specifies the profile which is used as source profile for color data transformation of all CMYK objects in PDF files that have not been tagged with a specific CMYK profile.

VMSize
uint 61440000

This parameter controls the PDF HandShake virtual RIP memory (in bytes) for creating screen previews in layout files from PDF files. You should use the parameter to enter a value higher than the default - lower values are not recommended.

GVMSize
uint 10240000

This parameter controls the PDF HandShake global virtual RIP memory (in bytes) for creating screen previews in layout files from PDF files. You should use the parameter to enter a value higher than the default - lower values are not recommended.

HairLineWidth
double 0.25

Hair lines are lines with a width of zero, meaning the thinnest line that a PostScript device can produce. The results of rendering such "zero-width" lines are device-dependent, and on high-res devices they are nearly invisible. If this preference is set to a non-negative value the width of all hair lines in PDF files is set to that value in PostScript points (1/72") for printing and layout generation.

14.3 PDF Drucker Präferenzen

Key: Printers/<printer queue>/<preference>
PDFTransparency
bool FALSE

(HELIOS Admin option PDF Tranparency)

If a PDF document that contains transparencies is sent to a printer queue with this preference set to TRUE, PostScript with pdfmark constructs is generated. With the default setting (FALSE) an error is generated. For more information on PDF transparencies refer to A 4 "Transparenzen in PDF".

PreserveDeviceN
bool FALSE

(HELIOS Admin option PostScript3/DeviceN Output)

This preference applies only to OPI image replacement. If you want to print a PDF document with output optimized to use the PostScript 3/DeviceN feature, you must print it using the "pdfprint" command line tool with the appropriate option (see 8.1 "pdfprint"):

pdfprint -o preservedevicen

Another possibility is to print via the PDF HandShake Print plug-in for Acrobat 8, with activated Preserve DeviceN checkbox.

DefaultPrinterProfile
str ""

(HELIOS Admin pop-up menu Default Printer Profile)

This preference specifies the path name of the default ICC profile describing the printing device. Can be overridden using the HELIOS ColorSync 2 XT.

DefaultProofProfile
str ""

(HELIOS Admin pop-up menu Default Proof Profile)

This preference specifies the path name of the default ICC profile describing the proof device. The string will only be recognized if a default printer profile is set. Can be overridden using the HELIOS ColorSync 2 XT.

CompositeColorspace
str "CMYK"

This preference sets the color space used while printing composite. The default is CMYK. Setting this option to "None" causes all color images in a print job to be kept and printed in their original color space. This applies to CMYK, CIELab and RGB images only. Valid strings are "CMYK", "RGB", and "CIELab". Please note that the value you choose for this preference can be overridden by the printer profile you have selected using HELIOS ColorSync 2 XT or using the DefaultPrinterProfile option.

Note: In a "Create PDF" queue, the default behavior is "None".
PureWhite
bool FALSE

(HELIOS Admin option Preserve Raster Colors - White)

Exclude white colored raster objects in PDF files from color transformation, so that they remain white even if color matching is done. CMYK values will be zero, i.e. no ink is applied to the plates.

PureGrays
bool FALSE

(HELIOS Admin option Preserve Raster Colors - Gray)

Exclude gray colored raster objects in PDF files from color transformation, so that they remain gray even if color matching is done. Gray raster objects in Gray/RGB/CIELab/Indexed color spaces are detected and converted to Gray only for CMYK output.

PureBlack
bool FALSE

(HELIOS Admin option Preserve Raster Colors - Black)

Exclude black colored raster objects in PDF files from color transformation, so that they remain black even if color matching is done. Black raster objects in Gray/RGB/CIELab/Indexed color spaces are detected and converted to Black only for CMYK output.

PureCMY
bool FALSE

(HELIOS Admin option Preserve Raster Colors - CMY)

Exclude cyan, magenta and yellow colored raster objects in PDF files from color transformation, so that they remain as is even if color matching is done.

PureVectorWhite
bool FALSE

(HELIOS Admin option Preserve Vector Colors - White)

Exclude white colored vector objects in PDF files from color transformation, so that they remain white even if color matching is done. CMYK values will be zero, i.e. no ink is applied to the plates.

PureVectorGrays
bool FALSE

(HELIOS Admin option Preserve Vector Colors - Gray)

Exclude gray colored vector objects in PDF files from color transformation, so that they remain gray even if color matching is done. Gray text and vectors in Gray/RGB/CIELab/Indexed color spaces are detected and converted to Gray only for CMYK output.

PureVectorBlack
bool FALSE

(HELIOS Admin option Preserve Vector Colors - Black)

Exclude black colored vector objects in PDF files from color transformation, so that they remain black even if color matching is done. Black text and vectors in Gray/RGB/CIELab/Indexed color spaces are detected and converted to Black only for CMYK output.

PureVectorCMY
bool FALSE

(HELIOS Admin option Preserve Vector Colors - CMY)

Exclude cyan, magenta and yellow colored vector objects in PDF files from color transformation, so that they remain as is even if color matching is done.

14.3.1 "pdfif" Präferenzen

distillhost
str ""

(HELIOS Admin option Host Name)

This preference specifies the host name of the machine where the CreatePDF Server/Acrobat Distiller is installed.

distillservice
str "2005"

Specifies the TCP port number of the Create PDF Server. If you change the port number to another value, you must also change the port number of the "Create PDF Processor" (see Auf einen anderen Port drucken in 11.1.3 "Mac Serverinstallation".

distillprefix
str ""

(HELIOS Admin option Name Prefix)

This preference will only be recognized if distilldir is specified as well. With "string", you can define a file name prefix for all PDF files that are sent to the selected directory. This can help you classify your PDF files if you have several "Create PDF" queues and save all PDF files into the same directory.

distilldir
str ""

(HELIOS Admin option Directory)

This preference specifies the path of the directory where the generated PDF files are saved.

createpdf
bool TRUE

This preference determines if a PDF file is created at all.

distillnotifyprog
str ""

(HELIOS Admin option Notify Program)

This preference will only be recognized if distilldir is specified as well. With this preference the path of the "distillnotify" program is specified.

E.g.: distillnotifyprog=/usr/local/bin/crpdfnotify

"pdfif" exports the following environment variables during the program call:

HELIOSDIR=
<environment variable for the HELIOS install path>
HELIOS_JOBFOR=
<user name (if available) of print job creator>
HELIOS_JOBUSER=
<user name (if available) as known to "lpd">

HELIOS_JOBHOST=
<name (if available) of server which hosts the printer queue>

HELIOS_JOBTITLE=
<print job title (if available)>

HELIOS_PRINTERNAME=
<logical (UNIX) name of the printer queue>

HELIOS_JOBPAGES=
<expected number of pages. This value may differ slightly from the actual number>

HELIOS_JOBSIZE=
<expected print job size (in bytes). The stated value is often smaller than the actual size>

HELIOS_VFFILE=
<name of created PDF file>

distillresolve
bool TRUE

Specifies if any resolving is done within a PostScript job. When a print job is processed to a "Create PDF" queue, and the switch is set to FALSE, the print job remains "untouched" and is passed on without any changes.

userdir
bool FALSE

(HELIOS Admin option Create folder for each user)

Specifies if the PDF files are stored in a folder per user.

writesize
int 131072 (128 x 1024)

Specifies the TCP write buffer size in bytes.

readsize
int 131072 (128 x 1024)

Specifies the TCP read buffer size in bytes.

keepepsfsize
bool TRUE

If set to TRUE, this preference determines that the PDF page size is taken automatically from the BoundingBox if the job is an EPSF file rather than a PostScript file. This preference is only meaningful if distillresolve is set to TRUE as well.

14.4 Ghostscript Create PDF Präferenzen

The following keys require a service restart to take effect:

Key: Programs/createpdf/<preference>
ghostscript
str (see text)

Full path to the Ghostscript executable. If the preference is not defined, an executable "gs" is searched in the following locations:

/usr/bin, /usr/sbin, /usr/local/bin, /bin, /opt/bin, /opt/local/bin.

If Ghostscript is not installed in one of these locations, you must set this preference.

Example:

prefvalue -k Programs/createpdf/ghostscript -t str /sw/bin/gs

("gs" is installed in "/sw/bin").

port
int 2018

Specifies the TCP/IP port number where to listen for jobs.

ipaddress
str (see text)

TCP/IP interface address used by the "createpdf" service. If the preference is not set, "createpdf" listens on the address "any", which means that connections on all interfaces are accepted.

Example:

prefvalue -k Programs/createpdf/ipaddress -t str "127.0.0.1"

Restricts access to the local interface. In this example, only "Create PDF" printer queues running on the same host can access this "createpdf" server.

tempDir
str "HELIOSDIR/var/tmp"

Specifies the path to a directory where temporary files are created.


© 2008 HELIOS Software GmbH