Les formes posées sur ce qu'une page dessine

Résumé

Certaines marques se placent au-dessus d'une page plutôt que dedans : le cercle autour d'une clause, le trait qui relie un commentaire à une figure, le contour tracé autour d'une zone de plan. Le logiciel de lecture les montre par-dessus la page, les liste à côté d'elle, et on peut lui dire de les tenir hors du papier. Chacune contient une note que le logiciel de lecture affiche quand la souris s'arrête dessus.

Schéma de la requête

• page_review_marks — tableau, facultatif, vide par défaut.
• page_review_marks[].page — entier ≥ 1, obligatoire. La page concernée par les formes.
• page_review_marks[].shapes — tableau, obligatoire. Les formes que cette page contient, dans l'ordre où elles sont écrites.
• shapes[].type — chaîne, exigé. Une valeur parmi square, circle, line, polygon, polyline, redaction.
• square et circle — llx, lly, urx, ury : nombres, tous obligatoires, le rectangle dans lequel la forme est inscrite. interior — couleur, facultatif, ce qui la remplit. effect — plain ou cloudy, facultatif, la façon dont le bord est tracé.
• line — x1, y1, x2, y2 : nombres, tous obligatoires. endings — objet, facultatif, ce que porte chaque extrémité, sous from et to, chacune valant none (rien de dessiné, ce que porte une extrémité laissée de côté), square, circle, diamond, open_arrow, closed_arrow, butt, reverse_open_arrow, reverse_closed_arrow ou slash. interior — couleur, facultatif, ce qui remplit ces extrémités.
• polygon et polyline — vertices : tableau de paires de nombres, obligatoire. interior — couleur, facultatif. polygon prend aussi effect, polyline prend aussi endings.
• redaction — llx, lly, urx, ury : nombres, tous exigés, la partie marquée. over — tableau, facultatif, les emplacements à l'intérieur, chacun de quatre coins dans le sens inverse des aiguilles ; absent, c'est le rectangle lui-même qui est marqué. fill — couleur, facultatif, ce dont l'emplacement vidé est rempli. overlay_text — chaîne, facultatif, les mots imprimés là où était le contenu. repeating — booléen, facultatif, faux par défaut, si ces mots sont posés encore et encore jusqu'à remplir l'emplacement. aligned — une valeur parmi left (par défaut), center et right, où ces mots se tiennent ; lu seulement à côté de mots.
• Une marque de caviardage énonce ce qui doit partir. Elle ne l'enlève pas. Ce que décrivent fill, overlay_text et aligned, c'est la page telle qu'elle sera une fois qu'un logiciel de lecture aura appliqué la marque et réécrit le document : tant que cela n'a pas eu lieu, les mots sont toujours dans le fichier sous la marque, et une recherche les trouve.
• Communes à toutes les formes : contents — chaîne, facultative, la note que le logiciel de lecture affiche. name — chaîne, facultative, le nom sous lequel la forme est connue. color — couleur, facultative, celle du bord. border — objet, facultatif, une width en points et un dash facultatif. layer — chaîne, facultative, le calque déclaré sur lequel la forme est dessinée.
• shapes[].flags — objet, facultatif. printed — booléen, si la forme part sur le papier. hidden, no_view, no_zoom, no_rotate, invisible, read_only — booléens, faux par défaut.

Une forme est posée par-dessus la page, pas dans ce que la page dessine : elle reste en dehors du texte qu'un lecteur copie, et en dehors de la structure que le document déclare sur lui-même.