Struct RenderedRegion 

#[non_exhaustive]
pub struct RenderedRegion {
    pub field: String,
    pub page: usize,
    pub rect: [f32; 4],
    pub span: Option<[usize; 2]>,
}

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; the field_boxes helper (and LiveSession::field_boxes) owns that union so consumers need not reimplement it.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

field: String

The field’s plate-space schema address as the backend keys it: "signature_block" or "$cards.<kind>.<ordinal>.<field>" (a per-kind ordinal). This is the backend-native form; a binding that owns the document’s card kinds translates it to a canonical DocPath at its boundary (plate_addr_to_doc_path), so its consumers see one absolute-index grammar. A core consumer reading RenderedRegion directly sees the plate-space form.

page: usize

0-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

impl RenderedRegion

pub fn new(field: String, page: usize, rect: [f32; 4]) -> RenderedRegion

A geometry entry with no content address: a scalar reference site or a widget. Content ink adds its slice with with_span.

pub fn with_span(self, span: [usize; 2]) -> RenderedRegion

Set span, the USV [start, end) this box covers.

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

impl Clone for RenderedRegion

fn clone(&self) -> RenderedRegion

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RenderedRegion

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RenderedRegion

fn deserialize<__D>( __deserializer: __D, ) -> Result<RenderedRegion, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RenderedRegion

fn eq(&self, other: &RenderedRegion) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for RenderedRegion

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RenderedRegion