Un dessin déclaré une fois et posé autant de fois qu'on veut

Posez sur la page un dessin que la demande a déclaré, où vous voulez et à la taille que vous voulez, sans que le fichier porte deux fois la même encre.

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 logo sur cent pages, un bloc de signature au bas de chaque contrat, un encadrement décoratif autour de chaque attestation : la forme est toujours la même, seule sa place change. Alors on la dessine une fois, on lui donne un nom, et ensuite on dit « pose celui-là ici, à cette taille ». Le fichier ne garde le dessin qu'une seule fois et y renvoie partout ailleurs, ce qui explique que cent pages du même badge pèsent à peine plus qu'une. On peut aussi le tourner, ou l'étirer, sans rien redessiner.

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.

Demandé avec "type": "drawing"

Un article drawing pose sur la page un dessin déclaré dans drawings. Le dessin porte son propre espace et sa propre boîte ; le poser dit où l'origine de cet espace atterrit, en x et y dans les coordonnées de la page, et par combien elle est multipliée. L'encre est écrite une seule fois dans le fichier, quel que soit le nombre de poses, et c'est ce qui rend un badge répété bon marché. Une pose a la même portée que tout autre article : les pages où elle paraît, une matrice ou une rotation, un calque, et la balise par laquelle l'arbre de structure la réclame — ou artifact, quand le dessin est du mobilier plutôt que quelque chose que le document dit.

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 : drawing, le nom d'un dessin déclaré dans drawings ; x et y, chacun un nombre ou une expression entre guillemets, où l'origine propre au dessin atterrit depuis le bord gauche et le bord bas de la page. Clés facultatives : scale, un nombre par lequel l'espace propre au dessin est multiplié, 1 par défaut ; pages, les pages où il est dessiné, comptées à partir de 1, vide pour toutes les pages, ou une règle qui les choisit ; transform, six nombres [a, b, c, d, e, f] ; rotate, en degrés dans le sens inverse des aiguilles, autour du centre de sa propre boîte ; layer, le nom d'un calque déclaré ; tag et mark, dits ensemble, qui ouvrent une course marquée que l'arbre de structure réclame ; artifact, ce dont le dessin est le mobilier. Refus croisés : transform avec rotate ; artifact avec tag ; un drawing qui ne nomme rien de déclaré. Un dessin déclaré prend name, box (un objet de x, y, width et height bornant la part de son espace qui est gardée), items, les formes dont il est fait, et un matrix facultatif de six nombres.

Une requête entière qui le dessine

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

{
  "drawings": [
    {
      "name": "badge",
      "box": {"x": 0, "y": 0, "width": 60, "height": 60},
      "items": [
        {
          "type": "rect",
          "rect": {"llx": 0, "lly": 0, "urx": 60, "ury": 60},
          "fill": [0.11, 0.31, 0.55]
        },
        {
          "type": "line",
          "from": {"x": 12, "y": 30},
          "to": {"x": 48, "y": 30},
          "stroke": {"width": 3, "color": [1, 1, 1]}
        }
      ]
    }
  ],
  "items": [
    {"type": "drawing", "drawing": "badge", "x": 72, "y": 700},
    {"type": "drawing", "drawing": "badge", "x": 160, "y": 700, "scale": 0.5}
  ]
}

La ligne qui l'envoie, en trois langages

Formes

Un tracé libre : lignes, courbes et surfaces Un rectangle plein ou encadré Une ligne droite entre deux points

Où aller ensuite

Chaque clé d'une requête, en une page Les vingt autres choses que l'on peut dessiner

Voir les prix Voir les exemples

Glossaire

CMJN: Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.
arbre de structure: La liste, tenue dans un PDF balisé, qui dit ce qu'est chaque partie de la page et à quoi elle appartient : ce bloc est une section, cette ligne son titre, cette suite de cellules une ligne de ce tableau. C'est la forme du document, tenue à part de l'encre.
signature: Un cachet posé à l'intérieur du document. Il prouve deux choses d'un coup : qui l'a approuvé, et que rien n'y a changé depuis. Le logiciel qui ouvre le fichier l'annonce dans un bandeau, en haut de la page.
calque: Un groupe nommé de choses dessinées sur une page, que l'on affiche ou masque dans son logiciel de lecture, 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.

Tous les mots que le site explique