Une couleur qui glisse vers une autre

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.

Un ciel de fin de journée passe de l'orange au bleu sans qu'on voie où l'un s'arrête. C'est un dégradé. Ici on en fabrique de deux sortes : celui qui glisse le long d'une ligne, d'un point à un autre, et celui qui rayonne d'un cercle vers un autre, comme un halo. On lui donne un nom, puis on remplit avec lui la forme qu'on veut : un bandeau de titre, un fond de carte, un rond.

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.

shadings déclare les dégradés que le document définit pour lui-même, chacun sous le nom par lequel un remplissage le sélectionne. Un dégradé s'écrit comme un motif, si bien que la couleur transparaît à travers ce que la forme laisse passer plutôt que d'être peinte par-dessus un découpage. Chaque sorte dit ses couleurs de deux façons, et d'une seule à la fois : deux couleurs de bout en bout, ou un espace et une fonction.

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.

• shadings — tableau, facultatif, vide par défaut.
• shadings[].name — chaîne, obligatoire. Le nom par lequel un remplissage sélectionne ce dégradé.
• shadings[].shading — objet, obligatoire. Deux sortes :
  • axial — from deux nombres obligatoire, to deux nombres obligatoire, en coordonnées de page.
  • radial — from et to en trois nombres obligatoires : centre en x, centre en y, rayon.
• Les deux sortes partagent : start et end, couleurs facultatives, nommées ensemble ; space et function, facultatifs, nommés ensemble ; extend, deux booléens facultatifs, [false, false] par défaut.
• Exactement une des deux façons de dire la couleur : start et end ensemble, ou space et function ensemble. Les deux ensemble sont refusées, aucune des deux aussi.
• start et end se disent en lumière ; une couleur CMJN y est refusée.
• function prend deux formes : exponential, avec low et high obligatoires, domain deux nombres facultatif (0 à 1), exponent facultatif (1) et range facultatif ; stitching, avec functions, bounds et encode obligatoires, domain et range facultatifs.
• Les fonctions échantillonnées et les fonctions calculées sont prévues pour une version future.
• Un remplissage nomme un dégradé par la forme {"shading": "the name"}.

Une requête entière qui le dessine

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

{
  "shadings": [
    {
      "name": "sunrise",
      "shading": {
        "axial": {
          "from": [60, 700],
          "to": [300, 700],
          "start": [0.95, 0.75, 0.2],
          "end": [0.2, 0.35, 0.75]
        }
      }
    }
  ],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 60, "lly": 700, "urx": 300, "ury": 780 },
      "fill": { "shading": "sunrise" }
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

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.

dégradé

Une couleur qui change tout au long de l'espace qu'elle remplit, sans la moindre marche entre un bout et l'autre : un bandeau qui s'efface, une barre qui prend du relief. Elle est décrite une fois, en quelques nombres, et peinte partout où on la veut, si bien qu'elle reste nette à n'importe quelle taille et ne pèse presque rien.

Tous les mots que le site explique