L'espace dans lequel la page mélange ses couleurs

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.

Quand deux couleurs semi-transparentes se recouvrent, il faut bien décider comment elles se combinent. Selon la façon de compter, le résultat n'est pas tout à fait le même : un rouge à moitié transparent posé sur un bleu peut virer un peu différemment d'un appareil à l'autre. On peut fixer la règle une fois pour toutes au niveau de la page : voilà l'espace dans lequel tout se mélange. Le résultat devient alors le même partout.

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.

transparency fait de chaque page un groupe de transparence : ses marques se composent entre elles dans l'espace nommé ici, plutôt que dans l'espace où chacune s'est trouvée peinte. C'est ce qui fait qu'un rouge à moitié opaque au-dessus d'un bleu donne la même couleur où que la page soit montrée. L'espace nommé est un espace que color_spaces déclare ; deux réglages complètent le groupe, l'isolement et le recouvrement.

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.

• transparency — objet, facultatif, absent par défaut.
• transparency.space — chaîne, obligatoire. Le nom d'un espace de couleur déclaré par color_spaces. Un nom que la requête n'a pas déclaré est refusé, et la réponse le nomme.
• transparency.isolated — booléen, facultatif, false par défaut. Le groupe part de rien plutôt que de ce qui se trouve derrière la page.
• transparency.knockout — booléen, facultatif, false par défaut. Une marque du groupe remplace ce qu'une marque antérieure du même groupe a posé, au lieu de se composer avec elle.
• Le réglage vaut pour toutes les pages du document. L'opacité et le mode de mélange d'une forme précise se règlent par graphics_states.

Une requête entière qui le dessine

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

{
  "color_spaces": [
    {
      "name": "blend",
      "space": { "cal_rgb": { "white_point": [0.9505, 1.0, 1.089] } }
    }
  ],
  "transparency": { "space": "blend", "isolated": true },
  "graphics_states": [{ "name": "half", "state": { "fill_alpha": 0.5 } }],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 60, "lly": 700, "urx": 200, "ury": 790 },
      "fill": [0.85, 0.15, 0.15]
    },
    {
      "type": "rect",
      "rect": { "llx": 140, "lly": 660, "urx": 280, "ury": 750 },
      "fill": [0.15, 0.3, 0.85],
      "graphics_state": "half"
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

recouvrement

Faire mordre d'un cheveu l'une sur l'autre deux couleurs qui se touchent, pour qu'une feuille qui bouge très légèrement sur la presse ne laisse aucun trait blanc le long de la jointure. L'imprimeur décide de combien ; un fichier pour la presse dit par oui ou par non si cela a déjà été fait.

transparence

De la peinture qui laisse revenir ce qui est dessous, dans une proportion annoncée. C'est ce qui fait qu'une mention posée en travers d'une page laisse lire le texte qu'elle recouvre, et qu'un surlignage est un surlignage et non un pâté. Le fichier dit quelle part passe ; celui qui dessine la page calcule la couleur qui en résulte.

requête

Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.

espace de couleur

La règle qui dit ce qu'un jeu de nombres veut dire comme couleur. Les mêmes trois nombres donnent un rouge à l'écran et un autre sous presse : un document dit donc sous quelle règle il parle. Sans rien dire, trois nombres sont lus comme les lumières d'un écran.

Tous les mots que le site explique