Un tracé libre : lignes, courbes et surfaces
Dessiner une forme point par point, avec des segments droits et des courbes, remplie d’une couleur ou d’un dégradé, et cernée d’un trait.
Le résultat dans un vrai PDF
Le rapport du mois, ses graphiques tracés en courbes
Un camembert de l’emploi des heures, une jauge en anneau de l’avancement de l’année, une carte aux coins adoucis, et des arcs à qui l’on dit où aller plutôt que de combien tourner.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Découper ce qu’on dessine · Traits en tirets et en pointillé · Transparence et modes de fusion
Résumé
Le crayon libre : vous posez la pointe, et le trait suit partout où vous l’emmenez. Les segments droits font des triangles, des flèches et des polygones ; les courbes font des arrondis, des vagues et des cercles parfaits. C’est de cela que sont faits un filet sous un titre, un bandeau derrière un intitulé et l’ornement d’un diplôme.
Techniquement
Demandé avec
"type": "path"
Un tracé est une suite de segments écrits directement dans le flux de la page et appliqués dans l’ordre : move_to ouvre un contour en un point avec m, line_to le prolonge d’une droite avec l, curve_to y ajoute une courbe de Bézier cubique passant par deux points de contrôle avec c, et close referme le contour sur son origine avec h. Une page ne connaît ni opérateur de cercle ni opérateur d’arc : huit autres segments demandent donc une forme par son nom, et les courbes sont calculées pour elle — circle, ellipse, arc, rounded_rect et rounded_polyline ouvrent chacun leur propre contour, et arc_to, arc_through et elliptical_arc repartent de là où le tracé se trouve déjà. Aucun morceau ne tourne de plus d’un quart de tour, donc un cercle fait quatre courbes. Chaque coordonnée est un nombre ou une expression, donc un tracé se cale sur la largeur de la page sans que le client calcule quoi que ce soit ; les rayons sont des nombres simples et les angles des degrés dans le sens inverse des aiguilles d’une montre. La peinture se dit en deux clés indépendantes, le remplissage et le trait ; le remplissage accepte une couleur ou le nom d’un dégradé déclaré. Un détourage facultatif limite ce que l’élément laisse voir, et il ne vaut que pour lui : les éléments suivants restent entiers.
Schéma de la requête
Clé obligatoire : segments, un tableau d’étapes, chacune {"move_to": {"x", "y"}}, {"line_to": {"x", "y"}}, {"curve_to": {"x1","y1","x2","y2","x","y"}} ou la chaîne "close" ; chaque coordonnée est un nombre ou une expression. Huit étapes nomment une forme à la place : {"circle": {"centre", "r"}}, {"ellipse": {"centre", "rx", "ry"}}, {"arc": {"centre", "r", "start", "sweep"}}, {"arc_to"} avec ces mêmes quatre, {"arc_through": {"from", "via", "to"}}, {"elliptical_arc": {"from", "to", "rx", "ry", "large", "clockwise", "x_rotation", "enlarge_radii"}}, {"rounded_rect": {"rect", "radius"}} et {"rounded_polyline": {"points", "radius", "close"}} ; un centre, un from, un via, un to et chacun des points est un objet de x et y, rect est les quatre coins habituels, r, rx, ry et radius sont des longueurs en points, start, sweep et x_rotation sont des degrés dans le sens inverse des aiguilles d’une montre, et large, clockwise, enlarge_radii et close valent faux par défaut. enlarge_radii agrandit les deux rayons d’un arc trop courts pour aller d’un bout à l’autre, du moins qu’il faut pour qu’ils y parviennent ; un radius négatif creuse chaque coin d’un rounded_polyline au lieu de l’arrondir. Une étape {"svg_path": {"d", "x", "y", "scale"}} ajoute le contour que décrivent les données de chemin SVG d, et lit toute la grammaire des chemins SVG : un point du chemin se pose à l’abscisse x plus scale fois sa première coordonnée et à l’ordonnée y moins scale fois la seconde, l’origine SVG tombant en x, y ; scale vaut 1 par défaut. À la place de x, y et scale, l’étape accepte rect, les quatre coins habituels, dans lequel le contour s’ajuste comme une image. view désigne la boîte ajustée : quatre nombres [min x, min y, width, height] exprimés dans les unités propres au chemin, soit l’attribut viewBox du fichier SVG. Par défaut, c’est la boîte qu’occupe le contour. fit prend un mode seul ou un objet, comme pour une image mais sans clip ni scale, et vaut stretch par défaut. Le haut de cette boîte se place en haut de la zone qui la reçoit. Sont refusés : rect donné avec x, y ou scale ; view ou fit sans rect ; une étape sans rect qui ne donne pas à la fois x et y ; un fit qui nomme clip ou scale. Un d illisible est refusé, et l’erreur indique l’octet où la lecture s’arrête. Un texte posé le long d’un chemin n’accepte pas cette étape. Facultatives : fill, une couleur ou {"shading": "name"} ; stroke, un objet avec un width obligatoire plus color (noir par défaut), dash (un objet avec un lengths obligatoire et un phase, 0 par défaut), cap (butt par défaut, round, projecting) et join (miter par défaut, round, bevel) ; 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 rayon nul, un arc dont les deux bouts sont au même endroit, des rayons trop petits pour aller d’un bout à l’autre sans enlarge_radii, trois points qui ne nomment aucun cercle, un arc de cercle dont le rayon est négatif, et une suite de moins de deux points. Une forme 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": "path",
"clip": { "rule": "nonzero", "segments": [
{"move_to": {"x": 60, "y": 690}},
{"line_to": {"x": 290, "y": 690}},
{"line_to": {"x": 290, "y": 790}},
{"line_to": {"x": 60, "y": 790}},
"close"
] },
"segments": [
{"move_to": {"x": 72, "y": 700}},
{"line_to": {"x": 272, "y": 700}},
{"line_to": {"x": 172, "y": 780}},
"close"
],
"fill": [0.85, 0.89, 0.95],
"stroke": {"width": 1.0}
}
]
}
Formes
Un rectangle, plein ou au trait 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