Un dessin fait une fois, montré par un bouton
Décrire un dessin sous un nom, avec des traits et des formes, pour qu’un bouton de formulaire l’affiche comme icône.
Le résultat dans un vrai PDF
Une page et un tampon dans des cellules de tableau
Une page de contrôle pour un dossier envoyé par quelqu’un d’autre : chaque ligne montre une de ses pages, prise entière dans le fichier où elle est arrivée, à côté d’un tampon dessiné une fois et placé dans chaque ligne à laquelle il a été attribué. Les deux sont ajustés à la cellule que le tableau leur laisse, sans réclamer de largeur à leur colonne ni de hauteur à leur ligne.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Les notes qu’un programme se laisse · Une couleur, vue à travers six pochoirs · Un dessin, placé autant de fois qu’on veut
Résumé
Un bouton sur lequel on clique est plus parlant avec un petit dessin dessus qu’avec un mot : une coche verte, une flèche, une croix. Le motif est calculé à partir de traits et de formes plutôt que photographié, donc il reste net que le bouton fasse la taille d’un timbre ou celle d’une carte postale.
Techniquement
Écrit au premier niveau d’une requête, sous
"drawings"
drawings déclare les dessins que le document définit pour lui-même, chacun comme un XObject de forme avec ses propres /BBox et /Matrix, sous le nom par lequel l’icône d’un bouton le désigne. Un dessin contient les mêmes éléments qu’une page — un tracé, un rectangle, un trait, un bloc de texte — disposés dans un espace à lui plutôt que sur une feuille. Rien de neuf n’y est inventé : ce sont les éléments que le schéma a déjà. Il est écrit une fois dans le fichier et peint par son nom, quel que soit le nombre de fois qu’il est montré. Un dessin déclaré ici est posé sur une page par un élément drawing, et montré comme icône d’un bouton par son nom.
Schéma de la requête
-
drawings— tableau, facultatif, vide par défaut. -
drawings[].name— chaîne, obligatoire. Le nom sous lequel une icône affiche ce dessin. Aucun autre dessin de la demande, déclaré ou lu depuis un fichier SVG, ne prend ce nom. -
drawings[].box— objet, obligatoire. La zone de l’espace du dessin qui est gardée :llx,lly,urx,ury, des nombres, tous obligatoires. Rien en dehors n’est dessiné. -
drawings[].items— tableau, obligatoire. Les formes qui le composent, dans l’ordre du tracé. Quatre sortes :path,rect,line,text. -
drawings[].matrix— tableau de six nombres, facultatif. Ce que vaut l’espace propre du dessin dans l’espace où il est montré. Absent, il est montré tel qu’il a été dessiné. -
Un élément d’un dessin qui déclare
pages,layer,idourelative_toest refusé : un dessin n’est pas sur une page, et ses coordonnées ne nomment aucune variable de page. - Une image et un code sont prévus pour une version future à l’intérieur d’un dessin : un dessin n’a pas accès aux images de la requête.
-
Le bouton qui le montre est un élément
push_button, par sa cléicon,rollover_iconoudown_icon, avecicon_fitpour le cadrage etlayoutpour la place du libellé. -
drawings[].transparency— objet, facultatif. Fait du dessin son propre groupe de transparence, écrit comme latransparencydu document, avecspace,isolatedetknockout: ses traces sont composées ensemble dans l’espace de couleur nommé avant que le groupe ne rencontre ce sur quoi il est dessiné. Un espace que rien n’a déclaré est refusé, et aucun document revendiquantpdfa1aoupdfa1bn’en contient. -
drawings[].reuse— objet, facultatif. Ce qui est indiqué à l’imprimeur sur la conservation du dessin une fois traité :identity, une chaîne commune aux objets qui représentent le même visuel ;scope, la durée pendant laquelle il peut être conservé, parmisingle_use,record,file,stream,global,unknown;environment, une chaîne qui nomme le contexte dans lequel il a été traité, à indiquer pour un dessin conservé d’un fichier à l’autre. Chacune de ces clés est facultative ; une identité ou un environnement vide, ou qui contient autre chose que de l’ASCII imprimable, est refusé. -
drawings[].encapsulated— booléen, facultatif,falsepar défaut. Le dessin est écrit de façon autonome : il est rendu à l’identique partout où il est placé, si bien que l’imprimeur peut ne le traiter qu’une fois et garder le résultat. Avecvariable_print, un dessin autonome placé sur un calque est refusé.
Une requête entière qui crée un PDF
{
"drawings": [
{
"name": "tick",
"box": { "llx": 0, "lly": 0, "urx": 20, "ury": 20 },
"items": [
{
"type": "line",
"from": { "x": 3, "y": 10 },
"to": { "x": 8, "y": 4 },
"stroke": { "width": 2, "color": [0.09, 0.42, 0.24] }
},
{
"type": "line",
"from": { "x": 8, "y": 4 },
"to": { "x": 17, "y": 16 },
"stroke": { "width": 2, "color": [0.09, 0.42, 0.24] }
}
]
}
],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "push_button",
"name": "approve",
"rect": { "llx": 60, "lly": 740, "urx": 84, "ury": 764 },
"font": "sans",
"font_size": 10,
"icon": "tick",
"layout": "icon_only"
}
]
}
Ce qui est dessiné, et ce que cela donne
Tout ce qu’on peut dessiner sur une page Le poids du fichier et le temps de calcul La première page, montrée pendant que le reste arrive Les calques que le logiciel de lecture montre ou cache Un nom qui vaut pour plusieurs calques à la fois Dessins lus dans des fichiers SVG Les jeux de calques que le logiciel de lecture propose Les calques dont le logiciel ne montre qu’un à la fois
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête