CIB format technischer Leitfaden (DE)

4. Ausgabemodule

4.10. CIB format/png

Allgemein
 Spezielle Properties der CIB format/png Komponenten
 Spezielle Properties zum Ändern des Seitenformats

Allgemein

(ab CIB format Version 5.3.233)

Das CIB format/png Modul erzeugt aus dem Dokument einen PNG-Datenstrom der in einer Datei ausgegeben wird.

PNG (Portable Network Graphics) ist ein Grafikformat für Rastergrafik mit verlustfreier Bildkompression. Es wurde als freie Software ein Ersatz für das ältere, bis zum Jahr 2004 mit Patentforderungen belastete GIF-Format (Graphics Interchange Format) entworfen und ist weniger komplex als TIFF (Tagged Image File Format). PNG unterstützt neben unterschiedlichen Farbtiefen (Computergrafik) auch Transparenz per Alphakanal. PNG kann Pixel aus einer Farbpalette mit bis zu 256 Einträgen verarbeiten. Darüber hinaus ist die Speicherung von Graustufenbildern mit 1, 2, 4, 8 oder 16 Bit und Farbbildern (RGB-Farbraum) mit 8 oder 16 Bit pro Kanal (also 24 beziehungsweise 48 Bit pro Pixel) möglich.

 

Beispiel mit CIB runshell:

cibrsh -gp Test.rtf
Das zweiseitige Dokument Test.rtf erzeugt die Ausgaben Test00001.png und Test00002.png.


Spezielle Properties der CIB format/png Komponenten

Optionsname

Optionswert

Datentyp

OutputFormat

Diese Property kann mit dem Wert "FormatPng" belegt werden

Char*

OutputFilename

Name der Ausgabedatei in die PNG-Daten geschrieben werden.

Ist keine Ausgabedatei angegeben, wird der Name der Eingabedatei verwendet und mit dem Suffix „png“ versehen. Pro Seite des Dokuments wird eine eigene PNG-Datei angelegt, wobei die Dateien durch Anhängen einer fortlaufenden Nummer an den Dateinamen eindeutig gemacht werden, z.B. DATEI00001.png, DATEI00002.png, usw.

Char*

InputFilename

Name der Eingabedatei, die in PNG-Format umgewandelt werden soll.

Char*

ImageColorDepth

 

(ab CIB format Version 7.0.0a)

Optionen für die Farbtiefe.

Gültige Werte sind:
2Colors
16Colors          (Derzeit nur für RenderingEngine=CIBRenderer)
256Colors
256Grayscale
TrueColor (24Bit, Default)

Char*

TiffColorDepth

 

 

 

 

(ab CIB format Version 7.0.0a)

Optionen für die Farbtiefe.

Gültige Werte sind:
2Colors
256Colors
256Grayscale
TrueColor (24Bit, Default)

Abgelöst durch die Property ImageColorDepth, d.h. TiffColorDepth wird nur dann berücksichtigt, wenn ImageColorDepth nicht gesetzt ist.

Char*

TiffResolution

 

Auflösung

Long

PngCompressLevel

(ab CIB format Version 5.3.235)

Steuerung des Maßes der Kompression der Grafik beim Speichern.

Die Schreibgeschwindigkeit kann durch Verringern der Kompression (und damit Erhöhen der Dateigröße) erhöht werden. So wird bei Verdoppeln der Dateigröße die Datei fünfmal so schnell geschrieben.

Mögliche Werte:
-1        Standard-Wert für PNG  Kompression

0          Keine Kompression

9          Maximale Kompression

2          Default

Char*

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. 

 
Achtung:

Änderungen im Seitenformat bewirken keine Skalierung. Tabellen oder Grafiken werden ggf. abgeschnitten. Fließtexte werden so umgebrochen, dass sie auf das neue Seitenformat passen, was zur Erzeugung zusätzlicher Ausgabe-Dokumente führen kann.

Char*