CIB format technischer Leitfaden (DE)

4. Ausgabemodule

4.16. CIB format/doXiview

(ab CIB format 7.0.0)

Mit CIB doXiview können Dokumente zur einfachen Betrachtung in einem Browser über das Internet bereitgestellt werden. Dabei werden keinerlei Browser-Plugins oder weitere Programme am Arbeitsplatz benötigt. CIB doXiview unterstützt derzeit zur Anzeige neben PDF auch die Formate RTF, TXT, TIFF, JPEG, GIF, BMP und PNG.
Es folgt eine Liste von Properties, die in Zusammenhang mit CIB doXiview an den CIB format gesetzt werden können.

Spezielle Properties für den CIB format doXiview


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

Optionsname

Optionswert

Datentyp

OutputFormat

FormatWebview

Char*

GenerateDraftWebviewOutput

Char*

 

Über diese Property kann die Ausgabe eines Entwurfs unterdrückt werden.

 

Mögliche Werte:

„1“    CIB format erzeugt als Ausgabe einen Entwurf und finale PNGs für jede Seite.  (default)

„0“    CIB format erzeugt als Ausgabe nur finale PNGs für jede Seite.

 

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*

RenderingEngine

Über diese Property kann auf die Pango Cairo Rendering Engine umgeschaltet werden. Damit wird für die Ausgabe auf CIB doXiview eine umfassende Qualitätsverbesserung in der optischen Darstellung erzielt.

Mögliche Werte:

“WinGDI” – Windows Rendering-Engine wird verwendet (Default für Windows-Systeme)

“CIBRenderer” – Pango-Cairo Rendering-Engine wird verwendet

Char*

WebviewOutputConfiguration

Char*

(ab CIB format Version 7.0.0a)

 

Mit dieser Property kann die generierte Ausgabe für den CIB doXiview konfiguriert werden, sodass nur ein Ausgabeformat, statt standardmäßig Png und Metafile, erfolgt.

Mögliche Werte:

„Png“  bei gesetztem Wert wird pro Input-Dokumentseite ein Png-Bild für den CIB doXiview generiert

„Metafile“        bei gesetztem Wert wird pro Input-Dokumentseite ein Metafile für den CIB doXiview generiert

Default: „Png;Metafile

 

TiffResolution

Auflösung der Grafik-Ausgabe.
Defaultwert: 150 DPI

Long

ImageType

(ab CIB format Version 7.0.11)

Über diese Property kann angegeben werden, welche Grafikformate der CIB format in einem Rendering-Vorgang erzeugen soll. Derzeit sind hier nur spezielle Raster-Imageformate möglich.

Erforderlich ist RenderingEngine="CIBRenderer"

Mögliche Werte sind:
jpg, jpeg, png, tiff, tif

Beispiel:
ImageType="png;tiff;jpg"

Name der erzeugten Grafikdateien:

Um für die diversen Ausgabeformate einer Grafikdatei eindeutige Dateinamen zu erreichen, wird von der CIB pdf toolbox der Dateiname folgendermaßen aufgebaut:
<OutputFilename>-image<Seitennummer>-copy<Kopienummer>.<Dateierweiterung>

Beispiel:

OutputFormat=" FormatWebview "
ImageType="png;png;tiff"
ImageScaling="{50px;50px};{500px;500px};{300px;300px}"
OutputFilename="out.jpg"
2 Seiten

Ergibt die folgenden Dateien:
out-image00001-copy00001.png
out-image00001-copy00002.png
out-image00001-copy00003.tiff
out-image00002-copy00001.png
out-image00002-copy00002.png
out-image00002-copy00003.tiff

Hinweis:
Die Dateierweiterung von OutputFilename wird ignoriert, d.h. eine Datei "out.jpg" wird nicht erstellt, sondern nur die in ImageType definierten Dateitypen.

Char*

ImageScaling

(ab CIB format Version 7.0.11)

Über die Property kann die maximale Größe der Grafik spezifiziert werden.
Breite; Höhe in px, bzw. Auflösung in dpi.

Gültige Werte:
[<Breite>px];[<Höhe>px] | <Auflösung>[dpi]

Achtung:
ImageScaling beinhaltet die Funktionalität von TiffResolution. Wenn beide Properties gesetzt sind, wird daher nur ImageScaling ausgewertet.
Im Falle der Auflösung ist nur die Angabe eines Wertes erforderlich, da nur eine für beide Achsen identische Auflösung unterstützt wird.

Beispiele:

ImageScaling=100px;200px
Maximale Höhe 200 px oder maximale Breite 100 px, je nachdem, welche Grenze zutrifft.

ImageScaling=;200px
Feste Höhe 200px, Breite beliebig

ImageScaling=200px
Feste Breite 200px, Höhe beliebig

ImageScaling=100dpi oder ImageScaling=100
Auflösung 100 DPI wird benutzt.

Erweiterung für den Einsatz der Property „ImageType“:

Bei Erzeugung mehrerer Grafikformate in einem Rendering-Vorgang können hier Grafikproportionen für jedes erzeugte Grafikformat spezifiziert werden. Die Werte sind in der gleichen Reihenfolge aufgelistet, wie die Grafikformate in der Property „ImageType“ definiert wurden. Zur besseren Lesbarkeit können die Wertepaare mit geschweiften Klammern gruppiert werden.
Die Eingabe von Leerwerten ";;" ist möglich, dann greift die Default-DPI-Einstellung.

Beispiele:

ImageType="png;tiff;jpg“
ImageScaling="{50px;50px};{1000px;1000px};{500px;500px}"

ImageType="jpg;png“
ImageScaling="50px;50px;;"
Das JPG hat 50x50 px, das PNG die Default-DPI-Einstellung.

Char*

Threads

(ab CIB format Version 7.0.11)

Über diese Property kann beim Renderingvorgang die Konvertierung in mehrere Grafikformate und das anschließende Schreiben der Dateien parallelisiert werden, was zu einer besseren Performance führt.

Erforderlich sind die Properties ImageType und RenderingEngine="CIBRenderer"

Mögliche Werte:

N     Für die Erstellung der Grafikdateien werden maximal N Threads verwendet.

0          Keine Verwendung von Threads
(default, Verhalten der Vorversionen)

Char*

CibRenderer<property-name>

(ab CIB format Version 7.0.11)

Der CIB format reicht Properties direkt an den CIB Renderer durch, wenn der Property der Prefix „CibRenderer“ vorangestellt wird.

Beispiel:
CibRendererOutputFormat=FormatSvg

Der CIB Renderer erstellt eine Datei im Format SVG (dieses Format wird vom CIB format noch nicht unterstützt).

Char*