write_tiff.json
Le fichier JSON de l'exemple « Toutes les images qu'un scanner met dans un seul fichier ». Un fichier de trois feuilles et un fichier d'une seule photographie, chaque image sur une page taillée à sa mesure ; la photographie entre telle que l'appareil l'a écrite, puisqu'un logiciel de lecture sait déjà lire une photographie.
Ce fichier est une requête : une application l'envoie par le réseau au serveur, qui crée le PDF et le renvoie. Il donne la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu'elle emploie, jamais le contenu de ces fichiers ; l'appel porte la requête et les fichiers ensemble. Une police que le serveur détient déjà, comme DejaVuSans, se nomme sans rien y joindre. Envoyez la requête à l'adresse que donne la page de l'API.
Cette requête nomme des fichiers qu'elle ne contient pas : pages.tif#1, pages.tif#2, pages.tif#3, photograph.tif. Chacun voyage à côté de la requête, dans le même appel, comme une pièce fournie nommée exactement comme la requête la nomme ici — la description dit quel nom joue quel rôle, vous nommez donc vos fichiers comme vous voulez. Une requête qui nomme un fichier dont l'appel ne contient rien est refusée.
À quoi sert cet exemple
Un scanner ne vous rend pas un fichier par feuille. Il en rend un seul, avec toute la pile dedans, et un télécopieur fait pareil : toutes les pages de l'appel sont là, l'une après l'autre. Un logiciel qui ne regarde que la première perd les autres sans rien dire, et personne ne s'en aperçoit avant le jour où il faut la page quatre.
Ce que montre cet exemple
- Toutes les images du fichier, pas seulement la première.
- Chacune sur une page taillée à sa mesure.
- Une photographie rangée dans le fichier est recopiée telle quelle : elle ressort aussi nette qu'elle est entrée.