Un dessin fait une fois, montré par un bouton

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.

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. On dessine ce petit motif une seule fois, on lui donne un nom, et le bouton le porte. Le dessin est fait de traits et de formes décrits ligne par ligne, ce qui le rend net à n'importe quelle taille : il est calculé, pas photographié.

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.

drawings déclare les dessins que le document définit pour lui-même, chacun sous le nom par lequel l'icône d'un bouton le montre. Un dessin porte les mêmes articles qu'une page — un tracé, un rectangle, un trait, un bloc de texte — posés dans un espace qui lui est propre plutôt que sur une feuille. Rien de neuf n'y est inventé : ce sont les articles que le schéma a déjà. Poser un dessin sur une page est prévu pour une version future ; aujourd'hui, son emploi est l'icône d'un bouton.

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.

• drawings — tableau, facultatif, vide par défaut.
• drawings[].name — chaîne, obligatoire. Le nom sous lequel une icône le montre. Un nom déclaré deux fois garde le dernier.
• drawings[].box — objet, obligatoire. La part de l'espace du dessin qui est gardée : x, y, width, height, nombres, tous obligatoires. Rien au 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 article de dessin qui déclarerait pages, layer, id ou relative_to est 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_icon ou down_icon, avec icon_fit pour le cadrage et layout pour la place du libellé.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "drawings": [
    {
      "name": "tick",
      "box": { "x": 0, "y": 0, "width": 20, "height": 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"
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

requête

Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.

Tous les mots que le site explique