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, false par 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ù visible le 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 — un from égal ou supérieur au to, ou un from négatif — est refusée.
  • layers[].language — chaîne, facultative, aucune langue par défaut. Une étiquette de langue, par exemple 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 contenir son texte en deux langues et de n’en montrer qu’une.
  • layers[].preferred — booléen, facultatif, false par 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 sans language est 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, view par 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 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 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, ou technical, 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 ; 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, 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) ou logo. 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 sans layer est toujours là, sous tous les calques.
  • Les calques demandent PDF 1.5 au moins.
  • Un document qui déclare une norme archive refuse un calque qui déclare 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 : il ne fait rien dépendre, sur la page, de l’usage pour lequel on la regarde.
  • layers[].listed — booléen, facultatif, true par 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 disent printed et on_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 le metadata du document, ou {"packet": "part name"}, un paquet fourni en morceau et repris tel quel. Le name du 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"
    }
  ]
}

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

Voir les prix Voir les exemples