Les calques que le logiciel de lecture montre ou cache
Rangez ce qui est dessiné dans des calques nommés, montrés ou cachés d’un clic, et qu’un logiciel de lecture affiche selon le grossissement ou la langue.
Le résultat dans un vrai PDF
Un seul dessin, et chacun y voit le sien
Le même plan d’étage sur six calques montrés et cachés un par un : les meubles et les cotes montrés, les notes internes cachées jusqu’à ce qu’on les demande, et un filigrane de brouillon destiné à l’écran et non au papier.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Un plan qui montre ce qui se lit · Liens internes et externes · Un formulaire interactif
Résumé
Un architecte travaille avec des calques empilés : les murs sur l’un, les meubles sur un autre, les cotes sur un troisième. Il en soulève un pour le retirer de la vue, et ici c’est exactement le même geste. Vous pouvez aussi décider qu’un calque se voit à l’écran mais ne s’imprime pas — un filigrane de brouillon, par exemple. Et un calque peut se manifester de lui-même : 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 calques 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.
Techniquement
Écrit au premier niveau d’une requête, sous
"layers"
layers écrit dans /OCProperties un /OCG par calque, chacun sous le nom qu’un élément donne au calque sur lequel il est dessiné, et regroupe dans le flux de contenu les marques dessinées sur un même calque pour que le logiciel de lecture les affiche ou les masque ensemble. Le logiciel de lecture les liste dans son panneau, dans l’ordre où la requête les déclare, et affiche ou masque d’un coup tout ce qui se trouve sur l’un d’eux. Un calque qui déclare un heading est listé sous cet intitulé et non isolément : /Order contient alors un tableau imbriqué qui s’ouvre sur cet intitulé, placé là où a été déclaré le premier calque de cet intitulé, et qui contient tous les calques de même intitulé. /Usage contient le reste. L’affichage à l’écran et l’impression sont réglés séparément : leur donner des réponses opposées produit un calque qu’on ne fait que regarder, ou qu’imprimer. Un calque peut aussi s’afficher sans passer par le panneau : un zoom l’affiche entre deux grossissements, et une language l’affiche dans le logiciel de lecture réglé sur cette langue et le masque dans celui réglé sur toute autre. Un calque que le panneau refuse de basculer est locked, et démarre tout de même dans l’état que fixe visible. Quatre entrées disent ce qu’est le calque plutôt que quand il s’affiche : intent s’écrit à côté du nom, sur le groupe lui-même, et la configuration sous laquelle le document s’ouvre contient la liste des intentions sous lesquelles il se lit ; made_by, purpose et role sont trois rubriques supplémentaires de /Usage, la deuxième écrite à côté de l’état d’impression, dans la même entrée.
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. Dit si le calque démarre affiché. Absent, il démarre affiché. -
layers[].printed— booléen, facultatif. Dit si l’impression montre le calque, quoi que dise le panneau. Absent, l’impression suit le panneau. -
layers[].on_screen— booléen, facultatif. Dit si l’affichage montre le calque, quoi que dise le panneau. Absent, l’écran suit le panneau. -
layers[].locked— booléen, facultatif,falsepar défaut. Dit si le logiciel de lecture refuse de commuter le calque dans son panneau. Un calque verrouillé garde son entrée, qui montre l’état dans lequel il démarre, et démarre tout de même là oùvisiblele place. -
layers[].zoom— objet, facultatif. Les grossissements entre lesquels le calque s’affiche, quoi que dise le panneau. En son absence, le calque s’affiche à 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 s’affiche, celui-là compris. En son absence, le calque n’a pas de plancher, ce qui revient à 0. -
layers[].zoom.to— nombre, facultatif. Le grossissement en dessous duquel le calque s’affiche, celui-là exclu. En son absence, le calque n’a pas de plafond. Une paire que rien ne peut satisfaire — unfromégal ou supérieur auto, ou unfromnégatif — est refusée. -
layers[].language— chaîne, facultative, aucune langue par défaut. Une étiquette de langue, par exemplefr-FRouen-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 contenir son texte en deux langues et de n’en montrer qu’une. -
layers[].preferred— booléen, facultatif,falsepar défaut. Dit 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 sanslanguageest refusé. -
layers[].heading— chaîne, facultative, 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, facultative,viewpar défaut. Dit si le calque contient une partie du document,view, ou une aide pour qui crée le document,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 calquedesignse commute donc depuis un jeu delayer_configurations, et chacun de ces jeux nomme les deux intentions dès qu’un calque est de typedesign. -
layers[].made_by— objet, facultatif. Le programme qui a fabriqué le calque et la nature du travail qu’il contient, é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 contient le calque :artwork, le contenu d’un logiciel de graphisme ou d’édition, outechnical, le contenu d’un dessin technique, comme un plan de bâtiment ou un schéma. -
layers[].purpose— chaîne, facultative. 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 ; ouprinters_marks, ce que lit la presse plutôt que le lecteur. Énoncé à part deprinted: 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, facultative. La part de la page que contient le calque :header_footer(un titre ou un bas de page courant),background(tracé derrière ce que la page dit),foreground(tracé par-dessus) oulogo. Un programme qui démonte une page le lit pour réassembler ce qu’il en extrait. -
Un élément se pose sur un calque par sa clé
layer, qui contient le nom déclaré ici. Un élément sanslayerest toujours là, sous tous les calques. - Les calques demandent PDF 1.5 au moins.
-
Un document qui déclare une norme
archiverefuse un calque qui déclareprinted,on_screen,zoomoulanguage: un fichier d’archivage laisse cette décision au logiciel de lecture. Le calque lui-même passe, etlockedaussi : il ne fait rien dépendre, sur la page, de l’usage pour lequel on la regarde. -
layers[].listed— booléen, facultatif,truepar défaut. Si le panneau des calques du logiciel de lecture affiche le calque. Un calque tenu hors du panneau reste affiché ou masqué selon son état de départ, basculé par une règle ou un bouton, imprimé ou affiché là où le disentprintedeton_screen; mais le lecteur ne peut pas l’atteindre lui-même. -
layers[].exported— booléen, facultatif. Si l’export du document vers un autre format garde le calque, quoi que dise le panneau :false, c’est un calque de notes de relecture affiché à l’écran et retiré de la copie qu’on transmet. Absent, l’export suit le panneau. -
layers[].metadata— objet, facultatif. Ce qu’est le calque, pour un programme qui lit le fichier — un tracé de découpe, un vernis, une sous-couche blanche — dans un paquet à lui :{"facts": {…}}, écrit à partir des champs que prend lemetadatadu document, ou{"packet": "part name"}, un paquet fourni en morceau et repris tel quel. Lenamedu calque reste ce qu’une personne lit dans le panneau.
Une requête entière qui crée un PDF
{
"layers": [
{
"name": "Dimensions",
"made_by": { "application": "Plan Studio", "work": "technical" }
},
{ "name": "Draft", "on_screen": true, "printed": false },
{ "name": "Crop marks", "locked": true },
{ "name": "Fine print", "zoom": { "from": 2 } },
{
"name": "French wording",
"language": "fr-FR",
"heading": "Wording"
},
{
"name": "English wording",
"language": "en-GB",
"preferred": true,
"heading": "Wording"
},
{ "name": "Grid", "intent": "design" },
{ "name": "Draft mark", "purpose": "watermark" },
{ "name": "Badge", "role": "logo" }
],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "rect",
"rect": { "llx": 80, "lly": 560, "urx": 380, "ury": 760 },
"stroke": { "width": 2 }
},
{
"type": "text",
"rect": { "llx": 80, "lly": 540, "urx": 380, "ury": 556 },
"content": ["300 by 200"],
"font": "sans",
"font_size": 10,
"layer": "Dimensions"
},
{
"type": "text",
"rect": { "llx": 80, "lly": 700, "urx": 380, "ury": 740 },
"content": ["DRAFT"],
"font": "sans",
"font_size": 36,
"color": [0.85, 0.85, 0.85],
"layer": "Draft"
},
{
"type": "text",
"rect": { "llx": 80, "lly": 520, "urx": 380, "ury": 534 },
"content": ["Shown from twice the page size upwards"],
"font": "sans",
"font_size": 7,
"layer": "Fine print"
},
{
"type": "text",
"rect": { "llx": 80, "lly": 480, "urx": 380, "ury": 496 },
"content": ["Plan du premier etage"],
"font": "sans",
"font_size": 11,
"layer": "French wording"
},
{
"type": "text",
"rect": { "llx": 80, "lly": 480, "urx": 380, "ury": 496 },
"content": ["First floor plan"],
"font": "sans",
"font_size": 11,
"layer": "English wording"
}
]
}
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 La première page, montrée pendant que le reste arrive 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