Les calques que le logiciel de lecture montre ou cache

Résumé

Un architecte travaille avec des feuilles transparentes empilées : les murs sur l'une, les meubles sur une autre, les cotes sur une troisième. Il en soulève une pour la retirer de la vue, et ici c'est exactement le même geste. Vous pouvez aussi décider qu'une couche se voit à l'écran mais ne s'imprime pas — un filigrane de brouillon, par exemple. Et une couche peut se signaler toute seule : les cotes fines d'un plan apparaissent une fois qu'on s'est assez approché pour les lire, et une légende écrite deux fois, en deux langues, montre à chacun celle sur laquelle son programme est réglé. Les couches qui vont ensemble — les murs, la toiture et les ouvertures d'un même bâtiment — se regroupent sous un intitulé, que le panneau montre comme un seul bloc, replié d'un clic.

Schéma de la requête

• layers — tableau, facultatif, vide par défaut.
• layers[].name — chaîne, obligatoire. Le nom par lequel les éléments nomment ce calque, et le nom que le logiciel de lecture montre dans son panneau.
• layers[].visible — booléen, facultatif. Si le calque démarre affiché. Absent, il démarre affiché.
• layers[].printed — booléen, facultatif. Si l'impression montre le calque, quoi que dise le panneau. Absent, l'impression suit le panneau.
• layers[].on_screen — booléen, facultatif. Si l'affichage montre le calque, quoi que dise le panneau. Absent, l'écran suit le panneau.
• layers[].locked — booléen, facultatif, false par défaut. Si le logiciel de lecture refuse de commuter le calque dans son panneau. Un calque verrouillé garde son entrée, qui montre l'état sous lequel il part, et part tout de même là où visible le place.
• layers[].zoom — objet, facultatif. Les grossissements entre lesquels le calque se montre, quoi que dise le panneau. Absent, il se montre à tous les grossissements, et un objet qui ne nomme aucune des deux bornes est refusé.
• layers[].zoom.from — nombre, facultatif. Le grossissement à partir duquel le calque se montre, celui-là compris. Absent, il n'a pas de plancher, c'est-à-dire 0.
• layers[].zoom.to — nombre, facultatif. Le grossissement en dessous duquel le calque se montre, celui-là exclu. Absent, il n'a pas de plafond. Une paire que rien ne peut satisfaire — un from égal ou supérieur au to, ou un from négatif — est refusée.
• layers[].language — chaîne, facultatif, aucune langue par défaut. Une étiquette de langue, fr-FR ou en-GB. Le logiciel de lecture réglé sur cette langue montre ce calque et cache les calques de toutes les autres langues, ce qui permet à une même feuille de tenir son texte deux fois et de n'en montrer qu'un.
• layers[].preferred — booléen, facultatif, false par défaut. Si c'est le calque sur lequel le logiciel de lecture se rabat quand aucun calque n'énonce exactement la langue sur laquelle il est réglé. L'énoncer sans language est refusé.
• layers[].heading — chaîne, facultatif, aucun intitulé par défaut. L'intitulé sous lequel le logiciel de lecture regroupe le calque dans son panneau. Tout calque déclaré sous le même intitulé est montré dessous, comme un seul bloc qu'un lecteur replie et déplie, et le bloc se tient là où le premier calque qui l'énonce a été déclaré. Un calque qui n'en énonce aucun se tient seul au premier niveau du panneau.
• layers[].intent — chaîne, facultatif, view par défaut. Si le calque porte du contenu du document, view, ou une aide pour qui l'a fabriqué, design : une grille, un repère, un cadre de marge. Le logiciel de lecture n'applique que les calques dont l'intention figure dans le jeu sous lequel il lit. Le jeu sous lequel un document s'ouvre ne nomme que l'intention de lecture, comme le demande la norme PDF (ISO 32000) ; un calque design se commute donc depuis un jeu de layer_configurations, et chacun de ces jeux nomme les deux intentions dès qu'un calque est de type design.
• layers[].made_by — objet, facultatif. Le programme qui a fabriqué le calque et la nature du travail qu'il tient, énoncés ensemble ; l'un sans l'autre est refusé.
• layers[].made_by.application — chaîne, obligatoire. Le programme, sous le nom qu'il se donne.
• layers[].made_by.work — chaîne, obligatoire. La nature du travail que tient le calque : artwork, le contenu d'un logiciel de graphisme ou d'édition, ou technical, le contenu d'un dessin technique, comme un plan de bâtiment ou un schéma.
• layers[].purpose — chaîne, facultatif. Ce qu'est le calque sur la feuille imprimée : watermark, une marque posée par-dessus ou par-dessous ce que la page dit ; trapping, le recouvrement dont la presse a besoin là où deux encres se touchent ; ou printers_marks, ce que lit la presse plutôt que le lecteur. Énoncé à part de printed : dire ce qu'est un calque ne dit rien de son impression, et un calque qui ne dit que ce qu'il est n'est commuté par aucun événement d'impression.
• layers[].role — chaîne, facultatif. Ce que le calque tient de la page : header_footer (un titre ou un bas de page courant), background (tracé derrière ce que la page dit), foreground (tracé par-dessus) ou logo. Un programme qui démonte une page le lit pour remettre ensemble ce qu'il en tire.
• Un élément se pose sur un calque par sa clé layer, qui contient le nom déclaré ici. Un élément sans layer est toujours là, sur toutes les couches.
• Les calques demandent PDF 1.5 au moins.
• Un document qui énonce une norme archive refuse un calque qui énonce printed, on_screen, zoom ou language : un fichier d'archivage laisse cette décision au logiciel de lecture. Le calque lui-même passe, et locked aussi, qui ne fait dépendre rien de ce qui est sur la page de la raison pour laquelle on la regarde.