Le poids du fichier et le temps de calcul

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 on range des vêtements dans une valise, on peut les plier vite ou les tasser longuement. Le résultat tient dans le même sac, mais pas dans le même volume et pas dans le même temps. Le document se comporte pareil : on choisit entre aller vite et faire petit. Il y a aussi un mode où l'on ne tasse rien du tout, pratique quand on veut ouvrir le fichier et lire ce qu'il y a dedans avec un simple éditeur de texte.

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.

compression règle l'effort de compression des flux du document. Trois réglages existent : compresser ou non, le niveau de 1 à 9, et le regroupement des objets qui ne sont pas des flux dans des flux compressés. Ce dernier réduit nettement un document riche en petits objets, et demande un lecteur qui connaît PDF 1.5 ; il reste éteint par défaut, si bien qu'un fichier destiné à un lecteur plus ancien sort tel quel.

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.

• compression — objet, facultatif, absent par défaut.
• compression.enabled — booléen, facultatif, true par défaut. Une requête qui nomme le bloc sans rien dire compresse quand même, comme tout document. Mis à false, le fichier s'ouvre dans un éditeur de texte.
• compression.level — entier, facultatif, de 1 à 9. 1 est le plus rapide et laisse le plus derrière lui, 9 le plus petit et le plus lent. Absent, le moteur garde son niveau. Un nombre hors de 1 à 9 est refusé, et la réponse le nomme.
• compression.object_streams — booléen, facultatif, false par défaut. Rassemble dans des flux compressés les objets qui ne sont pas eux-mêmes des flux, et écrit la table de références croisées de la même façon. Demande PDF 1.5 au moins.

Une requête entière qui le dessine

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

{
  "compression": { "level": 9, "object_streams": true },
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 762 },
      "content": ["Packed as small as it goes"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

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