Le poids du fichier et le temps de calcul

Régler l’effort de compression du document : le plus rapide, le plus petit, ou un fichier lisible dans un simple éditeur de texte.

Le résultat dans un vrai PDF

Réduire la taille du fichier

Un document écrit deux fois : une fois sans compression, une fois compressé. La page donne les deux tailles de fichier et ce que la compression a fait gagner.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Une feuille qui mesure ce qu’elle annonce

Résumé

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 — et c’est tout l’échange qui se joue ici. Le mode où l’on ne tasse rien du tout est à part : il existe pour le jour où l’on veut ouvrir le fichier dans un simple éditeur de texte et lire ce qu’il y a dedans.

Techniquement

Écrit au premier niveau d’une requête, sous "compression"

compression règle la force avec laquelle les flux du document sont compressés. Il existe trois réglages : compresser ou non, le niveau de 1 à 9, et le rassemblement des objets qui ne sont pas des flux dans des flux d’objets /ObjStm derrière un flux de références croisées /XRef. Ce dernier réduit nettement un document riche en petits objets, et demande un logiciel de lecture qui connaisse PDF 1.5 ; il reste désactivé par défaut, si bien qu’un fichier destiné à un logiciel de lecture plus ancien sort tel quel.

Schéma de la requête

  • 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 mais compresse le moins, 9 donne le fichier le plus petit mais est 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.
  • compression.cross_reference_stream — booléen, facultatif, false par défaut. Écrit la table de références croisées sous forme de flux compressé et laisse tous les autres objets tels quels, ce qui lève aussi la limite de dix chiffres imposée à la position d’un objet dans le fichier. object_streams écrit déjà la table de cette façon. Demande PDF 1.5 au moins et ne se combine pas avec first_page_first.

Une requête entière qui crée un PDF

{
  "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

Ce qui est dessiné, et ce que cela donne

Tout ce qu’on peut dessiner sur une page La première page, montrée pendant que le reste arrive Les calques que le logiciel de lecture montre ou cache Un nom qui vaut pour plusieurs calques à la fois Un dessin fait une fois, montré par un bouton Dessins lus dans des fichiers SVG Les jeux de calques que le logiciel de lecture propose Les calques dont le logiciel ne montre qu’un à la fois

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