9 Präferenzen und Benachrichtigungsmechanismen

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

This chapter lists all the preferences that are pertinent to ImageServer. 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.

9.1.1 OPI-Server Präferenzen

This preference determines the time delay in seconds after which the layout file is generated from the original image file.

This preference controls the maximum number of "opisrv" processes that may run simultaneously. Default is the number of physically available processors.

The priority of the "opisrv" processes - compared to other executable programs on the HELIOS server - can be changed. This preference lets you increase/reduce the priority, and therefore the speed of a program. The higher the priority of a program, the less "nice" its behavior towards other applications. The values for NiceIncr are as follows:

Specifies the facility which is used for system log messages. The string names the log facility. The default value depends on the program and is daemon for the "opisrv" program and user for the "layout" program. Valid names are listed below (please note that some names are not supported on every architecture):

"audit", "sat", "auth", "security", "cron", "daemon", "kern", "lpr", "mail", "news", "syslog", "user", "uucp", "local0", "local1", "local2", "local3", "local4", "local5", "local6", and "local7".

Allows definition of additional file types (Mac), which are registered for file events.

Allows definition of additional file suffixes (Windows PC), which are registered for file events.

If set to TRUE, access to the ImageServer Event port (2002) is enabled to remote users (subject to the restrictions in the ipaccess list). The default is that access to the ImageServer Event port is only enabled for users on the same host.

Determines additional resources, which will be read and preserved by "OpenImage" plug-ins. If the string contains PATH, IPTC or XMP, the named additional resource will be read. If no resources should be preserved, specify none.

Sets the color space for rendered image objects. It is important that for PDF files this option is set to CMYK, to show proper overprints.

9.1.2 Globale OPI Präferenzen

This preference determines the quality of the generated layout image. If set to TRUE, layouts will be generated faster, will only reach standard quality and are not color matched.

The print color space for all layout files that are generated on the server can be specified by use of this preference. At the same time, it defines an ICC profile which is used for color matching the layouts. This profile is taken from the ProfilePaths setting.

Defines the default monitor resolution for layout files. Usually monitor resolutions have a range between 72 and 200 dpi.

Specifies a list of path names to search for high-resolution images during image replacement, in case they cannot be found in the standard locations. The setting reflects the entries in the HELIOS Admin (ImageServer Settings > Image Search Paths-)

strlist "RGB=sRGB_IEC61966-2-1_noBPC.icc",
"CMYK=Euro 2.6 UCR-370"

Defines RGB and CMYK profiles used if the color space for the destination layout file and the color space of the highresolution file are different. These profiles are used to match between color spaces properly. Each string has the format <color space>=<path name>.

Determines the preview PostScript level for EPSF files. By default, this is PostScript level 1, optionally PostScript level 2 can be specified.

Controls the TCP/IP port number where to listen for OPI event registration requests. If this preference is not set, "opisrv" uses the port number given by the TCP service "OPIEvent". If this service is not defined it uses the default port number 2002.

If set to TRUE, this preference causes that a layout image is created from a PDF file. The setting of this attribute reflects that of the PDF OPI Layout Generation checkbox in the HELIOS Admin Settings > PDF HandShake Settings menu.

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

Causes the creation of EPSF layout images if a high-resolution raster image contains extra colors like spot colors.

Causes the creation of EPSF layout images if a high-resolution raster image contains a clipping path.

If set to TRUE, the screen preview in layout files, generated from PDF documents, offers an enhanced readability. This is recommended for monitor screen resolutions up to 96 dpi. The setting of this attribute reflects that of the Antialias Screen Preview checkbox in the HELIOS Admin Settings > PDF HandShake Settings menu.

For this preference, the key is:
Library/OpenImage/ManagerPrivate/HeliosPDF/<preference>

This preference defines the type of CMYK color space, if an image which is transformed into CMYK or vice versa and if - in a situation like that - a CMYK output (printer) or input (image) profile has not been explicitly defined.

For this preference, the key is:
Library/OpenImage/ManagerPrivate/HeliosICC/<preference>

Process color matching for layout files, if the high-resolution files have tagged ICC profiles.

If set to TRUE, a generated layout will contain an embedded profile, even if the original image only has a referenced profile. This preference is only applicable if the UseProfile option is also set. It is useful, if the layout will be used either on a different computer or in an environment where the specified profile is not available.

If set to TRUE, a generated layout/original will omit any specified profile. This preference is useful if the generated layout/original has a smaller size than the specified profile.

If the value "Compress" is specified for this preference, TIFF layout images are compressed.

For this preference, the key must be extended to:
Global/Opi/ImageCompress/TIFF///<preference>

If the value "JPEG" is specified for this preference, EPSF layout images are compressed.

For this preference, the key must be extended to:
Global/Opi/ImageCompress/EPSF///<preference>

If this preference is set, EPSF layout images for monitor use contain indexed colors (max. 256 colors).

For this preference, the key must be extended to:
Global/Opi/ImageColor/EPSF//<preference>

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

9.1.3 OPI-Volume Präferenzen

Causes the creation of EPSF layout images if a high-resolution raster image contains extra colors like spot colors.

Causes the creation of EPSF layout images if a high-resolution raster image contains a clipping path.

9.1.4 Globale Drucker Präferenzen

9.1.5 OPI-Drucker Präferenzen

If this preference is set to TRUE it activates OPI for the specified printer queue.

This preference applies to composite printing only:
Spot colors are output in Level 2 Separation color space. This becomes necessary when printing to a Create PDF printer queue or to in-RIP separation devices, in order to preserve the spot colors. If set to FALSE, all spot colors that are incorporated in the image are converted to the process colors of the output color space, e.g. CMYK.

If set to TRUE, the printouts from the specific printer queue will only contain layout images. The copies of the images - which you have used for layouting your document - will be sent to the OPI server and then be replaced by the layout files instead of the high-resolution originals.

With this preference set to TRUE, the OPI server will try to find all images that are included in a print job. If any images are missing, the job will be stopped, and issue an error message for every missing file. If CheckImages is set to FALSE, single images may be missing on the printouts.

This preference will induce the OPI server to check whether all image profiles that have been tagged to any of the image files are available. The server will automatically stop the print job if a single profile is missing and issue a corresponding error message. If you set CheckICCProfiles to FALSE, OPI will execute all print jobs and use standard profiles for color matching whenever the correct profile is missing.

This preference should only be set to TRUE if you print to a PostScript 3 device with in-RIP separation. The PostScript output of PDF original files will be optimized to use the PostScript 3/DeviceN features. This applies for Hexachrome® printing, colorized images (Duotone), etc.
When printing host-based separations with applications like QuarkXPress, this feature must be turned off, otherwise the output will lead to unexpected results.

This preference will induce the OPI server to issue an error message if the current print job contains any fonts that are not available.

If set to FALSE, the OPI server will only replace layout images during printing. High-resolution originals you may have placed in your document, will not be replaced. In case you want the OPI server to replace all images during printing (e.g. if you want to use the Omit- options in the print dialog) you should set this preference to TRUE.

Defines a uniform output resolution for all raster-based images - no matter whether you print layout images or high-resolution originals. The resolution for downsampling may be specified with the Resolution preference (see below).

With DownSampling (see above) set to TRUE, the resolution of an image can be specified with this preference. If the resolution of a given image (e.g. 300 dpi) is higher than the value specified for this preference (e.g. 222,30 dpi), the OPI server will apply the value you have chosen for downsampling and then re-calculate and scale the image accordingly. Images with a resolution smaller than the value entered in this dialog, will remain unchanged because increasing the resolution automatically decreases the dimensions of an image. This would entail upward scaling and lead to a loss in quality. Zero induces the software to use the default resolution of the printing device as specified in the queue's PPD file.

This preference allows fixing the downsampling resolution (see Resolution preference above) to the given value. Usually, if this preference is set to FALSE, the output resolution is adjusted to the image resolution if the image resolution is smaller. When setting this preference to TRUE the printer interfaces will use the given Resolution as is for downsampling. This may cause upsampling of images with resolutions smaller than the given one. This preference is only meaningful when setting the DownSampling preference to TRUE.

This option specifies the compression mode for images while being printed. Two preferences are needed to set this preference: color space and compression mode.

For this preference, the key must be extended to:
Printers/<printer queue>/PostScriptImage/<colorspace>/CompressPostScript

With the CompressPostScript preference selected, this preference controls the output quality of JPEG-compressed PostScript images. Valid values are 1-100.

For this preference, the key must be extended to:
Printers/<printer queue>/PostScriptImage/<colorspace>/PrintCompressQuality

Specifies whether in case of resolving an already resolved PostScript job, the use of fonts and other resources should still be accounted.

This preference - if it is set to TRUE - enables the use of the HELIOS desktop database to locate moved image files.

Specifies a list of volume names where to search high-resolution images during image replacement, in case they cannot be found in the standard locations.

Note: When remote OPI is used, the remote client must not use "layouts" as directory name for low-res images, in case the "ImageSearchVolumes" feature is used.

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

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.

This preference sets the color space used while printing separations. The default is CMYK for a four color print process. Spot colors are not affected by this preference. Valid color spaces are "CMYK" and "Multi". If you set the string to "Multi" you have to define the names and order of the color components. Furthermore, the usage of the "Multi" color space requires the use of ICC profiles. For (future) ICC profiles that include the names of the color components this preference will become obsolete. 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 DefaultPrinterProfile.

This preference controls, in conjunction with the ProcessColorspace preference, the names of the process inks used for separations. Spot colors are not affected.

This preference sets the color space used while printing composite. The default is CMYK. Setting this preference to None causes all color images in a print job to be kept and printed in their original color space. This applies to CMYK,
RGB and CIELab 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 preference.

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

This preference enables the use of the ICC info files while printing images. If it is set to TRUE, every non-tagged image will be temporarily tagged during printing provided that the ICC info file specifies tagging for that kind of image.

Use this preference to specify whether non-existing layout images should be ignored when printing layout quality.

This preference controls whether untagged images should be ignored when printing to an ICC color matched queue. If set to TRUE, the images are printed with the default profile. If set to FALSE, the print job is passed to the error queue.

If this preference is set to TRUE, all spot colors in the print job will be printed with the appropriate process color values.

9.1.6 Script Server Präferenzen

Specifies the time interval after the file event is received before the script is executed.

This preference controls the maximum number of "scriptsrv" processes that may run simultaneously. Default is the number of physically available processors.

Note: It is recommended that the value for MaxProc be less or equal to the number of physical CPUs.

If set to TRUE, access to the Script Server service port (2024) is enabled to remote users (subject to the restrictions in the ipaccess list). The default is that access to the Script Server service port is only enabled for users on the same host.

Specifies the file name of the IP access list that controls client access to the Script Server.

This preference determines how long a script may run. Specifying - 0 disables the running time (i.e. "run forever"). The setting reflects that of the Script Timeout field in the HELIOS Admin Script Server Settings window. Compare Timeout in 9.1.7 "Script queue Präferenzen".

This preference determines (in seconds) how long "scriptsrv" should wait before the process is killed. This happens only if RunTime (see above) has timed out.

9.1.7 Script queue Präferenzen

Key: Programs/scriptsrv/Config/<queue>
/<preference>

Specifies the path to the Script Server hot folder. The setting reflects that of the Hot Folder field in the General tab of the HELIOS Admin Script configuration window.

Specifies the desired script for the script queue. The setting reflects that of the Script field in the General tab of the HELIOS Admin Script configuration window.

Specifies the user whose permissions are used to execute the script. The setting reflects that of the User field in the General tab of the HELIOS Admin Script configuration window. If this preference is not specified, the script is executed as superuser.

Determines whether the script queue is active at all. The setting reflects that of the Enable checkbox in the General tab of the HELIOS Admin Script configuration window.

This preference determines how long the script may run. Specifying - 0 disables the running time (i.e. "run forever"). The setting reflects that of the Timeout field in the General tab of the HELIOS Admin Script configuration window. If this preference is not specified, Script Server uses the global value RunTime (see above).

Determines that all subdirectories underneath the specified directory for the hot folder (see Path) are considered. The setting reflects that of the Include Subdirectories checkbox in the General tab of the HELIOS Admin Script configuration window.

Determines that directory events rather than file events are notified to the Script Server. The setting reflects that of the Folder Changes checkbox in the File Types tab of the HELIOS Admin Script configuration window.

Specifies whether verbose output is written. The value is exported as SCRIPTDEBUG environment. The setting reflects that of the Debugging checkbox in the General tab of the HELIOS Admin Script configuration window. If this preference is not specified, Script Server uses the global value scriptdebug.

Allows specifying file types for which script execution should be triggered. If no type is specified, the script is executed for any file event. The setting reflects that of the entries in the Types list in the File Types tab of the HELIOS Admin Script configuration window.

Allows specifying file suffixes for which script execution should be triggered. If no suffix is specified, the script is executed for any file event. The setting reflects that of the entries in the Suffixes list in the File Types tab of the HELIOS Admin Script configuration window.

Allows specifying additional environment variables, which are considered while the script runs. The setting reflects that of the entries in the Environment list in the Environment tab of the HELIOS Admin Script configuration window.

9.1.8 Schmuckfarbeneditor Präferenzen

Key: Library/OpenImage/CustomColors/<Color_Name>

Defines a preview color for a given spot color name either in the Lab or in the CMYK color space. If the color is defined in Lab (1), the string is preceded by an "L". If the value is entered in CMYK (2), the string has a leading "C".

For C, M, Y, K and L, color values of 0% are represented as 0.0, while vallues of 100% are represented as 1.0.
For a and b, values between -128 and 128 are represented in a range between 0.0 to 1.0, with 0 being 0.5.

9.2 Benachrichtigungsoptionen

ImageServer kann Dateiänderungs-Ereignisse ("file change events") über den TCP/IP-Port "2002" an die Benutzerprogramme weitergeben.

Hinweis: Diese Ereignisse werden von Drittanbieter-Programmen wie z. B. Cumulus (Canto), MediaBeacon (Brightech), oder OPAS-G (OKS) verwendet.

Der Ausgabe steht eine Zahl voran (meist 4), gefolgt von der Art des Ereignisses ("event type") und dem Dateipfad.

Geben Sie auf der Kommandozeile den Befehl socket localhost 2002 ein. Mit help erhalten Sie eine Übersicht der Kommandos und zum Beenden geben Sie quit ein.

Hinweis: Der ImageServer Ereignis-Port kann standardmäßig nur von localhost aus erreicht werden. Lesen Sie dazu RemoteAccess in Kapitel 9.1.1 "OPI-Server Präferenzen".

Zeigt die "opisrv" Ereignis-Warteschlange als Liste von Dateien, von denen Layoutbilder erzeugt werden. ushowq beinhaltet zusätzlich die ID des Benutzers, der den Auftrag gestartet hat.

Zeigt eine Liste von Volumes, die von EtherShare und PCShare exportiert worden sind und kann zur Verknüpfung eines Pfadnamens mit dem entsprechenden Volume benutzt werden.

Gibt ein Änderungs-Ereignis für eine bestimmte Datei aus, z. B. um eine Layoutdatei zu erzeugen.

Gibt ein Änderungs-Ereignis für ein Verzeichnis aus, z. B. um Layoutbilder von allen sich in diesem Verzeichnis befindenden Dateien zu erzeugen.

Hinweis: Die nächsten drei Ereignis-Optionen können optional mit einem Dateityp für das aktuelle Ereignis angegeben werden.

Benachrichtigt "opisrv", wenn eine Datei geschlossen wird:
sendclose "file name" [file type]

Benachrichtigt "opisrv", wenn eine Datei umbenannt wird:
sendrename "file name old" "file name new" [file type]

Benachrichtigt "opisrv", wenn eine Datei gelöscht wird:
senddelete "file name" [file type]

Benachrichtigt registerlayout-Clients, wenn ein Layoutbild erzeugt wird. Dies machen normalerweise "layout" und "opisrv":
sendlayout "file name"

Benachrichtigt "opisrv", wenn ein Verzeichnis umbenannt wird:
sendrenamedir "directory name old" "directory name new"

Benachrichtigt "opisrv", wenn ein Verzeichnis angelegt wird:
sendcreatedir "directory name"

Benachrichtigt "opisrv", wenn ein Verzeichnis gelöscht wird:
senddeletedir "directory name"

Registrierung für Layoutgenerierung. Jedesmal wenn eine Layoutdatei erzeugt wird, wird der Pfadname der neuen Datei gemeldet.

Registrierung für Änderungsereignisse an Dateien. Somit können alle Ereignisse, die sowohl im Zusammenhang mit neu angelegten Dateien, als auch mit Dateien, die von Mac- oder Windows-Clients gelöscht wurden, erfasst werden. Optional kann de Anzahl der Ereignisse durch die Angabe eines Verzeichnispfads eingeschränkt werden. Der angegebene Pfadname muss absolut sein.
registerfiles [directory path]

This option should be used carefully because it can cause hundreds of events per second and hence may dramatically slow down the server performance.

Registrierung für Änderungsereignisse an Verzeichnissen. Somit können alle Ereignisse, die sowohl im Zusammenhang mit neu angelegten Verzeichnissen, als auch mit Verzeichnissen, die von Mac- oder Windows-Clients gelöscht wurden, erfasst werden. Optional kann de Anzahl der Ereignisse durch die Angabe eines Verzeichnispfads eingeschränkt werden. Der angegebene Pfadname muss absolut sein.
registerdirs [directory path]

Registrierung für Änderungsereignisse an einem bestimmten Mac-Dateityp. "opisrv" meldet alle Änderungen, die von einem HELIOS File Server an einem bestimmten Dateityp gemacht wurden. Beispielsweise meldet registertype "EPSF" in einer Liste alle Änderungen an Dateien des Typs EPSF. Optional kann de Anzahl der Ereignisse durch die Angabe eines Verzeichnispfads eingeschränkt werden. Der angegebene Pfadname muss absolut sein.

Unter protocol 0, registertype "\0\0\0\0" stellt einen Platzhalter dar, um alle von Clients verursachten Dateiänderungen zu melden. Sie sollten die Benutzung dieser Option sorgfältig durchdenken, da sie hunderte von Ereignissen pro Sekunde verursachen kann und dadurch die Serverleistung drastisch verlangsamen kann.

Registrierung für Änderungsereignisse an einem bestimmten Windows-Dateisuffix. "opisrv" meldet alle Änderungen, die von einem HELIOS File Server an einem bestimmten Dateisuffix gemacht wurden. Beispielsweise meldet registersuffix ".eps" in einer Liste alle Änderungen an Dateien der Namenserweiterung .eps. Optional kann de Anzahl der Ereignisse durch die Angabe eines Verzeichnispfads eingeschränkt werden. Der angegebene Pfadname muss absolut sein. Siehe Platzhalter in protocol 1.

Unter protocol 0 stellt registersuffix "\0" einen Platzhalter dar, um alle von Clients verursachten Dateiänderungen zu melden. Sie sollten die Benutzung dieser Option sorgfältig durchdenken, da sie hunderte von Ereignissen pro Sekunde verursachen kann und dadurch die Serverleistung drastisch verlangsamen kann. Siehe Platzhalter in protocol 1.

Wechsel in das alte Ausgabeformat (bis ImageServer 2.5; protocol 0). Die Vorgabe ist protocol 0.

9.2.1 Benachrichtigungsoptionen (neues Protokoll)

Zusätzlich zu der Art des Ereignisses und dem Pfadnamen der Datei zeigt das neue Protokoll (protocol 1) die ID des Benutzers, der die Änderung an der Datei vorgenommen hat. Bei "close"-Ereignissen kann die Zeichenkette Flags enthalten, die anzeigen, welcher Bereich der Datei verändert wurde:

4 - close "/opitest/InDesign/Project1" 105 s "Comments"

Die Befehle für die Ereignisse registertype und registersuffix können auch im neuen Ausgabeformat angegeben werden (siehe switchprotocol1). Wenn Sie Platzhalter für die Registrierung von Dateitypen und -erweiterungen im protocol 1 setzen möchten, verwenden Sie stattdessen die Option registerfiles. Der im alten Protokoll verwendete Platzhalter registersuffix "\0" ist in protocol 1 ist nicht zulässig, während registertype "\0\0\0\0" als ein Dateityp interpretiert wird (z. B. als Dateityp für Bildformate von Digitalkameras).

0 - Welcome to the HELIOS ImageServer event listener

Dann wird ein Platzhalter gesetzt, der die Benachrichtigungen auf Dateien unter dem angegebenen Pfad beschränkt:

Beim Duplizieren der Datei "Project1" wird das folgende Ereignis ausgegeben (Beachten Sie, dass die Benutzer-ID "105" bei der Benutzung von protocol 1 angezeigt wird):

4 - delete "/opitest/InDesign/Project1 copy" 105

ImageServer UB⁺ Benutzerhandbuch