Ce qu'une image dit d'elle-même

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Une photo appartient à quelqu'un. Quand on la place dans un document, il est souvent utile de dire au passage qui l'a prise, d'où elle vient, et ce qu'on a le droit d'en faire. On peut écrire ces renseignements à la main, ou reprendre tels quels ceux que l'appareil photo, le scanner ou la photothèque ont déjà rangés dans le fichier. Ces renseignements voyagent alors avec l'image, à l'intérieur du document.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

images déclare ce que chaque image fournie dit d'elle-même. Deux façons : des faits, à partir desquels le serveur écrit le paquet de métadonnées ; ou le nom d'une partie fournie portant un paquet écrit ailleurs, repris tel quel, sans rien y ajouter ni rien y vérifier. Une image ne réclame jamais de norme pour son compte : la norme est dite une fois, par le document. Ne rien dire d'une image est le cas ordinaire, et une image qu'aucun élément ne dessine n'atteint pas le document.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

images — tableau, facultatif, vide par défaut.
images[].name — chaîne, obligatoire. Le nom de la partie fournie que cette entrée décrit, celui-là même qu'un élément image emploie.
images[].metadata — obligatoire. Deux formes :
- {"facts": {...}} — les mêmes champs que metadata : title, author, subject, producer, created, trapped, schemas. Le serveur en écrit le paquet.
- {"packet": "part name"} — le nom d'une partie fournie portant un paquet écrit ailleurs. Ce qu'un lecteur y trouve est ce qui a été donné.
Une partie qui porte un paquet écrit ailleurs écrit ses propriétés sans leur description : la norme est déclarée une seule fois, par le document.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "images": [
    {
      "name": "photo",
      "metadata": {
        "facts": {
          "author": "Camille Roy",
          "subject": "The workshop, June 2026"
        }
      }
    }
  ],
  "items": [
    {
      "type": "image",
      "image": "photo",
      "rect": { "llx": 60, "lly": 560, "urx": 300, "ury": 740 }
    }
  ]
}

La ligne qui l'envoie, en trois langages

Le document dans son ensemble

Les numéros que le lecteur affiche Cent courriers dans un seul fichier Ce que le document dit de lui-même Un fichier lisible dans trente ans Une facture qu'un humain et une machine lisent L'adresse contre laquelle les liens se lisent La version de PDF que le fichier déclare

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

norme: Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
la carte d'identité d'un fichier: Le bloc écrit à l'intérieur d'un fichier qui dit ce qu'est ce fichier : son titre, qui l'a fait, quand, et quelles règles il suit. Les moteurs de recherche et les archives le lisent ; un lecteur ne le voit jamais. Son nom technique est XMP.
serveur: Une machine qui attend des appels et y répond, jour et nuit, sans personne devant elle. Celle qui dessine les documents ici porte le moteur et rend les pages finies ; celle où tourne votre site est une autre machine qui fait le même genre de travail.

Tous les mots que le site explique