Grafikexport des Dokuments

Mit dem image Operation-Element lässt sich ein Dokument als Grafik exportieren.

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<operation xmlns="http://schema.webpdf.de/1.0/operation">
<image pages="1" fileNameTemplate="page[%d]">
  <bmp metrics="mm"
        height="0"
        width="0"
        dpi="72"/>
</image>
</operation>

{
"image": {
  "pages": "1",
  "fileNameTemplate": "page[%d]",
  "bmp": {
    "metrics": "mm",
    "height": 0,
    "width": 0,
    "dpi": 72
   }
 }
}

 

 

image-Element

 

Das image-Element enthält als Unterelement eines von mehreren möglichen Bildtyp-Elementen. Diese werden weiter unten beschrieben.

 

<image pages="1" fileNameTemplate="page[%d]">
...
</image>

"image": {
"pages": "1",
"fileNameTemplate": "page[%d]",
...
 }
}

 

pages (Default: "1")

Legt die Seitennummer oder den Seitenbereich (Bsp. "1,5-6,9") fest, der in ein Grafikformat umgewandelt werden soll. Wird eine einzelne Seite definiert, dann wird direkt die Grafikdatei zurückgeliefert. Wird hier ein Seitenbereich angegeben, dann liefert der Aufruf eine ZIP-Datei, die alle exportierten Seiten enthält. Der Name der einzelnen Grafikdatei (bei mehrseitigem Export) wird über das Attribut "fileNameTemplate" bestimmt.

 

Als Ausnahme bei dem mehrseitigen Export gilt das "tif" Format. Hier kann über das Attribut "multipage" bestimmt werden, ob ein Multi-Page-TIFF erstellt wird, oder ob die einzelnen Seiten (wie bei den anderen Grafikformaten) in eine ZIP-Datei exportiert werden.

 

fileNameTemplate (Default: "page[%d]")

Über diesen Parameter wird der Dateinamen für einen mehrseitigen Export definiert, der für die erstellten Grafikdateien in der ZIP-Datei verwendet wird. Der Dateiname muss die Zeichenfolge "%d" enthalten. Diese Zeichenfolge wird in dem Dateinamen dann mit einer fortlaufenden Nummer ersetzt.

 

Bildtyp-Elemente

 

Die "Bildtyp-Element" definiert das Grafikformat, in das das PDF-Dokument exportiert wird. Hier als Beispiel das PNG-Format.

 

<png metrics="mm"
    height="0"
    width="0"
    dpi="72"/>
 

"png": {
"metrics": "mm",
"height": 0,
"width": 0,
"dpi": 72
}

 

Um in andere Formate zu exportieren, ersetzen Sie das Tag "png" durch eines der folgenden Elemente:

 

<png>
<tiff>
<jpeg>
<gif>
<bmp>

 

 

Es folgen die allgemeinen Attribute:

 

metrics (Default: "mm")

Gibt die Maßeinheit an, in der die maximalen Größen angegeben werden.

mm = Millimeter

px = Pixel

 

height (Default: 0)

Beschränkt die maximale Höhe des exportierten Bildes.

 0 = ohne Beschränkung

 

width (Default: 0)

Beschränkt die maximale Breite des exportierten Bildes.

 0 = ohne Beschränkung

 

dpi (Default: 72)

Mit diesem Parameter wird die DPI-Auflösung der Grafik festgelegt. Je größer der Wert, desto größer die X/Y-Auflösung der Grafik. Außerdem steigt mit zunehmender DPI-Auflösung auch die Byte-Größe der Grafikdatei.

 

 

Die nachfolgenden Attribute gelten nur für die Format jpeg und tiff:

 

jpegQuality (Default: 80)

Beim Grafikexport in das "jpg"-Format, kann über diesen Parameter die Qualität der Grafik in Prozent festgelegt werden. Der Wert muss zwischen 0 und 100 liegen. Je größer der Wert, desto besser die Qualität und umso geringer die Komprimierung.

 

 

Die nachfolgenden Attribute gelten nur für das Format tiff:

 

multipage (Default: false)

Wenn "true", dann wird bei einem mehrseitigen Export in das "tif"-Format ein "Multi-page TIFF" erstellt. Es werden alle Seiten in eine Datei exportiert und keine ZIP-Datei mit einzelnen Grafiken erstellt.

 

compression (Default: "none")

Mit diesem Parameter wird bei einem "tif"-Export die Komprimierungsmethode festgelegt. Es stehen die folgenden Werte zur Verfügung:

none = Keine Komprimierung

rle = TIFF CCITT Modified Huffman RLE compression

deflate = TIFF Deflate lossless compression (Zip-in-TIFF).

group3 = TIFF CCITT Group 3 fax encoding

group4 = TIFF CCITT Group 4 fax encoding

jpeg = TIFF JPEG-in-TIFF compression

lzw = TIFF LZW Compression

packbits = TIFF Byte-oriented run-length encoding "PackBits" compression

zlib = TIFF ZLib Compression