Ce qu’une image dit d’elle-même, et comment elle est lue

Attacher à une image fournie son auteur et ses droits, et dire lesquels de ses pixels se voient, leur opacité et dans quel sens elle est dessinée.

Le résultat dans un vrai PDF

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.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Un registre dont chaque page dit d’où elle vient

Résumé

Une photo appartient à quelqu’un. L’appareil photo, le scanner ou la photothèque l’ont en général déjà écrit dans le fichier, et on peut reprendre ces lignes exactement telles quelles — ou les remplacer par les vôtres, quand l’image est arrivée sans rien. Dans les deux cas, elles voyagent avec l’image, à l’intérieur du document, et restent avec elle si on l’en ressort. La même entrée dit comment l’image est lue : lesquels de ses pixels laissent voir la page, si une seconde image grise dit à quel point elle est opaque pixel par pixel, et dans quel sens elle est dessinée quand son propre fichier se trompe.

Techniquement

Écrit au premier niveau d’une requête, sous "images"

images énonce ce que chaque image fournie dit d’elle-même, dans un paquet XMP écrit sur l'XObject d’image lui-même. Deux façons : des faits, à partir desquels le serveur écrit le paquet ; ou le nom d’une partie fournie qui contient un paquet écrit ailleurs, transmis tel quel, sans rien ajouter et sans rien vérifier. Une image ne déclare jamais une norme pour son propre compte : la norme n’est déclarée qu’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 jamais le document. La même entrée donne ce avec quoi l'XObject lui-même est écrit : le pochoir, les deux sortes de masque, les valeurs d’échantillon transparentes, l’intervalle sur lequel chaque composante est lue, l’orientation et le profil au travers duquel ses couleurs se lisent.

Schéma de la requête

  • 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 — facultatif. 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 qui contient un paquet écrit ailleurs. Ce que le logiciel de lecture y trouve est ce qui a été donné.
  • images[].files — tableau de chaînes, facultatif, vide par défaut. Les noms des pièces jointes déclarées que l’image revendique : le relevé de la numérisation d’où elle vient, les mesures qui en ont été prises, tout ce qu’une machine lit à côté des pixels. Une pièce jointe revendiquée ici appartient à l’image plutôt qu’au document.
  • images[].stencil — booléen, facultatif, false par défaut. Dit si l’image est lue comme un pochoir plutôt que comme une image : elle n’a aucune couleur propre et dit où poser la couleur de remplissage en cours. Une image qui n’est pas d’un bit par pixel, à une seule composante, est refusée.
  • images[].stencil_mask — chaîne, facultative. Le nom de la partie fournie dont les bits à zéro disent quels pixels de cette image se voient. Cette partie est lue comme un pochoir et n’est dessinée nulle part elle-même.
  • images[].soft_mask — chaîne, facultative. Le nom de la partie fournie en niveaux de gris dont les échantillons disent à quel point cette image est opaque, pixel par pixel : le noir laisse voir au travers, le blanc est plein. Elle est étirée sur l’image, si bien que les deux n’ont pas besoin d’avoir la même taille, et elle n’est dessinée nulle part elle-même.
  • images[].color_key — tableau de paires d’entiers, facultatif, une paire par composante. La plus petite et la plus grande des valeurs d’échantillon transparentes. Un pixel ne laisse voir la page que si chacune de ses composantes tombe dans sa paire. Les valeurs sont les nombres sous lesquels les échantillons sont rangés, pas la couleur qu’ils désignent.
  • images[].opaque — booléen, facultatif, false par défaut. Dit si la transparence que le fichier déclare est abandonnée, de sorte que rien ne se voie au travers de l’image. C’est la réponse à un fichier doté d’un canal alpha qu’une norme refuse.
  • images[].decode — tableau de paires de nombres, facultatif, une paire par composante. L’intervalle sur lequel chaque composante est lue : la valeur que vaut son échantillon le plus bas, puis celle que vaut le plus haut. Une paire prise à l’envers dessine l’image en négatif. Absent, chaque composante est lue sur l’intervalle par défaut de son espace de couleur.
  • images[].orientation — chaîne, facultative. Le sens dans lequel l’image est dessinée, quoi que dise son propre fichier. Un appareil photo range l’image telle que son capteur l’a lue et note comment le boîtier était tenu ; c’est ce qu’une requête énonce à la place, pour un fichier dont l’appareil a noté une mauvaise orientation. Huit valeurs : upright, dessinée comme ses pixels sont rangés ; mirrored_left_to_right, sa gauche et sa droite échangées ; upside_down, tournée d’un demi-tour ; mirrored_top_to_bottom, son haut et son bas échangés ; turned_left et turned_right, un quart de tour dans le sens antihoraire et dans le sens horaire ; mirrored_and_turned_left et mirrored_and_turned_right, mise en miroir puis tournée de ce quart de tour.
  • images[].icc_profile — chaîne, facultative. Le nom de la partie fournie qui contient le profil ICC au travers duquel les couleurs de l’image se lisent. Un fichier peut en contenir un à lui, et celui nommé ici prime. Le profil décrit les composantes dont les couleurs propres de l’image sont faites, sans quoi il est refusé, et le nommer sur une image lue comme un pochoir est refusé.
  • images[].opacity_channel — chaîne, facultative. Dans un TIFF où un logiciel de retouche a enregistré plusieurs composantes d’opacité, le nom de celle qui dit à quel point l’image est opaque ; absente, la première que le fichier dit être une opacité est prise. Les couleurs que le fichier a multipliées par l’une de ces composantes sont divisées par elle, toutes les autres composantes d’opacité sont écartées, et une composante dont le fichier ne dit pas le sens est lue comme une opacité à part des couleurs. Un nom sur une partie qui n’est pas un TIFF, ou un nom sous lequel aucune composante n’a été enregistrée, est refusé.
  • images[].clipping_path — objet, facultatif. Le tracé qui détoure l’image quand un élément image énonce clip_to_path ; il l’emporte sur celui que contient le fichier de l’image. Il prend contours, un tableau de contours fermés. Un contour prend knots, un tableau de nœuds, les points qu’il relie par des courbes de Bézier cubiques, la dernière courbe le ramenant au premier nœud. Un nœud prend anchor, le point par lequel passe le contour, ainsi que arriving et leaving, les points de contrôle de la courbe qui arrive sur lui et de celle qui en repart. Chacun est une paire [x, y] exprimée en fractions de l’image telle qu’elle est enregistrée dans son fichier, x compté depuis son bord gauche et y depuis son bord inférieur : si l’image est tournée ou mise en miroir en entrant dans sa boîte, son tracé tourne ou se retourne avec elle. Un nœud dont les points de contrôle se confondent avec son ancre rend droites les courbes de part et d’autre. Là où des contours se chevauchent, un point situé dans un nombre pair d’entre eux est hors du tracé. Un tracé sans contour ne détoure rien : l’image est dessinée en entier.
  • Une partie qui contient un paquet rédigé ailleurs écrit ses propriétés sans leur description : la norme n’est déclarée qu’une fois, par le document.
  • images[].interpolate — booléen, facultatif, false par défaut. Si le logiciel de lecture lisse l’image là où elle est dessinée plus grande que ses pixels. L’image ne montre alors plus exactement ce qu’elle contient, et c’est pourquoi un document qui revendique une norme archive le refuse.
  • images[].rendering_intent — chaîne, facultative. La façon dont le logiciel de lecture ramène les couleurs de l’image à ce que l’appareil sait rendre, écrite sur l’image elle-même et prioritaire sur l’intention de l’état graphique sous lequel elle est dessinée : absolute_colorimetric, relative_colorimetric, saturation ou perceptual.
  • images[].inks — objet, facultatif. Les encres d’imprimerie dont les échantillons sont les teintes, décrites en entier comme l’est un espace separation ou device_n déclaré sous color_spaces : un scan en gris imprimé dans une couleur d’accompagnement, un vernis, un blanc posé sous une étiquette. Les échantillons ne sont pas touchés, seule change la façon de les lire, si bien que l’image a autant de composantes que l’espace a d’encres. Tout autre genre d’espace est refusé, comme le sont une image qui renseigne aussi measured, un pochoir, une image qui indexe une table de couleurs, une image lue à travers un profil et un flux JPEG 2000 ou JBIG2.
  • images[].measured — objet, facultatif. La couleur mesurée que représentent les échantillons, décrite en entier comme l’est un espace cal_gray, cal_rgb ou lab déclaré sous color_spaces : un scan fait sur un scanner étalonné, des relevés de colorimètre. Les échantillons ne sont pas touchés, seule change la façon de les lire, si bien que l’image a autant de composantes que l’espace en demande : une pour cal_gray, trois pour les deux autres. Tout autre genre d’espace est refusé, comme le sont une image qui renseigne aussi inks, un pochoir, une image qui indexe une table de couleurs, une image lue à travers un profil et un flux JPEG 2000 ou JBIG2.
  • images[].jbig2 — objet, facultatif. {} dit que le morceau est un flux JBIG2, qui ne se reconnaît jamais à ses octets ; {"globals": "part name"} nomme en plus le morceau fourni qui contient les segments d’après lesquels le flux se lit. Les octets sont repris tels quels. Un morceau dont les segments ne donnent jamais la taille de la page est refusé, comme le sont, à côté, un numéro d’image et un canal d’opacité, qui appartiennent l’un et l’autre au TIFF.
  • images[].fax — booléen, facultatif, false par défaut. Dit si une image d’un bit par échantillon est codée comme un télécopieur code une page, en CCITT groupe 4.

Une requête entière qui crée un PDF

{
  "images": [
    {
      "name": "photo",
      "orientation": "upright",
      "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 montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire Une facture qu’un humain et une machine lisent L’adresse à partir de laquelle se lisent les liens relatifs La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Les pièces jointes du document, à côté de ses pages Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs Les zones d’une page où un lecteur mesure La fiche d’identité que contient une seule page La norme d’accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête

Voir les prix Voir les exemples