Un tampon en travers de la page
Poser un mot en travers d'une zone, à la taille qui remplit la boîte : brouillon, payé, copie, annulé, en diagonale ou à plat.
Demandé avec
"type": "stamp"
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 mot en gros que l'on voit en travers d'un document : BROUILLON, PAYÉ, COPIE. Vous donnez le mot et la zone qu'il doit traverser, et il prend tout seul la taille qu'il faut pour la remplir. Vous choisissez le sens : en montant vers le coin en haut à droite, en descendant vers le coin en bas à droite, ou bien à plat. Une couleur claire et une ombre légère suffisent à le rendre présent sans gêner la lecture du document en dessous.
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.
Un tampon est ce qu'un document dit de lui-même plutôt que ce qu'il dit. Sa taille de police est déduite : le moteur cale la ligne sur la diagonale ou sur la largeur de la boîte, puis applique la part de la boîte demandée, 0,95 par défaut, ce qui laisse une marge tout autour. Le même tampon convient donc à une étiquette et à une affiche sans changer de réglage. Le décalage de l'ombre est compté en points sur la page, donc il tombe du même côté quel que soit le sens de la ligne. Une rotation vient s'ajouter à l'inclinaison choisie.
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 : content, chaîne, la ligne du tampon ; rect ; font, nom d'une police déclarée. Facultatives : span, nombre, part de la boîte remplie, 1 la remplissant entière, défaut 0,95 ; slant, valant up (défaut, du coin inférieur gauche au coin supérieur droit), down ou flat ; color (défaut noir) ; shadow, objet à dx, dy et color, les trois obligatoires ; 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. La taille de police est déduite de la boîte : le fil expose span pour la régler.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"standard_fonts": [{"name": "sans", "face": "helvetica_bold"}],
"items": [
{
"type": "stamp",
"content": "DRAFT",
"rect": {"llx": 72, "lly": 500, "urx": 523, "ury": 700},
"font": "sans",
"color": [0.75, 0.16, 0.16]
}
]
}Texte
Un bloc de texte posé sur la page Du texte en paragraphes, avec retraits et tabulations
Où aller ensuite
Chaque clé d'une requête, en une page Les vingt autres choses que l'on peut dessiner
Glossaire
- police
- Le dessin de chaque lettre, de chaque chiffre et de chaque signe qu'un document écrit, rangé dans un fichier à part. Un PDF emporte à l'intérieur de lui-même les polices dans lesquelles il est composé : c'est pour cela qu'il s'ouvre à l'identique sur une machine qui ne les a jamais eues. Sans elles, un lecteur en met une autre à la place, et la mise en page bouge.
- 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.