La première page, montrée pendant que le reste arrive
Demander que le fichier soit écrit première page d’abord, pour que celui qui l’ouvre depuis un lien voie la page 1 presque tout de suite.
Le résultat dans un vrai PDF
Montrer la page un sans attendre le reste
Le même document écrit deux fois : une fois tel quel, une fois avec sa première page placée au début du fichier. La page donne, pour chacun des deux, le nombre d’octets qu’un navigateur doit avoir reçus avant d’afficher la page 1.
Résumé
Un PDF s’écrit à l’envers : ce qui dit où commence chaque page se trouve tout à la fin du fichier. Le logiciel de lecture attend donc le fichier entier avant de pouvoir montrer quoi que ce soit, et sur un catalogue de quatre cents pages ouvert depuis un lien, cette attente dure plusieurs secondes. Le même document peut s’écrire dans un autre ordre, avec en tête sa première page et une table indiquant où commencent les autres, de sorte que la page 1 s’affiche pendant que le reste arrive encore. Le fichier est un peu plus gros et un peu plus long à écrire, et il contient exactement le même document.
Techniquement
Écrit au premier niveau d’une requête, sous
"first_page_first"
first_page_first mis à true écrit le fichier linéarisé : un dictionnaire d’indices en tête, puis les objets de la première page et les ressources qu’elle utilise, et enfin les tables qui indiquent où commencent toutes les autres pages et chaque catégorie d’objet. Un logiciel de lecture qui sait s’en servir récupère l’en-tête par une requête de plage d’octets et affiche la page 1 ; celui qui ne sait pas lit le fichier de la façon habituelle et n’y perd rien. Deux modes d’écriture sont incompatibles avec ce réglage, et le moteur refuse chacun d’eux plutôt que d’écrire un fichier qui ne s’ouvrirait pas : compression.object_streams, parce qu’un fichier linéarisé indique la position en octets de chaque objet et qu’un objet regroupé dans un flux n’a pas de position propre, et protection, parce que ce qui protège chaque objet est dérivé de son numéro et que la linéarisation renumérote les objets.
Schéma de la requête
-
first_page_first— booléen, facultatif,falsepar défaut. Àtrue, le fichier est écrit première page d’abord ; àfalse, ou en l’absence de la clé, il est écrit dans l’ordre habituel. -
Refusés à côté de lui :
protection, etcompressiondéclarantobject_streamsà vrai. Les deux refus viennent du moteur, qui dit laquelle des deux le fichier ne peut pas contenir.
Une requête entière qui crée un PDF
{
"first_page_first": true,
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 762 },
"content": ["Page one, while the rest is still arriving"],
"font": "sans",
"font_size": 14
}
]
}
Ce qui est dessiné, et ce que cela donne
Tout ce qu’on peut dessiner sur une page Le poids du fichier et le temps de calcul 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