Skip to content

PageItemBase

Defined in: src/layout/page-doc.ts:295

The fields every PageItem shares (ir-design §6, frozen at stage 6.4): the positioned, layout-output vocabulary a page is made of. Page-frame geometry is branded Pt (PostScript points) with a TOP-LEFT origin, y growing downward (like CSS/SVG); the PDF emitter converts into PDF’s native y-up frame at emission. Offsets measured from a text baseline (math/inline-image boxes inside a Line) and styling magnitudes (font/stroke sizes) stay plain numbers — they are not page-frame coordinates.

readonly optional artifact?: "pagination"

Defined in: src/layout/page-doc.ts:330

Tagged PDF: explicitly mark this item as a pagination artifact (running header/footer, §14.8.2.2.2). Distinguishes header/footer text from not-yet-tagged body content so it is typed /Artifact /Pagination, never a P.


readonly optional behind?: boolean

Defined in: src/layout/page-doc.ts:314

§20.4.2.3 @behindDoc — the item is BEHIND the page’s content: a watermark, a slide’s backdrop. Such items paint before everything else, in their own order. Without that they rode the ordinary passes, where every shape paints after every image — so a slide’s white backdrop covered the photograph the slide is made of (corpus: tdf156808, tdf157635, tdf156856).


readonly optional pictureId?: number

Defined in: src/layout/page-doc.ts:324

The picture this item belongs to, when it is part of one. A metafile is a list of drawing orders, and text among them is BOTH over what came before and under what comes after: an embedded diagram writes a label, lays a panel over it and writes the label again, offset, as its own drop shadow. Painted in the ordinary passes — every shape, then every line — the buried copy would show through the panel. Items sharing this id are held out of those passes and painted together, in list order.


readonly optional structId?: number

Defined in: src/layout/page-doc.ts:306

Tagged PDF (§14.8): the logical structure node this item’s content belongs to. Set only on body content in tagged mode; undefined text in the line pass is treated as an artifact. Ignored when not tagging.


readonly optional z?: number

Defined in: src/layout/page-doc.ts:300

§20.4.2.3 — the float’s relativeHeight. Items with one are sorted by it inside their layer before the page is written; the rest keep their order.