HELIOS Addendum User manual
2 PDF HandShake 2.1
With the new HELIOS product line, all settings, parameters and options are stored in one binary file, "Preferences" ("HELIOSDIR/var/conf/Preferences"). A description of how to set, change or delete preferences to that file via the HELIOS utilities "prefdump", "prefvalue", and "prefrestore" is given in the "HELIOS Base 1.1" user manual.
In the following, we list PDF HandShake's new features, its specific preferences with a brief description and examples where needed.
2.1 Changes in "Create PDF Server"
2.1.1 Changing security settings
The way how to change Distiller security settings has changed in this version of "Create PDF Server":
-> Start EtherShare Admin and select the desired "Create PDF" printer queue (List > Printers).
-> Open the security settings window of the respective "Create PDF" printer queue (Printer > Edit Distiller Security-).
Default Security settings
#
# HELIOS CreatePDF Security Settings v2.1.0
#

# This password is needed to open the documents.
User password =

# This password is needed to change the document security
# settings.
Master password =

# Allow printing.
# Possible values:
# 0: None
# 1: Low resolution only
# 2: High resolution and low resolution (ineffective with
# PDF-Level 1.3)
Printing = 2

# Allow editing.
# Possible values:
# 0: None
# 1: Document Assembly (ineffective with PDF-Level 1.3)
# 2: Forms Field Fill-in and Signing (ineffective with
# PDF-Level 1.3)
# 3: Comment Authoring, Document Assembly, Forms Field
# Fill-in and Signing
# 4: General Editing
Editing = 4
# Enable content accessibility.
# Possible values: YES or NO
# (ineffective with PDF-Level 1.3)
Accessibility = YES

# Allow the user to select text and other document
# elements and copy them via the clipboard.
# Possible values: YES or NO
Extraction = YES
-> Apply your changes in the SECURITY window.
Example:
# This password is needed to open the documents.
User password = "macuser"
-> Then close the window and confirm your changes.
2.1.2 "Create PDF Server" for Windows
PDF HandShake 2.1 includes a feature to automate the PDF creation of any PostScript print job. This is done by creating a new printer queue in EtherShare Admin with the connection type Create PDF. This queue prints the PostScript job over TCP/IP to one or more dedicated Windows-based server(s). The Windows server is used to create the PDF file. After a successful PDF file is created the Windows PC will return the PDF to the EtherShare printer queue.
Prerequisites
To benefit from the "Create PDF Server" for Windows feature, the following setup is required:
In order to ensure troublefree Windows server operation it is most important that the server is not employed with tasks other than running the "Create PDF Server" process.
Windows server memory requirements
The dedicated Windows PC that hosts "Create PDF Server" needs at least 64 MB free RAM. The performance of PDF creation with the "Create PDF Server" depends on the size of the PostScript print job in relation to the memory assigned to the application.
The Windows PC should be connected with 100 Mbit Ethernet or faster. A 10 Mbit network will work but will not keep Distiller busy, we recommend 100 Mbit.
Windows server Installation
-> Open the "HELIOS_APPS" volume on the Windows PC and copy the "Create PDF Server" folder from
Windows\PDF Tools to the local disk.
"Create PDF Server" comprises the following files:
The main application
The program that is (automatically) started for each job
Batch files to install or remove "Create PDF Server" as a Windows service
Utility program to make the Font Locations- settings available to the Windows service
Dynamic libraries needed by the "Create PDF Server" applications
There are two ways to make use of "Create PDF Server" (described in more detail below):
Install "Create PDF Server" as a service
Advantages:
+ Runs as background application
+ No user login is needed
+ Error reporting in "Windows Event Log" file
To install the "Create PDF Server" application as a Windows service do the following:
-> Double-click "InstallPDFService", which installs "HELIOS Create PDF Server" as a Windows Service. This means that it is started each time the Windows PC is booted. Calling up this install script will also start the server immediately.
Verifying the installation
To verify the installation of the service, do the following:
-> Start the Windows "cmd" program and change to the "Create PDF Server" directory. Then type "Create PDF Server.exe" -s and press RETURN (-s = "status").
Your "Create PDF Server" service installation was successful if the line Service is installed. appears in the Windows "cmd" program command line.
Alternatively, you can do the following:
-> Go to start > Control Panel > Performance and Maintenance > Administrative Tools > Services. Then double-click the Create PDF Server icon.
The "Create PDF Server Properties" window appears (Fig. 1).
Fig. 1: "Create PDF Server Properties" window

Removing the "Create PDF Server" Windows service
To remove the Windows service do the following:
-> In the "Create PDF Server" folder double-click "RemovePDFService.bat".
The "Create PDF Server" service is then removed.
Use "Create PDF Server" in a console window
Advantages:
+ Job processing can be monitored
-> To start "Create PDF Server" manually (in a console window), double-click the "Create PDF Server" icon.
-> To stop "Create PDF Server" use "Ctrl-Pause" (Break key functionality), or close the console window.

Note: You must not run "Create PDF Server" simultaneously as a service and in a console window.

Error logging
In the event of an error, respective messages are written to the "Windows Event Log" and can be displayed with
start > Control Panel > Performance and Maintenance > Administrative Tools > Event Viewer.

Note: The following information applies only to "Create PDF Server" for Windows with Acrobat 5.x installations.

Adopt settings
If "Create PDF Server" is used as a service, you need to run the "AdoptSettings.exe" program each time you change the Font Locations- settings within Acrobat Distiller. This is because Acrobat 5.x stores its settings in user-dependent trees of the registry. In order to make these settings available to the service, "AdoptSettings.exe" copies the settings to a global node.
2.2 OPI layout images of PDF files
2.2.1 PDF 1.3 shading support
PDF HandShake 2.0 already supported PDF 1.3 shadings for composite PostScript 3 output.
PDF HandShake 2.1 does also support OPI layout images from PDF files containing PDF 1.3 shadings. Patterns (e.g. shaded patterns) are not supported and will be printed as gray areas.
2.2.2 New options of the "layout" program
The "layout" program has some new options which relate to OPI layout generation of PDF files.
-o PureWhite <boolean:None>
This option can be used to override the default PDF preference PureWhite which is described in 2.4 "Preferences".
-o PureGrays <boolean:None>
This option can be used to override the default PDF preference PureGrays which is described in 2.4 "Preferences".
-o PureBlack <boolean:None>
This option can be used to override the default PDF preference PureBlack which is described in 2.4 "Preferences".
2.3 Changes in "pdfprint"
The "pdfprint" program supports the following new command line options:
-o inripseparation
-o inripseparation prints separations using "in-RIP separation" instead of host-based separations. This option requires the -s option. If the PDF file is pre-separated, this option is ignored.

Note: This option can only be used when printing to a device which supports "in-RIP separation".

Example: (to print all separations)
pdfprint -o inripseparation -s all -Pprints
Example: (to print only black plate and one spot color)
pdfprint -o inripseparation -s "Black","HKS13"
-o preserve-devicen
-o preservedevicen preserves DeviceN color objects in PDF files instead of converting them to the output color space. This also means that DeviceN color objects are excluded from any color transformation if color matching is active.

Note: This option can only be set when printing to a PostScript 3 device.

-T <Title>
-T uses title for this print job in an "lpr" printer queue. The default title is the document file name.
2.4 Preferences
2.4.1 Global PDF preferences
Key: Global/Opi/Formats/PDF ///<preference>
Preference
Type Default (""=empty string)
AutomaticLayout
bool TRUE
(EtherShare Admin option PDF OPI Layout Generation)
Enables the automatic generation of layout files from PDF files on 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.
2.4.2 PDF manager preferences
Key: Library/OpenImage/ManagerPrivate/HeliosPDF
/<preference>
AntiAlias
bool TRUE
(EtherShare Admin option Antialias Screen Preview)
If set to TRUE, the screen preview in layout files from PDF offers an enhanced readability. This is recommended for monitor screen resolutions up to 96 dpi.
RGBProfilePath
str "CCIR-EBU-RGB"
(EtherShare Admin option Default RGB Profile:)
Specifies the profile which is used as input 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"
(EtherShare Admin option Default CMYK Profile:)
Specifies the profile which is used as input profile for color data transformation of all CMYK objects in PDF files that have not been tagged with a specific CMYK profile.
PureWhite
bool (see text)
(EtherShare Admin option White)
Exclude white colored 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.
The default value is TRUE, except for proof printing, where the default value is FALSE.
PureGrays
bool (see text)
(EtherShare Admin option Gray)
Exclude gray colored 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/CIE-Lab/Indexed color spaces are detected and converted to Gray only for CMYK output.
The default value is TRUE, except for proof printing, where the default value is FALSE.
PureBlack
bool (see text)
(EtherShare Admin option Black)
Exclude black colored 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/CIE-Lab/Indexed color spaces are detected and converted to Black only for CMYK output.
The default value is TRUE, except for proof printing, where the default value is FALSE.
HairLineWidth
double 0.25
Hair lines are lines with a width of 0 (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 HairLineWidth is set to a non-negative value the width of all hair lines in PDF files is set to that value for printing and layout generation.
© 2002 HELIOS Software GmbH