Déclarer une couleur au-delà du rouge-vert-bleu

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.

Le bleu d'une marque n'est pas un bleu approché à l'écran : c'est un pot d'encre précis, commandé chez le fabricant, avec un numéro dessus. Une imprimerie le pose comme une encre à part, en plus des quatre habituelles. Pour cela, il faut que le document le nomme au lieu de le mélanger. On peut aussi décrire une couleur par sa mesure réelle, celle d'un appareil, plutôt que par une recette d'écran. On déclare ces couleurs ici, sous un nom, et on s'en sert ensuite 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.

color_spaces déclare les espaces de couleur que le document définit pour lui-même, chacun sous le nom par lequel une couleur le sélectionne. Une couleur d'appareil n'a besoin d'aucune déclaration : trois nombres sont du rouge, du vert et du bleu partout où ils paraissent. Une encre à part, un espace mesuré ou un espace profilé, eux, sont écrits dans le document avant qu'une couleur les nomme. Six sortes existent, et chacune se dit par ses propres nombres — sauf l'espace ICC, dont le profil arrive comme partie fournie.

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.

color_spaces — tableau, facultatif, vide par défaut.
color_spaces[].name — chaîne, obligatoire. Le nom par lequel les couleurs de la requête sélectionnent cet espace.
color_spaces[].space — objet, obligatoire. Six sortes :
- separation — colorant chaîne obligatoire ; ink tableau de quatre nombres facultatif ; tint objet facultatif. Exactement un des deux : les deux ensemble sont refusés, aucun des deux aussi.
- indexed — base obligatoire, de même forme récursive ; entries tableau d'octets de 0 à 255 obligatoire, 256 entrées au maximum.
- lab — white_point trois nombres obligatoire ; black_point trois nombres facultatif ; range quatre nombres facultatif, −100 à 100 par défaut.
- cal_gray — white_point trois nombres obligatoire ; black_point facultatif ; gamma nombre facultatif, 1 par défaut.
- cal_rgb — white_point trois nombres obligatoire ; black_point facultatif ; gamma trois nombres facultatif, 1 par défaut ; primaries trois fois trois nombres facultatif.
- icc — profile chaîne obligatoire, le nom d'une partie fournie ; space facultatif, sinon lu dans le profil.
tint — alternate obligatoire ; low et high tableaux de nombres obligatoires ; exponent facultatif, 1 par défaut ; domain deux nombres facultatif, 0 à 1 par défaut ; range tableau de paires facultatif.
Une couleur nomme un espace déclaré par la forme {"space": "the name", "components": n, …}. Les formes courtes restent disponibles : [g] pour un gris, [r, g, b], [c, m, y, k], et {"gray": n}.

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": "brand_blue",
      "space": {
        "separation": {
          "colorant": "Corporate Blue",
          "ink": [0.92, 0.58, 0.0, 0.06]
        }
      }
    }
  ],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 60, "lly": 700, "urx": 300, "ury": 780 },
      "fill": { "space": "brand_blue", "components": [1.0] }
    }
  ]
}

La ligne qui l'envoie, en trois langages

La couleur et la façon dont elle est rendue

L'appareil pour lequel les couleurs sont dites Une couleur qui glisse vers une autre L'opacité et le mélange des couleurs L'espace dans lequel la page mélange ses couleurs

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

octet: L'unité dans laquelle se compte le poids d'un fichier, comme un colis se compte en grammes. Mille octets font un kilo-octet, un million font un méga-octet — la taille d'une photo prise avec un téléphone. Un PDF d'une page pèse ici entre six mille et cent vingt mille, donc cent PDF tiennent dans la place de cinq photos.
profil de couleur: Un fichier qui dit à quoi une couleur ressemble pour de vrai. Sans lui, le même rouge ne sort pas pareil sur un écran et sur du papier. Un document destiné à l'imprimerie emporte donc avec lui le profil sur lequel ses couleurs ont été choisies.
CMJN: Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.
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