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.
Demandé avec
"type": "line"
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 le trait à la règle : vous donnez le point de départ, le point d'arrivée, et l'épaisseur. Il sert de séparation sous un titre, de ligne à remplir sur un formulaire papier, ou de réglure sur un carnet. Vous pouvez le vouloir en pointillé, en tirets, avec des bouts ronds ou carrés, dans la couleur de votre choix. C'est le morceau le plus court à écrire quand on veut juste séparer deux choses.
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.
Deux points et un trait : c'est tout ce que porte l'article, 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 porte 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.
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és obligatoires : from et to, objets à x et y, chacun un nombre ou une expression ; stroke, objet à width obligatoire, plus color (défaut noir), dash (objet à lengths obligatoire — au moins une longueur, aucune négative, non toutes nulles — et phase, défaut 0), cap (butt par défaut, round, projecting) et join (miter par défaut, round, bevel). Facultatives : 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é : transform et rotate ensemble.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"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]}
}
]
}Formes
Un tracé libre : lignes, courbes et surfaces Un rectangle plein ou encadré
Où aller ensuite
Chaque clé d'une requête, en une page Les vingt autres choses que l'on peut dessiner
Glossaire
- 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.