Les formes qu'une page porte par-dessus son dessin
Posez des carrés, des cercles, des traits et des contours sur une page, chacun avec sa couleur, son bord et sa note.
Résumé
Certaines marques vont par-dessus une page plutôt que dedans : le cercle autour d'une clause, le trait qui relie un commentaire à un chiffre, le contour tracé autour d'une zone d'un plan. Un logiciel de lecture les montre au-dessus de la page, les liste à côté, et on peut lui dire de ne pas les mettre sur le papier. Chacune porte une note qu'un logiciel de lecture affiche quand la souris s'y arrête.
Techniquement
Écrit au premier niveau d'une requête, sous
"page_annotations"
page_annotations écrit les /Annots d'une page : une entrée par page, et dedans les formes dans l'ordre où elles sont écrites. Cinq sortes sont acceptées, chacune se nommant sous type : square et circle, inscrits dans le rectangle qu'ils énoncent ; line, entre deux points ; polygon, une suite fermée de segments ; et polyline, une suite ouverte. Toute forme prend les six mêmes clés communes, et ce sont les formes de la dernière entrée donnée pour une page que cette page porte.
Schéma de la requête
-
page_annotations— tableau, facultatif, vide par défaut. -
page_annotations[].page— entier ≥ 1, obligatoire. La page concernée par les formes. -
page_annotations[].shapes— tableau, obligatoire. Les formes que cette page porte, dans l'ordre où elles sont écrites. -
shapes[].type— chaîne, obligatoire. L'une desquare,circle,line,polygon,polyline. -
squareetcircle—llx,lly,urx,ury: nombres, tous obligatoires, le rectangle dans lequel la forme est inscrite.interior— couleur, facultatif, ce qui la remplit.effect—plainoucloudy, 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é, sousfrometto.interior— couleur, facultatif, ce qui remplit ces extrémités. -
polygonetpolyline—vertices: tableau de paires de nombres, obligatoire.interior— couleur, facultatif.polygonprend aussieffect,polylineprend aussiendings. -
Commun à toute forme :
contents— chaîne, facultatif, la note qu'un logiciel de lecture affiche.name— chaîne, facultatif, le nom sous lequel la forme est connue.color— couleur, facultatif, celle du bord.border— objet, facultatif,widthen points et undashfacultatif.layer— chaîne, facultatif, 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.
Une requête entière qui le dessine
{
"page_annotations": [
{
"page": 1,
"shapes": [
{
"type": "square",
"llx": 60, "lly": 640, "urx": 300, "ury": 700,
"color": { "rgb": [0.8, 0.1, 0.1] },
"border": { "width": 2 },
"contents": "The clause under discussion",
"flags": { "printed": false }
}
]
}
],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
"content": ["A square laid over the clause, and kept off the paper"],
"font": "sans",
"font_size": 14
}
]
}
La feuille, et ce qu'on pose dessous
La taille des pages Une taille propre à certaines pages L'unité dans laquelle une page est mesurée Les zones que la page déclare L'orientation à l'écran et à l'impression Comment une page arrive, et combien de temps elle reste Jusqu'où un PDF fourni a le droit de se déplier Le papier à en-tête sous les pages
Où aller ensuite
Chaque clé d'une requête, en une page Les quarante et un autres réglages d'une requête