Les zones que la page déclare

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.

Quand un imprimeur fabrique une carte de visite, il imprime sur une feuille plus grande, puis il coupe. Pour que la couleur aille bien jusqu'au bord, elle déborde un peu au-delà du trait de coupe : la lame ne tombe jamais deux fois au même endroit exactement. La page peut porter ces repères avec elle : voilà où on coupe, voilà jusqu'où l'encre va, voilà le dessin qui compte vraiment. Chacun de ces repères est un rectangle qu'on donne par son coin en bas à gauche, sa largeur et sa hauteur.

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.

page_boxes déclare, page par page, les quatre boîtes qu'un PDF connaît au-delà de la feuille elle-même : ce qu'un lecteur montre et imprime, le débord d'encre, le trait de coupe, et le dessin utile. Chaque boîte reste absente du fichier tant que la requête ne l'écrit pas, et un lecteur prend alors la feuille entière à sa place. Une boîte qui déborde de la feuille est acceptée : un lecteur l'intersecte avec la feuille, elle dit simplement plus que ce qu'elle vaut.

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.

• page_boxes — tableau, facultatif, vide par défaut.
• page_boxes[].page — entier ≥ 1, obligatoire. La page visée.
• page_boxes[].crop — objet, facultatif. Ce qu'un lecteur montre et imprime. Ce qui est dehors reste dans le fichier et reste récupérable.
• page_boxes[].bleed — objet, facultatif. Ce sur quoi la presse pose de l'encre, encre qui court au-delà de la coupe.
• page_boxes[].trim — objet, facultatif. Là où la lame tombe : la page telle qu'elle sort du façonnage.
• page_boxes[].art — objet, facultatif. Ce qui vaut d'être gardé de la page, le dessin sans ses marges.
• Chaque boîte porte x, y, width, height : nombres, tous obligatoires. x et y sont le coin en bas à gauche.

Une entrée dit ce qu'on fait d'une page, pas qu'il y en a une : une page nommée au-delà de la fin du document laisse le document aussi long qu'il était. Une page nommée deux fois prend la dernière entrée, entière.

Une requête entière qui le dessine

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

{
  "page_boxes": [
    {
      "page": 1,
      "bleed": { "x": 9, "y": 9, "width": 577, "height": 824 },
      "trim": { "x": 18, "y": 18, "width": 559, "height": 806 }
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 0, "lly": 0, "urx": 595, "ury": 842 },
      "fill": [0.93, 0.95, 0.98]
    },
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
      "content": ["The colour runs past the cutting line"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

La ligne qui l'envoie, en trois langages

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.

lame

Le couteau qui coupe une feuille imprimée jusqu'à la page finie. Il descend d'un coup sur toute une pile, donc il tombe à une fraction de millimètre de la ligne plutôt que dessus — et c'est la raison pour laquelle une page imprimée jusqu'au bord est dessinée plus grande qu'elle ne sera.

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