write_tiff.json

The JSON file of the “Every picture a scanner put in one file” example. A file of three sheets and a file holding one photograph, each picture on a page cut to its own size; the photograph goes in exactly as the camera wrote it, since reading software reads a photograph itself.

JSON 73 lines

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: pages.tif#1, pages.tif#2, pages.tif#3, photograph.tif. 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 scanner does not give you one file per sheet. It gives you one file with the whole batch inside, and the same is true of a fax machine: every page of the call is in there, one after another. Software that only looks at the first one quietly loses the rest, and nobody notices until the day somebody needs page four.

What this example shows

Download the file The same example in Rust The same example in Python See what it creates 
 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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
{
  "metadata": {
    "title": "hqf-pdf TIFF sample"
  },
  "page_sizes": [
    { "page": 2, "width": 61.0, "height": 37.0 },
    { "page": 3, "width": 2.0, "height": 2.0 },
    { "page": 4, "width": 3.0, "height": 1.0 },
    { "page": 5, "width": 1.0, "height": 4.0 }
  ],
  "images": [
    { "name": "photograph.tif", "page": 1 },
    { "name": "pages.tif#1", "page": 1 },
    { "name": "pages.tif#2", "page": 2 },
    { "name": "pages.tif#3", "page": 3 }
  ],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 0.0, "lly": 700.0, "urx": 595.276, "ury": 842.0 },
      "fill": [0.93, 0.94, 0.96],
      "pages": [1]
    },
    {
      "type": "image",
      "image": "photograph.tif",
      "rect": { "llx": 60.0, "lly": 600.0, "urx": 180.0, "ury": 672.7868852459017 },
      "pages": [1]
    },
    {
      "type": "image",
      "image": "pages.tif#1",
      "rect": { "llx": 190.0, "lly": 600.0, "urx": 310.0, "ury": 720.0 },
      "pages": [1]
    },
    {
      "type": "image",
      "image": "pages.tif#2",
      "rect": { "llx": 320.0, "lly": 600.0, "urx": 440.0, "ury": 640.0 },
      "pages": [1]
    },
    {
      "type": "image",
      "image": "pages.tif#3",
      "rect": { "llx": 450.0, "lly": 600.0, "urx": 480.0, "ury": 720.0 },
      "pages": [1]
    },
    {
      "type": "image",
      "image": "photograph.tif",
      "rect": { "llx": 0.0, "lly": 0.0, "urx": 61.0, "ury": 37.0 },
      "pages": [2]
    },
    {
      "type": "image",
      "image": "pages.tif#1",
      "rect": { "llx": 0.0, "lly": 0.0, "urx": 2.0, "ury": 2.0 },
      "pages": [3]
    },
    {
      "type": "image",
      "image": "pages.tif#2",
      "rect": { "llx": 0.0, "lly": 0.0, "urx": 3.0, "ury": 1.0 },
      "pages": [4]
    },
    {
      "type": "image",
      "image": "pages.tif#3",
      "rect": { "llx": 0.0, "lly": 0.0, "urx": 1.0, "ury": 4.0 },
      "pages": [5]
    }
  ]
}