This chapter lists all 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 HELIOS Base manual.
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.
Key: Global/Opi/<preference>
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.
Specifies the page box of PDF documents that should 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".
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.
(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
Key: Library/OpenImage/ManagerPrivate/HeliosPDF/<preference>
(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.
(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.
(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.
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.
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.
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-resolution 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.
Determines the text rendering quality when PDF is converted to
raster images. The preference can be set to high or low.
high means that text is rendered more accurately. low has the
advantage of faster rendering.
Key: Printers/<printer queue>/<preference>
(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 C “PDF Transparency”.
(HELIOS Admin option PostScript 3/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.
(HELIOS Admin option Default Printer Profile)
This preference specifies the path name of the default ICC profile describing the printing device.
(HELIOS Admin option 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 specified.
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 using the DefaultPrinterProfile
option.
In a “Create PDF” queue, the default behavior is “None”.
(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.
(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.
(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.
(HELIOS Admin option Preserve Raster Colors – CMY)
Applies to CMYK to CMYK conversions of pixels of raster images, and preserves the input color only if black is 0% and exactly one CMY primary color is 100% and all other primary colors are 0%.
(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.
(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.
(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.
(HELIOS Admin option Preserve Vector Colors – CMY)
Applies to CMYK to CMYK conversions of text and vector objects, and preserves the input color only if black is 0% and exactly one CMY primary color is 100% and all other primary colors are 0%.
Creates log files for Create PDF workflows. If set to FALSE,
no log file is generated after a Create PDF print job.
This preference can also be set globally, with the key:
Global/Printers/createlog
(HELIOS Admin option Host Name)
This preference specifies the host name of the machine where the CreatePDF Server/Acrobat Distiller is installed.
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 Using a different port number in 11.1.3 “ Mac server installation”.
(HELIOS Admin option Name Prefix)
This preference will only be recognized if distilldir is also specified. 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.
(HELIOS Admin option Directory)
This preference specifies the path of the directory where the generated PDF files are saved.
This preference determines if a PDF file is created at all.
(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>
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.
(HELIOS Admin option Create Folder for Each User)
Specifies if the PDF files are stored in a folder per user.
Specifies the TCP write buffer size in bytes.
Specifies the TCP read buffer size in bytes.
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.
If this preference is set to TRUE, the “Print To Disk” interface reports events
to all listening services.
Key: Programs/createpdf/<preference>
Full path to the Ghostscript executable. If the preference is not defined, the executable (“gs” on UNIX, “gswin32c” on Windows) is searched in all directories of the default search path and in the following locations:
UNIX:
/usr/bin; /usr/sbin; /usr/local/bin; /bin; /opt/bin; /opt/local/bin
Windows:
C:\gs\bin; C:\Program Files\gs\bin; C:\Programme\gs\bin;
# prefvalue -k Programs/createpdf/ghostscript -t str /sw/bin/gs
(“gs” is installed in “/sw/bin”.)
# prefvalue -k Programs/createpdf/ghostscript -t str "C:\\Program Files\\gs\\gs8.64\\bin\\gswin32c.exe"
Specifies the TCP/IP port number where to listen for jobs.
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.
# 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.
Specifies the path to a directory where temporary files are created.