Un rectangle plein ou encadré
Poser un rectangle : un fond de couleur derrière un titre, un cadre autour d'une zone, ou les deux, avec le trait de votre choix.
Résumé
La brique la plus simple qui soit : quatre coins, et le choix de ce qu'on met dedans. Rempli, il fait la bande grise derrière un titre de section ou la cellule colorée d'un tableau ; tracé au trait seul, il délimite une photographie, ou une zone destinée à être découpée. Quand vous demandez les deux, le remplissage se pose d'abord, si bien que le trait reste visible par-dessus.
Techniquement
Demandé avec
"type": "rect"
Un rect est un tracé fermé dont on épargne les quatre points : un seul opérateur re, puis les mêmes clés de peinture qu'un tracé libre, les mêmes masques, le même état graphique, le 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.
Schéma de la requête
Clé obligatoire : rect, un objet de llx, lly, urx, ury, chacun un nombre ou une expression. Facultatives : fill, une couleur ou {"shading": "name"} ; stroke, un objet avec un width obligatoire plus color, dash, cap et join ; clip, un objet avec un segments obligatoire et une rule (nonzero par défaut, even_odd) ; graphics_state, le nom d'un état graphique déclaré ; pages, un tableau d'entiers comptés à partir de 1, vide par défaut ; transform, six nombres ; rotate, degrés dans le sens inverse des aiguilles d'une montre autour du centre du rectangle ; layer, le nom d'un calque déclaré. Refus croisés : transform avec rotate ; un clip dont les segments sont vides. Un rectangle prend fill, stroke, ou les deux.
Une requête entière qui crée un PDF
{
"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]}
}
]
}Formes
Un tracé libre : lignes, courbes et surfaces Une ligne droite entre deux points Un dessin déclaré une fois et posé autant de fois qu'on veut
Où aller ensuite
Toutes les clés JSON d'une requête, en une page Les vingt-deux autres choses que l'on peut dessiner