PDF HandShake UB64 User manual (Version 5.0.0)  
 

14 Preferences

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.

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 Global PDF preferences

Key: Global/Opi/<preference>

PDFNativeWorkflow
bool
FALSE

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 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".

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 preferences

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
"ISO Coated 2 FOGRA39"

(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 (60000 kB) – 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 (10000 kB) – 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-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.

TextQuality
str
"high"

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.

14.3 PDF printer queue preferences

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 17 “PDF Transparency”.

PreserveDeviceN
bool
FALSE

(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 7.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 option Default Printer Profile)

This preference specifies the path name of the default ICC profile describing the printing device.

DefaultProofProfile
str
""

(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.

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 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)

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%.

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)

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%.

createlog
bool
TRUE

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

14.3.1 “pdfif” preference keys

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”.

distillprefix
str
""

(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.

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.: /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.

SendEvent
bool
FALSE

If this preference is set to TRUE, the “Print To Disk” interface reports events to all listening services.

14.4 Ghostscript Create PDF preference keys

The following keys require a restart (see “srvutil” in the HELIOS Base manual) of the “createpdf” service to take effect:

Key: Programs/createpdf/<preference>

ghostscript
str
(see description)

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; 
Example
 (UNIX):
# prefvalue -k Programs/createpdf/ghostscript -t str
  /sw/bin/gs

(“gs” is installed in “/sw/bin”.)

Example
 (Windows):
# prefvalue -k Programs/createpdf/ghostscript -t str
  "C:\\Program Files\\gs\\gs8.64\\bin\\gswin32c.exe"
port
int
2018

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

ipaddress
str
(see description)

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.


HELIOS Website © 2015 HELIOS Software GmbH  
HELIOS Manuals April 1, 2020