Une case répétée pour remplir une forme

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.

Pensez à un carrelage. Vous ne dessinez pas chaque carreau : vous en dessinez un, et vous dites à quelle distance ils se posent. Ici c'est pareil. Vous dessinez une petite case — une barre, un point, une croix — vous dites à quelle distance les cases se suivent en largeur et en hauteur, et toute forme que vous remplissez avec ce nom se couvre de la case répétée. Ça coûte au fichier une seule case, quelle que soit la taille de la forme. Écartez les cases plus que la case n'est large et vous obtenez des vides entre elles ; rapprochez-les et elles se chevauchent, la plus tardive par-dessus la plus ancienne. Une case qui ne bouge jamais est refusée : elle se poserait à jamais au même endroit.

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.

Écrit au premier niveau d'une requête, sous "tilings"

tilings déclare les cases répétées que le document définit pour lui-même, chacune sous le nom par lequel le remplissage d'une forme la choisit. box est la part de l'espace propre à la case qui est posée, et rien de ce qui est en dehors n'est dessiné. step est la distance entre les cases, en largeur et en hauteur : plus large que la boîte laisse un vide, plus étroit les fait se chevaucher, et un pas nul est refusé. colored dit si la case porte ses propres couleurs — une case qui ne les porte pas prend celle de ce qui la remplit, ce qui permet à une même hachure de servir dans n'importe quelle couleur. spacing dit ce qu'un logiciel de lecture a le droit d'échanger entre le pas et la case, et absente, le pas reste exact. Un nom déclaré deux fois garde le dernier.

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.

• tilings — tableau, facultatif, vide par défaut.
• tilings[].name — chaîne, obligatoire. Le nom sous lequel un remplissage choisit cette case. Un nom déclaré deux fois garde le dernier.
• tilings[].box — objet, obligatoire, de x, y, width et height. La part de l'espace propre à la case qui est posée.
• tilings[].step — tableau de deux nombres, obligatoire. La distance entre les cases, en largeur et en hauteur. Un pas nul est refusé.
• tilings[].colored — booléen, facultatif, true par défaut. Si la case dit ses propres couleurs. Une case qui ne les dit pas prend la couleur de ce qui la remplit, ce qui permet à une même hachure de servir dans n'importe quelle couleur.
• tilings[].spacing — chaîne, facultative. Ce qu'un logiciel de lecture a le droit d'échanger entre le pas et la case : constant, undistorted, constant_and_fast. Absente, le pas reste exact.
• tilings[].items — tableau, obligatoire. Les formes dont la case est faite, dans l'ordre où elles sont dessinées, comme un dessin déclaré les prend.
• tilings[].matrix — tableau de six nombres, facultatif. Ce qu'est l'espace propre au plan pavé dans l'espace de la page. Absent, le pavage se fait dans l'espace de la page, si bien qu'une hachure se penche en inclinant le plan plutôt qu'en dessinant une case penchée.

Portée : le document entier. Une forme atteint une case en la nommant là où elle nommerait une couleur, et la case est posée dans les coordonnées de la page, si bien que deux formes remplies de la même case s'alignent l'une sur l'autre.

Une requête entière qui le dessine

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

{
  "tilings": [
    {
      "name": "upright",
      "box": { "x": 0, "y": 0, "width": 8, "height": 8 },
      "step": [8, 8],
      "items": [
        {
          "type": "rect",
          "rect": { "llx": 0, "lly": 0, "urx": 3, "ury": 8 },
          "fill": [0.12, 0.28, 0.52]
        }
      ]
    }
  ],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 72, "lly": 600, "urx": 320, "ury": 740 },
      "fill": { "pattern": "upright" }
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

logiciel de lecture

Le programme qui ouvre un PDF et le pose sur un écran — celui installé sur la machine, ou celui que porte un navigateur. Sur ce site, la personne qui tient le document est le lecteur, et le programme qui le lui montre est un logiciel de lecture : le document demande, et chaque programme répond pour lui-même. Sa page les nomme un par un.

Tous les mots que le site explique