Un rectangle, plein ou au trait
Mettre 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.
Le résultat dans un vrai PDF
Deux pages identiques qui dessinent la structure d’une facture avec des traits et des rectangles, sans un mot de texte : le fichier fait une douzaine de kilooctets et n’incorpore aucune police.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Découper un paragraphe et l’aligner · Couper un mot trop long · Traits d’union conditionnels et insécables
Résumé
La brique la plus simple qui soit : quatre coins, et le choix de ce qu’on met dedans. Rempli, le rectangle 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é sans avoir à donner ses quatre points : un seul opérateur re, puis les mêmes clés de peinture qu’un tracé libre, les mêmes détourages, 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 dégradé. L’ordre de dessin suit l’ordre des éléments : 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. fill_rule, nonzero par défaut ou even_odd, dit quel côté de la forme le remplissage tient pour l’intérieur : even_odd laisse vide un sous-chemin tracé à l’intérieur d’un autre, si bien qu’un disque dans un disque se remplit en anneau ; nommé sans fill, il est refusé. stroke prend aussi miter_limit, jusqu’où un angle miter peut s’avancer avant d’être coupé net, exprimé comme le rapport de la longueur de l’angle à l’épaisseur du trait, 10 par défaut.
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