Struct TextSpanInfo 

pub struct TextSpanInfo {

    pub text: String,
    pub x: f64,
    pub y: f64,
    pub width: f64,
    pub height: f64,
    pub font_size: f64,
    pub font_name: Option<String>,
    pub is_bold: bool,
    pub is_italic: bool,
    pub color: Option<[f32; 3]>,
    pub width_source: WidthSource,
    pub char_bounds: Vec<[f64; 4]>,
    pub transform: Option<[f64; 6]>,
    pub font_weight: Option<u16>,
    pub is_serif: Option<bool>,
    pub is_monospace: Option<bool>,
    pub render_mode: Option<u8>,
    pub font_metrics: Option<FontMetrics>,
}

A positioned text span in PDF user space (origin bottom-left, y up).

JSON key renames mirror the established wire contract consumed by the editor; all optional metadata is omitted from JSON when absent, so existing clients are unaffected.

Fields

text: String

The extracted text of the span.

x: f64

X position in PDF user space.

y: f64

Y position in PDF user space (baseline origin).

width: f64

Span width in user space. Falls back to an estimate (½ em per character) when no measured width is available.

height: f64

Span height in user space.

Mirrors the existing wire contract, which reports the font size (ascent extent) here. NOTE: this preserves prior behaviour exactly; richer ascent/descent metrics arrive in a later milestone.

font_size: f64

Font size in points.

font_name: Option<String>

PostScript font name with any 6-character subset prefix stripped. Omitted from JSON when unknown.

is_bold: bool

Inferred bold style.

is_italic: bool

Inferred italic style.

color: Option<[f32; 3]>

Fill colour as sRGB [r, g, b] normalised to 0.0–1.0. Omitted from JSON for pattern/shading paints.

width_source: WidthSource

Whether glyph widths came from real font metrics or an estimate. Serialised as "Metric" / "Estimate".

char_bounds: Vec<[f64; 4]>

Per-glyph bounding boxes [x0, y0, x1, y1] (y up). Omitted when empty.

transform: Option<[f64; 6]>

Full affine transform [a, b, c, d, e, f] of the span’s first glyph. Captures rotation/shear discarded by (x, y, fontSize).

font_weight: Option<u16>

Numeric font weight (~100–900) from embedded font data, if available.

is_serif: Option<bool>

Serif flag from embedded font data, if available.

is_monospace: Option<bool>

Monospace flag from embedded font data, if available.

render_mode: Option<u8>

Coarse PDF text render mode: 0 fill, 1 stroke, 3 invisible.

font_metrics: Option<FontMetrics>

Vertical font metrics (/1000 em) from the embedded font, if available.

Trait Implementations

impl Clone for TextSpanInfo

fn clone(&self) -> TextSpanInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextSpanInfo

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

Formats the value using the given formatter.

impl From<&TextSpan> for TextSpanInfo

fn from(s: &TextSpan) -> Self

Build the canonical wire form from a borrowed TextSpan (clones).

impl From<TextSpan> for TextSpanInfo

fn from(s: TextSpan) -> Self

Build the canonical wire form from an owned engine TextSpan.

Centralises the conversions that previously lived in each binding: the ½-em width fallback, the RGBA-u8 → RGB-f32 colour normalisation, and the height-reports-font-size contract.

impl Serialize for TextSpanInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.