write_image.json

The JSON file of the “Images on a page” example. A photograph that goes in exactly as it came out of the camera, and one with transparent parts that keeps them, each on a page cut to its own size.

This file is a request: an application sends it over the network to the server, which creates the PDF and sends it back. It makes the same page as the Rust and Python versions of this example. A request names every file it uses, never its content; the call carries the request and the files together. A font the server already holds, such as DejaVuSans, is named with nothing attached. Send the request to the address the API page gives.

This request names files it does not carry: logo.png, photo.jpg. Each one travels beside the request, in the same call, as a supplied part named exactly as the request names it here — the description says which name plays which role, so you name your files as you like. A request naming a file the call carries nothing of is refused.

What this example is for

A photograph compressed once and then compressed a second time by whatever put it into the document comes out soft, blotchy at the edges, and heavier than the original was. It is the commonest way a good picture is spoilt between the camera and the printer, and nothing in the finished file admits that it happened.

What this example shows

• A photograph passed through untouched, never squeezed a second time.
• A picture whose transparent parts are still transparent.
• A page cut to the size of the picture, so nothing is scaled.

 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]
    }
  ]
}