PageItemBase

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.

Extended by

Properties

artifact?

readonly optional artifact?: "pagination"

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

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.

behind?

readonly optional behind?: boolean

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

§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).

over?

readonly optional over?: boolean

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

The item stands IN FRONT of the page’s text and covers it — a drawing floating over a spreadsheet’s cells. A page paints its text after its shapes, so such items are painted as a second layer, every pass again, once the first layer’s text is down.

pictureId?

readonly optional pictureId?: number

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

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.

structId?

readonly optional structId?: number

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

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.

window?

readonly optional window?: PageWindow

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

The part of the page the item may paint, when it is cut off — a spreadsheet’s drawing printed in pieces, each piece seen only over the rows and columns of its own page (TableOverlay). Top-left frame, like the item itself. Items sharing a window paint together, in their own order, after the rest of their layer.

z?

readonly optional z?: number

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

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