TOC PREV NEXT INDEX

HELIOS PDF HandShake UB Benutzerhandbuch


6 PDF HandShake-Dienstprogramme
6.1 pdfcat
Mit dem Programm "pdfcat" können sie PDF-Dateien auf dem Server in einzelne Seiten aufteilen oder mehrere PDF-Seiten zu einer Datei zusammenfügen. Die Verwendung von "pdfcat" ist unentbehrlich, wenn Sie ein mehrseitiges Dokument haben, welches Sie in einem reinen EPSF- oder OPI-Workflow einsetzen möchten. Der OPI Server erzeugt immer nur von der ersten Seite eines PDF-Dokuments ein Platzierungsbild. Wenn Sie also ein Platzierungsbild von der zweiten Seite eines Dokuments haben möchten, müssen Sie die gewünschte Seite extrahieren und als neue Einzelseiten-PDF-Datei sichern. Die nachfolgende Grafik zeigt die drei verschiedenen Programmodi, die alle unabhängig voneinander sind und sich gegenseitig ausschließen: Der "Zusammenfügen"-Modus verbindet die ausgewählten PDF-Dateien (oder Teile davon) zu einer neuen Datei, der "Anhängen"-Modus hängt die ausgewählten Dateien (oder Teile davon) an eine bestehende Datei an und der "Extraktions"-Modus schreibt die ausgewählten Seiten eines existierenden Dokuments in neue Einzelseitendateien.

Bitte beachten Sie-
Jede PDF-Datei enthält eine Liste von Dateiinformationen, wie z. B. Verfasser, Erstellungsdatum, Änderungsdatum oder Bildprofile (optional). Außerdem kann eine PDF-Datei Sicherheitseinstellungen (optional), ein Liste von Lesezeichen (Inhaltsverzeichnis) und Anmerkungen wie Textfelder, Knöpfe usw. enthalten.
Das "pdfcat"-Programm organisiert und erstellt PDF-Dateien neu. Dabei werden die Dateiinformationen, Profile, Sicherheitseinstellungen, Lesezeichen und Anmerkungen wie folgt behandelt:
pdfcat -o
Wenn "pdfcat" ein neues mehrseitiges Dokument erstellt - wie in der ersten Zeile der obigen Abbildung gezeigt - erhält die neue Datei ihren eigenen Verfasser und ein Erstellungsdatum. Sie wird keine Profile haben, auch wenn die Ursprungsdateien "getagged" waren, und sie wird keine Sicherheitseinstellungen haben. Lesezeichen - falls in den Ursprungsdateien vorhanden - werden nicht in die neue Datei kopiert. Anmerkungen werden aus den ursprünglichen Dateien in das neu erzeugte Dokument übernommen.
pdfcat -a
Wenn "pdfcat" Seiten und/oder Dokumente an eine bestehende PDF-Datei anhängt - wie in der zweiten Zeile der oberen Abbildung gezeigt -, wird die Zieldatei (hier: helios.pdf(new)) alle Informationen enthalten, die schon in der Ursprungsdatei enthalten waren (hier: helios.pdf). Dateiinformationen, Profile, Sicherheitseinstellungen, Lesezeichen und Anmerkungen bleiben unverändert. Informationen, die in den angehängten Dateien enthalten waren (hier: Doc2 und Doc3), werden mit Ausnahme der Anmerkungen nicht in die Zieldatei übernommen sondern ignoriert.
pdfcat -e
Wenn "pdfcat" ein Dokument in mehrere neue aufteilt - wie in der letzten Zeile der obigen Abbildung gezeigt -, erben die neuen Einzelseitendokumente die Dateiinformationen, Profile, Anmerkungen und Sicherheitseinstellungen von der Originaldatei. Lesezeichen werden jedoch nicht in die Zieldateien kopiert. Bitte beachten Sie, dass "pdfcat" keine Kommentare in die Finder-Information schreiben kann. Wenn die PDF-Dateien Profilinformationen enthalten, werden diese üblicherweise im Textfeld Kommentar der Macintosh Finder-Information aufgelistet (vergl. Abb. 2 in Kapitel 4 "Bevor Sie beginnen"). Dieses Textfeld kann leer sein, wenn Sie PDF-Dateien mit "pdfcat" erstellt haben, auch wenn die neuen Dateien Profilinformationen enthalten. In diesem Fall können Sie unser Acrobat Druck-Plugin oder das ImageServer "Tagger"-Programm benutzen, um Profile sichtbar zu machen.
Nur für OPI-Nutzer
Für PDF-Dateien, die mit "pdfcat" erstellt wurden, funktioniert die automatische Layouterzeugung nicht. Sie müssen unser "touch"-Hilfsprogramm oder das Kommandozeilen-Layoutprogramm auf dem Server nutzen, um Platzierungsbilder von den neuen PDF-Dateien zu erzeugen. Alternativ können Sie den Ablauf mittels Script Server (HELIOS ImageServer) automatisieren.
6.1.1 Optionen
-h
Zeigt den Online-Hilfetext.
-v
Zeigt den Fortschritt während der Verarbeitung mit "pdfcat" an.
-o
Fügt existierende PDF-Dokumente ("inDocs-") zu einem neuen PDF-Dokument ("outDoc") zusammen. Mit diesem Parameter müssen Sie einen Zieldateinamen und einen oder mehrere Ursprungsdateinamen bestimmen. Es ist möglich, nur ausgewählte Seiten von der Ursprungsdatei zur Zieldatei zu kopieren, indem Sie Seitenbereiche angeben. Gültige Seitenbereiche sind in Kapitel 6.1.2 "Bereichsfestlegungen" aufgeführt.

Wichtig: Wenn der Name, den Sie für die Zieldatei auswählen, bereits im Zielverzeichnis vorhanden ist, wird die vorhandene Datei ersetzt!

-a
Hängt ein oder mehrere PDF-Dokumente oder Teile davon ("inDocs-") an das Ende eines anderen - schon bestehenden - PDF-Dokuments ("outDoc") an.
-e
Kopiert entweder alle Seiten oder die Seiten, die Sie bestimmt haben, aus einem PDF-Dokument ("inDoc") heraus und erstellt neue Einzelseiten-PDF-Dateien. Bei der Anwendung dieses Parameters müssen Sie ein Prefix für die Zieldateien angeben. Die Seiten mit den Seitenzahlen <nnn> der Ursprungsdatei werden dann in ein neues PDF-Dokument mit dem Namen "<prefix><nnn>.pdf" kopiert.

Hinweis: Die anzugebenden Dateinamen dürfen auch komplette UNIX-Pfadnamen enthalten, die auf ein anderes Verzeichnis verweisen.

-p
Passwort zum Öffnen eines PDF-Dokuments. Dies wird benötigt falls <pdffile> durch ein "Open Password" geschützt ist.
6.1.2 Bereichsfestlegungen
Nach jeder <inDoc>-Angabe kann eine durch Komma getrennte Liste von Bereichsfestlegungen folgen. Auf diese Weise können Sie sicherstellen, dass nur die vorher festgelegten Seiten auf dem Ursprungsdokument genutzt werden.
Zugelassene Seitenbereiche sind:
<a>
Nur Seite <a>
<a>-<b>
Seite <a> bis Seite <b>
<a>-
Seite <a> bis letzte Seite
-<b>
Erste Seite bis <b>
Das Zeichen "$" steht für die letzte Seite eines Dokuments (In einer Shell muss "$" mit einer so gennannten "Escape-Sequenz" gesetzt werden, da es sonst als Kommando interpretiert würde).
Folgt der Angabe <inDoc> eine Liste von Seitenbereichen, werden nur die angegebenen Seiten von <inDoc> in die Zieldatei kopiert. Per Vorgabe werden alle Seiten von <inDoc> kopiert.
Beispiele:
Beispiel 1:
pdfcat -o new.pdf doc1.pdf doc2.pdf,2,5-7
Schreibt alle Seiten des Dokuments "doc1.pdf" und weiterhin die Seiten 2, 5, 6, 7 von Dokument "doc2.pdf" in ein neues Dokument mit Namen "new.pdf".
Beispiel 2:
pdfcat -o new.pdf doc1.pdf,\$-1
Schreibt alle Seiten von Dokument "doc1.pdf" in umgekehrter Reihenfolge in ein neues Dokument mit Namen "new.pdf".
Beispiel 3:
pdfcat -a tmp.pdf doc1.pdf,9-6
Hängt die Seiten 9, 8, 7, 6 (in dieser Reihenfolge) von Dokument "doc1.pdf" an das bestehende Dokument mit Namen "tmp.pdf".
Beispiel 4:
pdfcat -e page doc1.pdf,-3
Schreibt die Seiten 1, 2, 3 von Dokument "doc1.pdf" in neue Einzelseitendokumente, die die Namen "page1.pdf", "page2.pdf", "page3.pdf" bekommen.
6.2 pdfform
Das Programm "pdfform" erlaubt Ihnen das Auslesen von Formularfeldwerten eines PDF-Dokuments.
Gebrauch:
pdfform [options] <pdffile>
Beispiel:
pdfform /laura/base11_e.pdf
Company=HELIOS Software GmbH
Date=03-11-04
Priority=Urgent
Dieses PDF-Dokument enthält drei Text-Formularfelder. Das Feld Company hat den Wert "HELIOS Software GmbH", das Feld Date den Wert "03-11-04" und das Feld Priority hat den Wert "Urgent".
6.2.1 Optionen
-p
Passwort zum Öffnen eines PDF-Dokuments. Dies wird benötigt falls <pdffile> durch ein "Open Password" geschützt ist.
6.3 pdfinfo
Das Programm "pdfinfo" bietet zwei Einsatzmöglichkeiten: Druckinformationen über das PDF-Dokument <pdffile> ausgeben oder Objekte daraus extrahieren.
Im Informationsmodus sieht jede Ausgabezeile folgendermaßen aus:
section: key1=value1, key2=value2, -, flag1, flag2, -
Mögliche Bereiche sind General, Security, Profile, Plate, Color, Font, MediaBox, CropBox, BleedBox, TrimBox, ArtBox, Rotate, Transparency, Image und Form. Die Ausgabe kann mit der Option -o eingegrenzt werden.
Im Extraktionsmodus können beliebige Objekte mit Objektnummer aus dem PDF-Dokument <pdffile> nach "stdout" extrahiert werden.

Hinweis: Der Extraktionsmodus ist nur für Fachleute geeignet, die über umfassendes Wissen bezüglich des Aufbaus von PDF-Dokumenten verfügen.

Gebrauch:
pdfinfo [options] <pdffile>
6.3.1 Optionen
-p
Passwort zum Öffnen eines PDF-Dokuments. Dies wird benötigt falls <pdffile> durch ein "Open Password" geschützt ist.
Informationsmodus:
-f <fromPage>
Erste Seitenzahl für Schrift- und Farbinformation.
-t <toPage>
Letzte Seitenzahl für Schrift- und Farbinformation.
-o <sections>
Nur Informationen für den angegebenen Bereich ausgeben. Die Vorgabe ist All. Dadurch werden alle verfügbaren Informationen ausgegeben.
-m
Ein anderes Ausgabeformat für Werte und Flags benutzen, welches zur Weiterverarbeitung geeignet ist.
Extraktionsmodus:
-x <objNo>
Objekt mit der Nummer <objNo> extrahieren.
-s <objNo>
Einen Stream komprimiert aus dem Objekt mit der Nummer <objNo> extrahieren.
-d <objNo>
Einen Stream unkomprimiert aus dem Objekt mit der Nummer <objNo> extrahieren.
Beispiele:
Beispiel 1:
Die beiden Befehle sind gleichwertig:
pdfinfo Doc.pdf
pdfinfo -o All Doc.pdf
Beispiel 2:
Informationen zu allen Bildern in "Doc.pdf" abrufen:
pdfinfo -o Image Doc.pdf
# pdfinfo 3.0.0
Image: Page=18, BBox=207.6720/371.4596/ 264.3224/443.6887, Resolution=278.3387/593.1125, BPP=8, ColorSpace=DeviceGray, Filters=FlateDecode
Image: Page=18, BBox=225.1510/387.2033/ 237.4971/397.1024, Resolution=194.9898/194.9960, BPP=8, ColorSpace=DeviceRGB, Filters=FlateDecode
Beispiel 3:
Informationen zu Transparenzen in "Doc.pdf" abrufen:
pdfinfo -o Transparency Doc_1.pdf
# pdfinfo 3.0.0
Transparency: Page=1, Transparencies=no
Transparency: Page=2, Transparencies=yes
Transparency: Page=3, Transparencies=no
6.4 pdfnote
Mit dem Programm "pdfnote" können Sie einen Notizzettel mit frei wählbarem Text an einer beliebigen Stelle in einem PDF-Dokument <pdffile> einfügen. Dabei können Sie den Titel des Notizzettel-Fensters festlegen und vorgeben, ob der Notizzettel beim Öffnen der entsprechenden Seite des PDF-Dokuments bereits geöffnet sein soll.
Gebrauch:
pdfnote [options] <pdffile>
6.4.1 Optionen
-n
Nummer der Seite, an der die Notiz eingefügt werden soll. Die Vorgabe ist -n 1 (Erste Seite).
-r
Position der Notiz auf der Seite. <location> wird folgendermaßen angegeben: <llx>:<lly>:<width>:<height>, wobei die linke untere x-Koordinate ("llx"), die linke untere y-Koordinate ("lly"), die Breite ("width") sowie die Höhe ("height") der rechteckigen Aussparung für die Notiz in der Einheit "Punkte" angegeben wird.
-t
Überschrift <title> erscheint im Titel der Notiz.
-s
Legt fest, dass die Notiz bereits geöffnet angezeigt wird.
-c
Inhalt der Notiz. Wird -c nicht angegeben, wird der Inhalt von "stdin" gelesen.
-h
Hilfe
Beispiel:
pdfnote -r 10:400 -t "Joe" -c "OK" Doc1.pdf
pdfnote -r 10:10:200:200 -t "Info" Doc2.pdf < info.txt
6.5 pdftoeps
EPSF-Dateien können von verschiedenen Programmen (z. B. FreeHand oder Photoshop) erzeugt werden und eine unterschiedliche Struktur besitzen. Ein Einsatzbereich von "pdftoeps" ist es, PDF als Austauschdateiformat verwenden zu können, und das Programm zur Erzeugung von EPSF-Dateien gleichartiger Struktur aus den hereinkommenden PDF-Dateien zu nutzen. Dieses Hilfsprogramm steht nur Anwendern von ImageServer zur Verfügung.
Wenn Sie in einer reinen EPSF-Umgebung arbeiten, aber PDF-Dateien von Ihren Kunden angeliefert bekommen, dann können Sie das "pdftoeps"-Programm verwenden, um die PDF-Dokumente in EPSF-Dateien umzuwandeln. Sie können für die Umwandlung den Zielfarbraum, die Auflösung und den Dateityp (Mac-EPSF oder PC-EPSF) vorgeben. Ein Anwendungsbeispiel für die "pdftoeps"-Nutzung sehen Sie in Abb. 10. Das Diagramm zeigt eine Situation, in der "pdfcat" und "pdftoeps" gemeinsam eingesetzt werden, um ein mehrseitiges PDF in mehrere Einzelseiten-EPSF-Dateien umzuwandeln.
Abb. 10: EPSF-Dateien mit dem "pdftoeps"-Programm anlegen

Schriftenqualität
Wir haben unserem Produkt 131 PostScript 3-Schriften beigelegt. Sie stehen nach der Installation und der korrekten Freischaltung von PDF HandShake automatisch zur Verfügung. Sie garantieren hohe Qualität im Ausdruck, in der Bildschirmdarstellung und in den Platzierungsbildern (bei der Verwendung von ImageServer). Die mitgelieferten Schriften sind im Anhang A 5 "Mitgelieferte Schriften" aufgelistet.
6.5.1 Optionen
-P
Passwort zum Öffnen eines PDF-Dokuments. Dies wird benötigt falls <pdffile> durch ein "Open Password" geschützt ist.
-v
Zeigt Aktivitätsberichte während der Umwandlung von PDF zu EPSF an.
-m
Erzeugt Mac EPSF-Dateien (vergl. auch Anhang A 6 "Glossar" und die Option -p unten).
-p
Erzeugt plattformübergreifende EPSF-Dateien (das Gegenteil der Option -m oben). Wenn keine der beiden Optionen festgelegt wird, hängt die Vorgabe davon ab, wo die gewählte PDF-Datei gespeichert ist und ob es sich bei dem Speicherort um ein Macintosh-Volume handelt. Wenn die Konfiguration des entsprechenden Volumes auf plattformübergreifende Platzierungsbilder eingestellt ist, dann sind auch die resultierenden EPSF-Dateien plattformübergreifend.
-r
Stellt die Rasterauflösung in dpi ein, die für den druckfähigen Teil der EPSF-Voransichten verwendet werden soll. Dieser Parameter muss durch einen Fließkommawert (z. B. 72.0) ergänzt werden. Wenn Sie -r nicht festlegen, wird die Rasterauflösung der Elemente der PDF-Eingangsdatei benutzt.
-c
Definiert den Farbraum, der für den druckfähigen Teil der EPSF-Voransichten verwendet werden soll. Der Parameter muss durch eine Zeichenkette, wie beispielsweise "CMYK", ergänzt werden. Gültige Werte für Zeichenketten finden Sie in der Tabelle (Abb. 11) unten. Wenn Sie -c nicht festlegen, wird die Vorgabe des OPI-Servers benutzt.
-R
Stellt die Rasterauflösung in dpi ein, die für die Bildschirm-voransichten der EPSF-Datei verwendet wird. Dieser Parameter muss durch einen Fließkommawert (z. B. 72.0) ergänzt werden. Wenn Sie -R nicht festlegen, wird die Vorgabe des OPI-Servers benutzt.

Hinweis: Wählen Sie einen vernünftigen Wert für die Auflösung der Composite-Voransicht. Eine übertriebene Auflösung könnte zu einem Überlauf des virtuellen Speichers (VM) sowie des RAM führen.

-C
Definiert den Farbraum für die Bildschirmvoransicht der EPSF-Datei. Der Parameter erfordert eine Zeichenkette wie z. B. "Grayscale". Gültige Werte für Zeichenketten entnehmen Sie der Tabelle (Abb. 11) unten. Wenn Sie -C nicht festlegen, wird die Vorgabe (RGB) benutzt.
-h
Zeigt den Online-Hilfetext.
Abb. 11: Liste der EPSF-Farbräume
Farbraumnamen
None
HSV
YCbCr
Spot
HLS
CIELab
Bilevel
CMY
CIEXYZ
Grayscale
CMYK
CIELuv
Indexed
Multi
CIEYxy
RGB
Duotone
YCC
-
-

Alle Optionen des "pdftoeps"-Programms sind optional. Sie sollten allerdings Parameter wie -m oder -p genau festlegen, wenn Sie sich bei den aktuell gültigen Standards nicht sicher sind.
Beachten Sie, dass bei allen "pdftoeps"-Optionen die Parameter und Werte durch ein Leerzeichen getrennt sein müssen (s. Beispiel unten).
Nach den Optionen müssen Sie eine oder mehrere Dateien zur Umwandlung sowie eine Zieldatei (wenn Sie eine Einzeldatei umwandeln), bzw. ein Zielverzeichnis (wenn Sie mehrere Dateien umwandeln) angeben. Das Ziel kann einen kompletten UNIX-Pfadnamen enthalten.
Beispiel:
pdftoeps -m -c CMYK -C RGB file1 file2 /user/tmp
Vorseparierte PDF-Dokumente
Das "pdftoeps"-Programm erkennt vorseparierte PDF-Dokumente. Es erzeugt DCS-Dateien mit farbigen Standard-Bildschirmvoransichten (abhängig von der Server-Konfiguration). Die Voransichten sind pixelbasiert und haben eine maximale Auflösung von 150 dpi.
Die DCS-Dateien sind als DCS 1- oder DCS 2-Mehrfach-dateien gespeichert. Für die CMYK-Auszüge werden die Suffixe .C, .M, .Y und .K verwendet. Den Schmuckfarbenauszügen werden andere, bislang unbenutzte Buchstaben aus dem Alphabet zugewiesen. Das Suffix steht in keiner Beziehung zu dem Namen der Schmuckfarbe.
6.6 pdfprint
Mit "pdfprint" können Sie PDF-Dateien direkt vom Server aus in jede beliebige HELIOS Druckerwarteschlange ausgeben (vergl. Abb. 12). Zusätzliche Eigenschaften wie Farbanpassung und Proofdruck stehen für jede Warteschlange zur Verfügung. Vorseparierte Dateien können nicht Composite ausgegeben werden. Diese Eigenschaft steht nur im OPI-Workflow zur Verfügung.
Abb. 12: PDF-Dateien direkt vom Server ausgeben

PDF Druck-Plugin für Acrobat
Das Druck-Plugin für Acrobat oder den Adobe Reader (siehe 8.2 "PDF-Dateien mit dem Acrobat-Plugin drukken") ist zur Zeit nur für den Macintosh verfügbar. Es hat die gleichen Eigenschaften wie das "pdfprint"-Programm und druckt genauso über jede EtherShare-/PDF HandShake- Druckerwarteschlange aus (Abb. 13). Auch hier können ohne die Nutzung von ImageServer vorseparierte PDF-Dateien nur als Auszüge ausgegeben werden.
Abb. 13: PDF-Dateien mit dem Acrobat-Plugin ausdrucken

PDF-Erweiterung für ImageServer
Mit PDF HandShake und ImageServer können Sie das PDF-Dateiformat als Eingangsformat für die ImageServer-Layouterzeugung verwenden. Zusätzlich können Sie mit dem "PDF Handshake"-Acrobat-Plugin (oder dem "pdfprint"-Programm) PDF-Dateien zur weiteren Nutzung in Ausschießprogramme exportieren. Abb. 14 zeigt diese beiden Möglichkeiten in einem Überblick.
Abb. 14: Optionen des ImageServer-Servers für PDF-Dateien

Der OPI-Server verwendet die erste Seite eines PDF-Dokuments für die Layouterzeugung. Weitere Seiten in der PDF-Datei werden ignoriert. Die erzeugten Platzierungsbilder werden für Composite-PDFs im EPS- sowie bei vorseparierten PDF-Dateien im DCS-Format gespeichert. So können Sie die Platzierungsbilder in jedem gängigen Layoutprogramm (wie QuarkXPress, InDesign) sowie in jedem Anzeigen- und Redaktionssystem platzieren.
Gebrauch:
pdfprint [options] <PdfFilename> [<psFilename>]
6.6.1 Optionen
Der Gebrauch sowie die Optionen von "pdfprint" finden Sie in Kapitel 8.1.2 "Optionen".
6.7 pdfresolve
Mit "pdfresolve" können Sie OPI-Referenzen in PDF-Dokumenten ersetzen. Programme wie QuarkXPress oder InDesign können Dokumente im eigenen Format (nativ) als PDF-Datei exportieren. Enthalten die nativen Dokumente platzierte Bilder mit OPI-Referenzen, können diese während des Exportierens beibehalten werden. Die OPI-Referenzen werden dafür verwendet, graue Platzhalter oder Layoutbilder mit den hochaufgelösten Originalbildern vor oder während des Druckens zu ersetzen.
OPI 1.3 Referenzen enthalten den Pfadnamen der platzierten Bilddatei und zusätzlich eine optionale Macintosh Datei-ID. Während der Auflösung der OPI-Referenzen sucht "pdfresolve" nach dem passenden hoch- oder niedrigaufgelösten Bild. Eine Bildsuche besteht aus einer Abfolge von Methoden: Suche über den Pfadnamen, Suche in zusätzlichen Suchpfaden, Suche über die Macintosh Datei-ID oder die Suche in zusätzlichen Volumes. Eine Bildsuche ist dann abgeschlossen, wenn eine der Methoden Erfolg hatte. Wird ein niedrigaufgelöstes Bild gesucht, wird das gefundene Bild für die Bildersetzung verwendet, unabhängig davon ob es eine hohe oder niedrige Auflösung besitzt. Wird ein hochaufgelöstes Bild gesucht und gefunden, wird es für die Bildersetzung verwendet. Wird dagegen ein hochaufgelöstes Bild gesucht, aber ein niedrigaufgelöstes gefunden, wird die OPI-Referenz des niedrigaufgelösten Bildes für eine weitere Bildsuche nach dem hochaufgelösten Bild benutzt. Eine Kette von niedrigaufgelösten Bildern, die auf ein hochaufgelöstes Originalbild verweisen, darf die Anzahl von 7 niedrigaufgelösten Bildern nicht überschreiten.
"pdfresolve" hat den weiteren Vorteil, dass Transparenzen, die den Layoutbildern zugewiesen worden sind, währen der OPI-Bildersetzung beibehalten werden. Diese Funktion steht nur Anwendern von ImageServer zur Verfügung.

Hinweis: OPI-Referenzen in PDF-Dokumenten werden immer in Formular-Streams mit OPI-Einträgen eingebettet. Diese werden kurz OPI-Formulare genannt. "pdfresolve" ersetzt OPI 1.3-Formulare in Composite PDF-Dokumenten; vorseparierte PDF-Dokumente werden nicht unterstützt. Es können nur Rasterbilder referenziert werden; Referenzen auf PDF- und objektbasierte EPSF-Dateien werden nicht unterstützt. Während der Bildersetzung werden alle Eingangsdateien sowie die Ausgangsdatei schreibgeschützt, um eine sichere Bildersetzung auch mit mehreren Benutzern und unter NFS zu gewährleisten.

Anweisungen dazu, wie ein überwachter Ordner ("Hot Folder") für den nativen PDF OPI-Workflow aufgesetzt wird, finden sie in Kapitel 12 "PDF OPI-Workflow".
Gebrauch:
pdfresolve [-lv] -P <printer> [-g <logFile>]
[-o <key>=<value>]- <inDoc> <outDoc>
6.7.1 Optionen
-l
Standardmäßig werden hochaufgelöste Bilder eingefügt. Ist diese Option gesetzt, werden niedrigaufgelöste Bilder, sofern vorhanden, eingefügt.
-v
Zeigt den Fortschritt der Verarbeitung durch "pdfresolve" an.
-P <printer>
Ersetzt OPI-Objekte gemäß den Einstellungen für die Drucker-Warteschlange <printer>. OPI muss für die Warteschlange aktiviert sein. Diese Option ist verbindlich.
-g <logFile>
Bei Warnungen oder Fehlermeldungen wird ein Logdatei <logFile> mit Fehlerbeschreibung erzeugt.
-o <key>=
<value>
Setzt einen Parameter-Key <key> auf den Wert <value>.

Hinweis: Kommandozeilen-Optionen haben eine höhere Priorität als dateispezifische Präferenzen, welche wiederum globale Präferenzen sowie Präferenzen für die Drucker-Warteschlange überschreiben. Bei Parameter-Keys auf der Kommandozeile muss man - im Gegensatz zu Präferenzen - Groß- und Kleinschreibung nicht beachten.

6.7.2 Zulässige Parameter
ImageSearchPaths
Liste zusätzlicher Suchpfade. Eine Suche in zusätzlichen Pfaden macht Dateien mit passendem Grundnamen ausfindig. Der Typ ist strlist.
ImageIDsearch
Bestimmt, ob Bilder mittels der Macintosh Datei-ID gesucht werden. Die Suche über die Datei-ID holt zuerst Informationen über die Art des Volumes aus der Datei-ID und sucht dann eine Datei mit passender Datei-ID in der Desktop-Datenbank des angegebenen Volumes. Der Typ ist bool.
ImageSearchVolumes
Liste zusätzlicher Volumes, in denen gesucht wird. Die Suche in zusätzlichen Volumes benutzt die Desktop-Datenbanken, um Dateien mit passendem Grundnamen zu finden. Dateien im Netzwerk-Papierkorb, Dateien mit Layoutnamenserweiterung oder Dateien, die sich in Layout-Ordnern befinden werden bei der Suche übergangen. Diese Suche hat nur dann Erfolg, wenn es genau eine passende Datei gibt. Der Typ ist strlist.
LayoutSuffix
Dateien mit dieser Namenserweiterung werden wie Layouts behandelt, d. h. sie werden nicht in die Suche in zusätzlichen Volumes eingeschlossen. Der Typ ist str.
CheckImages
Wird diese Option auf TRUE gesetzt, werden Fehlermeldungen für referenzierte, aber nicht vorhandene Bilder erzeugt. Ist die Option auf FALSE gesetzt, werden Warnungen für referenzierte, aber nicht vorhandene Bilder erzeugt und das OPI-Formular bleibt unverändert. Der Typ ist bool.
ProfileRepository
Gibt den Namen des Volumes an, welches die ICC-Profile beinhaltet. Ein ICC-Profil wird zuerst hier gesucht, und erst danach in den durch den Parameter ProfileSearchPaths bestimmten Verzeichnissen. Der Typ ist str.
ProfileSearchPaths
Benennt zusätzliche Verzeichnisse, in denen ICC-Profile gesucht werden. Der Typ ist strlist.
CompositeColorspace
Legt den Ausgabefarbraum für Quellbilder fest, deren Farbraum nicht Schwarzweiß oder Graustufen ist. Der Wert muss entweder None, Grayscale, RGB, CMYK oder CIELab sein.
DefaultPrinterProfile
Legt das Ausgabeprofil für Quellbilder fest, deren Farbraum nicht Schwarzweiß oder Graustufen ist. Das Ausgabeprofil muss zu dem Wert des Parameters CompositeColorSpace passen. Der Typ ist str.
PrintRenderingIntents
Legt die Strategie fest, die das Farbanpassungsmodul bei der Umwandlung zwischen beliebigen Quell- und Drucker-Farbräumen anwendet. Die Syntax ist:
<sourceA>:<printerA>:<intentA>,<sourceB>:<printerB>:
<intentB>,-
DefaultProofProfile
Legt das Proofprofil für Quellbilder fest, deren Farbraum nicht Schwarzweiß oder Graustufen ist. Der Typ ist str.
ProofRenderingIntents
Legt die Strategie fest, die das Farbanpassungsmodul bei der Umwandlung zwischen beliebigen Quell- und Proof-Farbräumen anwendet. Die Syntax ist:
<printerA>:<proofA>:<intentA>,<printerB>:<proofB>,
<intentB>,-
PreferredCMM
Bestimmt das bevorzugte Farbanpassungsmodul (CMM). Der Typ ist str.
RenderingQuality
Bestimmt die Qualität der Farbanpassung über CMM. Der Wert muss 0 (Normal), 1 (Entwurf) oder 2 (Maximal) sein.
CheckICCProfiles
Legt fest, ob für fehlende ICC-Profile Fehlermeldungen erzeugt werden. Der Typ ist bool.
IgnoreUntagged
Ist DefaultPrinterProfile nicht gesetzt oder CheckICCProfiles inaktiv, wirkt sich diese Option nicht aus. Diese Option bestimmt, ob Fehlermeldungen für farbige Quellbilder erzeugt werden, die nicht mit einem ICC-Profil versehen sind und die nicht durch die Option PreserveDeviceN von der Farbanpassung ausgenommen sind. Der Typ ist bool.
TagReplacedImages
Legt fest, ob ersetzte Bilder - wenn möglich - mit Drucker- oder Proofprofilen versehen werden. Ist diese Option aktiviert und ein Druckerprofil definiert, so wird ein ersetztes Farbbild mit dem Drucker- oder Proofprofil versehen. Ist diese Option aktiviert und kein Druckerprofil definiert, so wird ein ersetztes Farbbild mit dem Profil des Quellbildes versehen, allerdings nur dann, wenn keine Farbumwandlung notwendig ist. Der Typ ist bool.
IgnoreSpots
Legt fest, ob Schmuckfarben in Quellbildern ignoriert werden. Werden Schmuckfarben nicht ignoriert, werden sie in Prozessfarben gewandelt, es sei denn der Farbraum des Quellbildes ist CMYK mit zusätzlichen Kanälen für Schmuckfarben und PreserveDeviceN ist gesetzt. Der Typ ist bool.
CustomColorTinting
Legt fest, ob Schmuckfarben aus eingefärbten Schwarzweiß- und Graustufenbilder erzeugt werden, falls die Einfärbung den DeviceN-Farbraum nicht benötigt. Um Schmuckfarben auch im DeviceN-Farbraum beizubehalten, muss sowohl die Option CustomColorTinting als auch PreserveDeviceN aktiviert sein. Der Typ ist bool.
PreserveDeviceN
Legt fest, ob aus Quellbildern im CMYK-Farbraum Bilder im DeviceN-Farbraum mit zusätzlichen Kanälen für Schmuckfarben erzeugt werden. Werden Bilder im DeviceN-Farbraum erzeugt, ist die Farbanpassung abgeschaltet. Der Typ ist bool.
ColorAliases
Liste von Alias-Farbnamen. Die Ersetzung von Farbnamen wird auf die Namen von Prozess- und Schmuckfarben in Quellbildern und OPI-Referenzen angewandt. Die Syntax ist: <nameA>=<aliasA>,<nameB>=<aliasB>,-
DownSampling
Bestimmt, ob ein Bild heruntergerechnet wird. Der Typ ist bool.
FixedSampling
Ist das Herunterrechnen eines Bildes nicht aktiviert, bleibt diese Option ohne Auswirkung. Ist das Herunterrechnen aktiviert, bestimmt diese Option, ob das Hochrechnen von Bildern möglich ist. Der Typ ist bool.
FastDownSampling
Bestimmt, ob der "schnelle-Auswahl"-Algorithmus oder der Mittelwert-Algorithmus zum Herunterrechnen verwendet wird. Der "schnelle-Auswahl"-Algorithmus ist schnell bei minderer Qualität während der Mittelwert-Algorithmus langsamer ist aber dafür eine hohe Qualität bietet. Der Typ ist bool.
Resolution
Bestimmt die Auflösung (in dpi) eines Bildes beim Herunterrechnen. Der Typ ist positiv double.
ICMethodBilevel, ICMethodGrayscale, ICMethodRGB, ICMethodCMYK, ICMethodCIELab, ICMethodOther
Diese Parameter bestimmen die Komprimierungsmethode für Bilder im entsprechenden Ausgabefarbraum. Der Wert muss entweder None, Compress, CCITTG4, JPEG, JPEG 2000, oder Flate sein.
ICQualityBilevel, ICQualityGrayscale, ICQualityRGB, ICQualityCMYK, ICQualityCIELab, ICQualityOther
Diese Parameter bestimmen die Qualität der JPEG- und JPEG 2000-Komprimierung für Bilder im entsprechenden Ausgabefarbraum. Der Typ ist double und der Wert liegt zwischen 0 und 100.
Zulässige Farbräume sind: None, Spot, Bilevel, Grayscale, Indexed, RGB, HSV, HLS, CMY, CMYK, Multi, Duotone, YCbCr, CIELab, CIEXYZ, CIELuv, CIEYxy, YCC.
Zulässige Werte für das "Rendering intent" sind : 0 für perceptual, 1 für relative colorimetric, 2 für saturation, 3 für absolute colorimetric.
6.8 PDF-Check mit "pdfInspektor"
Die PDF HandShake Software enthält mit "pdfInspektor" eine leistungsfähige Lösung zum Analysieren von PDF-Dateien und zum Prüfen, ob sich ein- oder ausgehende PDF-Dateien zur Produktion eignen. Rund 400 PDF-Charakteristika werden geprüft, wobei das Ergebnis in verschiedenen Dateiformaten angezeigt werden kann. Stellen im Dokument, die zu Problemen führen könnten, werden in einem ASCII- oder XML-Bericht zur automatischen Auswertung ausgegeben. Die Berichte können - falls erforderlich - auch als PDF-Datei ausgegeben werden.
Gebrauch des Programms "pdfInspektor2_CLI":
cd /usr/local/helios
callas/pdfInspektor2_CLI.sh [OPTION [-]] PDF-FILE [-]
Die PDF-Datei PDF-FILE wird gegen einen Regelsatz, das Profil, geprüft. Dieses Profil ist über die Option
--profile-file definiert.
6.8.1 Optionen
-f
Datei mit einem einzelnen Profilpaket (erzeugt vom Adobe Acrobat Preflight- oder pdfInspektor-Plugin; der Pfad zu dem Paket kann in der Initialisierungsdatei angegeben werden).
Alternativer Gebrauch: --profile-file=FILE
-b
Erzeugt eine Aufschlüsselung in der Datei FILE (enthält die gesamten PDF-Daten, die der Überprüfung nicht standgehalten haben; wird FILE nicht angegeben, wird standardmäßig die Einstellung aus der Initialisierungsdatei gelesen).
Alternativer Gebrauch: --breakout[=FILE]
-r
Erzeugt einen Ergebnisbericht (einfache Textdatei; wird FILE nicht angegeben, wird standardmäßig die Einstellung aus der Initialisierungsdatei gelesen).
Alternativer Gebrauch: --report[=FILE]
-x
Ändert das Dateiformat des Berichts nach XML (und kodiert es nach UTF-8).
Alternativer Gebrauch: --xml
-o
Kompaktbericht im Textformat (weder mit XML noch mit Kurzbericht kombinierbar).
Alternativer Gebrauch: --compact
-a
Erzeugt Bericht, auch wenn keine Regelverstöße vorliegen.
Alternativer Gebrauch: --always
-s
Erzeugt Kurzbericht oder Aufschlüsselung (sowohl Text als auch XML).
Alternativer Gebrauch: --short
-k
Kodierung für den Kompaktbericht (-o).
utf8: 1,
utf16BE: 2,
utf16LE: 3
Alternativer Gebrauch: --encoding
-e
Setzt Zeilenenden für den Textbericht.
0 for \n (default),
1 for \r\n
Alternativer Gebrauch: --line-endings[=NUM]
-p
Nur Seiten im Bereich FROM bis TO werden geprüft. Standardmäßig wird von der ersten bis zur letzten Seite geprüft.
Alternativer Gebrauch: --pages=[FROM][:TO]
-1
Umwandlung nach pdfX1a. FILE muss der Pfad-/Dateiname zur PDFXSetFile sein.
Alternativer Gebrauch: --pdfx1a[=FILE]
-3
Umwandlung nach pdfX3. FILE muss der Pfad-/Dateiname zur PDFXSetFile sein.
Alternativer Gebrauch: --pdfx3[=FILE]
-d
Bestimmt die Ausgangsdatei für die Umwandlung nach pdfx.
Alternativer Gebrauch: --pdfx-file[=FILE]
-l
Setzt die Sprache des Berichts auf LANG:
ENG, GER, FRE, SVE, PTB, NLD, JAP, ITA, ESP, DAN (Vorgabe ist ENG=Englisch)
Alternativer Gebrauch: --lang=LANG
-v
Bestimmt den Umfang des Verarbeitungsberichts NUM (1-15, Vorgabe ist 1); binäre Oder-Verknüpfung von:
1: Zeigt die wichtigsten Verarbeitungsschritte an
2: Zeigt Regelverletzungen sofort an
4: Fortschrittsanzeige
8: Zeigt interne Paramter für die Fehlerbeseitigung an
Alternativer Gebrauch: --verbose[=NUM]
-q
Keine Ergebnisausgabe nach Prüfung.
Alternativer Gebrauch: --quiet
-h
Hilfetext darstellen.
Alternativer Gebrauch: --help
6.8.2 Mitgelieferte Beispielskripte
Die folgenden Beispielskripte werden von HELIOS für den PDF-Check mitgeliefert:
inspectPDF-notify
PDF-Check Aktionsskript. Wird über die "Create PDF"-Druckerwarteschlange angewandt. Siehe Kapitel 11 "Create PDF Server".
inspectPDF-scriptserver
PDF-Check Aktionsskript, das über einen überwachten Ordner des Script Servers angewandt wird. Lesen Sie dazu das Kapitel "Script Server" im ImageServer Handbuch.

© 2005 HELIOS Software GmbH