pub struct RenderedRegion {
pub field: String,
pub page: usize,
pub rect: [f32; 4],
pub span: Option<[usize; 2]>,
}Expand description
One schema field placement’s extent on a rendered page.
rect is [x0, y0, x1, y1] in PDF points with a bottom-left origin —
the same final geometry the stamp spine writes to the widget /Rect, so the
region and the rendered field describe the identical box.
field is not unique within the Vec that
LiveSession::regions returns: a content
field breaks into one entry per segment (paragraph, heading, whole code
fence) and per page each segment touches, a scalar referenced at several
plate sites yields one per site, and tracked content plus a bound widget
yields both. Consumers group by field; every entry routes to that field.
The whole-field box is derived — the union of a page’s span-bearing
segment rects, so inter-paragraph whitespace stays uncovered (#829); the
field_boxes helper (and
LiveSession::field_boxes) owns that
union so consumers need not reimplement it.
Fields§
§field: StringQuill schema field path, e.g. "signature_block" or
"$cards.indorsement.1.from" — the author-facing field address (the
card form is kind + 0-based ordinal, $cards.<kind>.<n>.<field>), not
any backend widget name.
page: usize0-based page index.
rect: [f32; 4][x0, y0, x1, y1], PDF points, bottom-left origin.
span: Option<[usize; 2]>The content slice this box covers: USV [start, end) into the field’s
Content for content ink (one segment’s range), None for a scalar
reference site or a widget — geometry with no content address. Additive
and optional: omitted from the wire when None.
Implementations§
Source§impl RenderedRegion
impl RenderedRegion
Sourcepub fn contains(&self, page: usize, x: f32, y: f32) -> bool
pub fn contains(&self, page: usize, x: f32, y: f32) -> bool
Whether the point (x, y, PDF points, bottom-left origin) on page
falls inside this region, edges inclusive. The one point-in-region
predicate every field_at hit-test shares, so a click at a region
border resolves identically everywhere.
Trait Implementations§
Source§impl Clone for RenderedRegion
impl Clone for RenderedRegion
Source§fn clone(&self) -> RenderedRegion
fn clone(&self) -> RenderedRegion
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more