Un rectangle plein ou encadré

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.

C'est la brique la plus simple : un rectangle. Vous donnez ses quatre coins, et vous choisissez de le remplir d'une couleur, de n'en dessiner que le contour, ou de faire les deux. Rempli, il fait le bandeau gris derrière un titre de paragraphe ou la case de couleur d'un tableau ; en contour seul, il fait le cadre autour d'une photo ou d'une zone à découper. Le remplissage se pose en premier, donc le contour reste visible par-dessus.

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.

Un rect est un tracé fermé dont on épargne les quatre points : mêmes clés de peinture qu'un tracé libre, mêmes masques, même état graphique, même placement. Ses coins acceptent des expressions, ce qui donne un bandeau collé aux marges d'une page dont on ignore la largeur au moment d'écrire la requête. Le remplissage accepte un dégradé déclaré, ce qui en fait le support habituel d'un fond en camaïeu. L'ordre de dessin suit l'ordre des articles : un rectangle posé après un texte le recouvre.

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.

Clé obligatoire : rect, objet à llx, lly, urx, ury, chacun un nombre ou une expression. Facultatives : fill, une couleur ou {"shading": "name"} ; stroke, objet à width obligatoire, plus color, dash, cap et join ; clip, objet à segments obligatoire et rule (nonzero par défaut, even_odd) ; graphics_state, nom d'un état graphique déclaré ; pages, tableau d'entiers en base 1, défaut vide ; transform, six nombres ; rotate, degrés dans le sens trigonométrique autour du centre de la boîte ; layer, nom d'un calque déclaré. Refus croisés : transform et rotate ensemble ; un clip dont les segments sont vides. Un rectangle prend fill, stroke, ou les deux.

Une requête entière qui le dessine

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

{
  "items": [
    {
      "type": "rect",
      "rect": {"llx": 72, "lly": 700, "urx": 523, "ury": 740},
      "fill": [0.85, 0.89, 0.95],
      "stroke": {"width": 1.0, "color": [0.11, 0.31, 0.55]}
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

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.

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é.

calque

Un groupe nommé de choses dessinées sur une page, que le lecteur peut afficher ou masquer, comme un calque posé sur un plan. Un plan peut garder ses cotes sur l'un et ses notes sur l'autre, et un calque peut être réglé pour s'afficher à l'écran et rester hors de l'impression.

Tous les mots que le site explique