Les zones que la page déclare

Énoncer ce que le logiciel de lecture montre d'une page et ce qu'un atelier d'impression en fait : la coupe, le débord d'encre, la zone utile.

Résumé

Quand un imprimeur fabrique une carte de visite, l'encre va sur une feuille plus grande et la carte est découpée ensuite. Pour que la couleur atteigne vraiment le bord, elle déborde un peu au-delà de la coupe : la lame ne tombe jamais deux fois exactement au même endroit. Chacune de ces boîtes est un rectangle, donné par ses quatre bords — gauche, bas, droite et haut — et elle voyage avec la page.

Techniquement

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

page_boxes écrit, page par page, les quatre boîtes qu'un PDF connaît au-delà de la feuille elle-même, en points : /CropBox, ce que le logiciel de lecture montre et imprime ; /BleedBox, le débord d'encre ; /TrimBox, la coupe ; et /ArtBox, la zone utile. Chaque boîte reste hors du fichier tant que la requête ne l'écrit pas, et le logiciel de lecture se rabat alors sur le /MediaBox. Une boîte qui déborde de la feuille est acceptée : le logiciel de lecture la coupe à la feuille, si bien qu'elle annonce simplement plus qu'elle ne vaut.

Schéma de la requête

  • page_boxes — tableau, facultatif, vide par défaut.
  • page_boxes[].page — entier ≥ 1, obligatoire. La page visée.
  • page_boxes[].crop — objet, facultatif. Ce que le logiciel de lecture montre et imprime. Tout ce qui est en dehors reste dans le fichier et y demeure pour qui veut le récupérer.
  • 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, ce qui y est dessiné sans ses marges.
  • Chaque boîte contient llx, lly, urx, ury : des nombres, tous obligatoires. Ce sont les bords gauche, bas, droite et haut, en points depuis le coin en bas à gauche de la feuille.

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 crée un PDF

{
  "page_boxes": [
    {
      "page": 1,
      "bleed": { "llx": 9, "lly": 9, "urx": 586, "ury": 833 },
      "trim": { "llx": 18, "lly": 18, "urx": 577, "ury": 824 }
    }
  ],
  "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

La feuille, et ce qu'on pose dessous

La taille des pages Une taille propre à certaines pages L'unité dans laquelle une page est mesurée Les formes posées sur ce qu'une page dessine L'orientation à l'écran et à l'impression Comment une page arrive, et combien de temps elle reste Jusqu'où un PDF fourni a le droit de se déplier Le modèle sous les pages

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

Voir les prix Voir les exemples