CIB format technischer Leitfaden (DE)

4. Ausgabemodule

4.6. CIB format/pcl

Allgemein
Spezielle Properties für PCL Ausgabe
Spezielle Properties zum Ändern des Seitenformats

Allgemein

Das CIB format/pcl Modul erzeugt aus dem Dokument einen PCL-Datenstrom der in einer Datei oder direkt an einen (pcl-fähigen) Drucker ausgegeben wird. Der Anwender kann individuell bestimmten, welche PCL Spezifikation als Basis dient.

Die Properties InputFilename, OutputFormat und FontWorkSpace sind zwingend zu setzen. Auf Unix Plattformen kann auch der Hinweis auf ein PpdFilename optional angegeben werden. Aus dieser Datei besorgt sich CIB format/pcl dann wichtige Informationen über die Druckereigenschaften. Fehlt diese Vorgabe, dann arbeitet CIB format/pcl mit Defaultwerten (300 dpi Auflösung, 0,6 linker unbedruckbarer Rand, 0,4 mm oberer unbedruckbarer Rand, Standardschacht und kein Duplexdruck).


Spezielle Properties für PCL Ausgabe

Optionsname

Optionswert

Datentyp

OutputFormat

In diese Property muss der Wert "FormatPcl" oder „FormatPrinterPcl“ gesetzt werden

Char*

DuplexPrint

VERALTET: Zweiseitiger Druck (An, Aus)

Long (boolean)

DuplexPrint2

Einschalten des Doppelseitiger Drucks (Default, Kurze und Lange Seite, Simplex)

"DuplexPrintShort":
Es wird beidseitig bedruckt, wobei das Blatt wie bei einem Kalender an der kurzen Seite gedreht wird (falls lt. PPD-Datei möglich).

"DuplexPrintLong":
Es wird beidseitig bedruckt wobei das Blatt wie bei einem Buch an der langen Seite gedreht wird (falls lt. PPD-Datei möglich).

"SimplexPrint":
Es wird einseitig bedruckt.

"DuplexDefault" (default):
Bis CIB format Version 5.3.228: Es wird unter Windows der im Druckertreiber gesetzte Standardwert verwendet. Unter Linux/Unix wird der Wert aus der per Property gesetzten PPD-Datei verwendet. Ist keine PPD-Datei vorhanden, wird DuplexPrintLong verwendet.

Ab CIB format Version 5.3.229 Es wird kein Duplex-Eintrag in den PCL-Datenstrom geschrieben. Das führt dazu, dass für den Druck der am Drucker (oder Druckertreiber) eingestellte Wert verwendet wird.

Char*

FontWorkSpace

Die Fonts aus diesem Verzeichnis werden zur CIB format/pcl Ausgabe verwendet. Für CIB format/pcl muss ein FontWorkSpace gesetzt werden.

Char*

OutputFilename

Name der Ausgabedatei in welche der PCL Datenstrom geschrieben wird.

Char*

PaperBin

(Unterstützung aller Werte ab CIB format Version 5.3.231)

Eingabe des gewünschten Drucker-Schachts für die PCL-Ausgabe. Im PCL-Datenstrom wird die Schachtbezeichnung in eine Nummer (NR) umgesetzt (PCL-Befehl: Esc&lNR#). 

Schacht-Tabelle:

 "BinOnlyOne"                  7 

 "BinLower"                      5

 "BinManual"                    2

 "BinMiddle"                     1

 "BinUpper"                       4

 "BinLargeCapacity"        5

 "BinTray5"                        9

 "BinEnvelope"                  6

 "BinDefault"                     kein Schacht
                                           (kein Befehl im PCL-Datenstrom)

Char*

PclHeader

Gibt einen Dateinamen zu einer binaeren Datei mit dem gewünschten PCL-Header an.

Dieser wird als zusätzlicher Header ins entstehende PCL eingefügt. Siehe auch Property "PclTrailer.

Char*

PclHeaderData

Setzt den PCL-Header direkt. Das heißt, die im PCL-Header gewünschten binären Daten werden als eine Zeichenfolge (Beispiel "ab010203cf...") angegeben. Diese werden als zusätzlicher Header ins entstehende PCL eingefügt.

Die Property wird nur ausgewertet, wenn die Property "PclHeader" leer ist.

Char*

PclLevel

Default: Level 5

Gibt den PCL Level der im Zielformat erzeugt werden soll:

Gültige Werte:

"Level3"
"Level5"

Char*

PclTrailer

Zusätzliche Anweisung, die der PCL Datei binär angehängt wird. Gibt somit einen Dateinamen zu einer binären Datei mit dem gewünschten PCL-Trailer an. Dieser wird als zusätzlicher Trailer an das entstehende PCL angehängt.

Char*

PclTrailerData

Setze den PCL-Trailer direkt. Das heißt, die im PCL-Trailer gewünschten binaeren Daten werden als eine Zeichenfolge (Beispiel "ab010203cf...") angegeben. Diese werden an das entstehende PCL angehängt.

Die Property wird nur ausgewertet, wenn die Property "PclTrailer" leer ist.

 

PjlComment

Setzt im PCL PJL Kommentare ab, welche mit „;“ getrennt anzugeben sind.

Zum Beispiel für die Canon Drucker Funktion „Lochen und Heften“ ist folgendes anzugeben

"CANPJL SET PUNCH = LEFT;CANPJL SET STAPLE = ONEUPLEFT"

 

PpdFilename

Zur CIB format/pcl Ausgabe wird eine druckerspezifische
PPD Datei (=PostScript Printer Definition) benötigt. Pfad
und Name der PPD Datei müssen hier gesetzt werden.

Char*

PrinterName

Im Falle einer Nutzung von der CIB format/pcl Ausgabe ist hier der (komplette) Name einer PPD Datei (=PostScript Printer Definition) anzugeben die für den Drucker auf dem gedruckt werden soll vorliegen muss.

Char*

PrinterIPAddress

IP-Adresse des Druckers auf dem ausgedruckt werden soll

Char*

UseSoftfonts

 

Alle verwendeten Fonts werden als Softfonts in den PCL Datenstrom geschrieben. Dies gewährleistet einen identischen Ausdruck unabhängig von den auf dem Drucker installierten Schriftarten. Die Dateigröße wird entsprechend größer. Default ist FALSE.

Bool


Spezielle Properties zum Ändern des Seitenformats

Diese Properties können nicht im RTF über PRINT CIB Befehl gesetzt werden.

Optionsname

Optionswert

Datentyp

PaperWidth

Seitenbreite.

Char*

PaperHeight

Seitenhöhe

Char*

MarginLeft

Breite linker Rand

Char*

MarginRight

Breite rechter Rand

Char*

MarginTop

Breite oberer Rand

Char*

MarginBottom

Breite unterer Rand 

Alle Angaben zum Seitenformat erfolgen in Twips (567 twips = 1 cm).

So ergeben z.B. die Angaben PaperHeight=11907 und PaperWidth=16840 ein DIN A4 Querformat.

Änderungen im Seitenformat bewirken keine Skalierung. Texte werden so umgbrochen, dass sie auf das neue Seitenformat passen. Tabellen oder Grafiken werden ggf. abgeschnitten.

Char*

Hinweis:

Für C++-Anwender sind die Optionsnamen in separaten Headerdateien als defines hinterlegt.