Une ligne droite entre deux points
Tirer un trait d'un point à un autre, à l'épaisseur, à la couleur et au pointillé voulus : filet de séparation, soulignement, réglure.
Résumé
Le trait qu'on tire contre une règle : un départ, une arrivée, et rien à décider entre les deux. Bouts ronds ou carrés, pointillé ou tirets, dans la couleur qui va à la page. C'est le morceau le plus court à écrire quand on veut juste séparer deux choses.
Techniquement
Demandé avec
"type": "line"
Deux points et un trait : c'est tout ce que contient l'article, écrit en un unique couple m et l tracé avec S, et les coordonnées acceptent des expressions, donc une ligne court d'une marge à l'autre sans qu'on connaisse la largeur de la page. Le trait énonce son épaisseur, sa couleur, son motif de tirets avec sa phase, la forme de ses extrémités et celle de ses jointures. Une ligne se place sur les pages qu'elle nomme, se tourne, se transforme et se range sur un calque comme les autres articles dessinés.
Schéma de la requête
Clés obligatoires : from et to, des objets de x et de y, chacun un nombre ou une expression ; stroke, un objet avec un width obligatoire plus color (noir par défaut), dash (un objet avec un lengths obligatoire — au moins une longueur, aucune négative, pas toutes nulles — et un phase, 0 par défaut), cap (butt par défaut, round, projecting) et join (miter par défaut, round, bevel). Facultatives : 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é : transform avec rotate.
Une requête entière qui crée un PDF
{
"items": [
{
"type": "line",
"from": {"x": 72, "y": 720},
"to": {"x": "{page_width} - 72", "y": 720},
"stroke": {
"width": 1.2,
"color": [0.11, 0.31, 0.55],
"cap": "round",
"join": "round"
}
}
]
}Formes
Un tracé libre : lignes, courbes et surfaces Un rectangle plein ou encadré 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