write_image.json

Die JSON-Datei des Beispiels „Bilder auf einer Seite“. Ein Foto, das genau so hineingeht, wie es aus der Kamera kam, und eines mit durchsichtigen Teilen, das sie behält, jedes auf einer Seite in seiner eigenen Größe.

Diese Datei ist eine Anfrage: Eine Anwendung sendet sie über das Netz an den Server, der das PDF erzeugt und zurücksendet. Sie erzeugt dieselbe Seite wie die Rust- und die Python-Fassung dieses Beispiels. Eine Anfrage nennt jede Datei, die sie verwendet, nie ihren Inhalt; der Aufruf trägt die Anfrage und die Dateien zusammen. Eine Schrift, die der Server bereits vorhält, etwa DejaVuSans, wird ohne Anhang genannt. Senden Sie die Anfrage an die Adresse, die die API-Seite angibt.

Diese Anfrage nennt Dateien, die sie nicht trägt: logo.png, photo.jpg. Jede davon reist neben der Anfrage, im selben Aufruf, als mitgelieferter Teil, genau so benannt, wie die Anfrage sie hier nennt — die Beschreibung sagt, welcher Name welche Rolle spielt, Sie benennen Ihre Dateien also, wie Sie möchten. Eine Anfrage, die eine Datei nennt, von der der Aufruf nichts trägt, wird abgelehnt.

Wofür dieses Beispiel da ist

Ein Foto, das einmal komprimiert und dann von dem, was es ins Dokument gesetzt hat, ein zweites Mal komprimiert wurde, kommt weich heraus, fleckig an den Kanten und schwerer als das Original. Das ist die häufigste Art, wie ein gutes Bild zwischen Kamera und Drucker verdorben wird, und nichts in der fertigen Datei verrät, dass es geschehen ist.

Was dieses Beispiel zeigt

• Ein unverändert durchgereichtes Foto, nie ein zweites Mal komprimiert.
• Ein Bild, dessen durchsichtige Teile noch durchsichtig sind.
• Eine Seite, auf die Größe des Bildes zugeschnitten, damit nichts skaliert wird.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

{
  "metadata": {
    "title": "hqf-pdf image sample"
  },
  "page_sizes": [
    { "page": 1, "width": 160.0, "height": 120.0 },
    { "page": 2, "width": 96.0, "height": 96.0 }
  ],
  "items": [
    {
      "type": "image",
      "image": "photo.jpg",
      "rect": { "llx": 0.0, "lly": 0.0, "urx": 160.0, "ury": 120.0 },
      "pages": [1]
    },
    {
      "type": "image",
      "image": "logo.png",
      "rect": { "llx": 0.0, "lly": 0.0, "urx": 96.0, "ury": 96.0 },
      "pages": [2]
    },
    {
      "type": "rect",
      "rect": { "llx": 0.0, "lly": 700.0, "urx": 595.276, "ury": 842.0 },
      "fill": [0.93, 0.94, 0.96],
      "pages": [3]
    },
    {
      "type": "image",
      "image": "photo.jpg",
      "rect": { "llx": 60.0, "lly": 500.0, "urx": 273.33333333333331, "ury": 660.0 },
      "pages": [3]
    },
    {
      "type": "image",
      "image": "logo.png",
      "rect": { "llx": 380.0, "lly": 730.0, "urx": 470.0, "ury": 820.0 },
      "pages": [3]
    }
  ]
}