Struct Paragraph 

pub struct Paragraph { /* private fields */ }

The retained paragraph, with Skia’s state tiers made explicit (SkParagraph’s kShaped/kWrapped/kFormatted ladder):

• ParagraphBuilder::build() runs the EXPENSIVE tier once — fallback segmentation + harfrust shaping — and retains it.
• layout(width) re-wraps and places from the retained shaping (cheap; cached when the width doesn’t change).
• update_color(span, color) re-places only (no reshape, no rewrap) — the text-editing hot path.

Cloning duplicates the shaped and laid-out data (no re-shaping) — a cheap way for hosts to snapshot a layout before re-wrapping in place.

Implementations

impl Paragraph

pub fn layout(&mut self, max_width: f32)

Wrap and place against max_width (f32::INFINITY = never wrap). Same width twice = cache hit; shaping is NEVER redone here.

pub fn update_color(&mut self, span: usize, color: Color)

The repaint tier: recolor one styled span and re-place — shaping and line breaks are untouched (color never moves a glyph).

pub fn lines(&self) -> &[Line]

Placed lines of the most recent layout (empty before one).

pub fn width(&self) -> f32

Widest line’s content width after layout.

pub fn advance(&self) -> f32

How far the pen actually travelled — the widest line’s signed advance.

This is NOT Paragraph::width. A width is a layout box, so it has a floor at zero: wrapping, alignment and bounds() are all defined on a rectangle, and one narrower than nothing means nothing. An advance has no such floor. Letter and word spacing tighter than the glyphs are wide walks the pen backwards, and callers that report a pen position rather than a box — Canvas2D’s TextMetrics.width — need the negative.

pub fn last_glyph_origin(&self) -> Option<f32>

Paragraph-local pen x of the last glyph placed, or None when nothing was placed at all. Distinct from the advance whenever that last glyph carries one of its own.

pub fn height(&self) -> f32

pub fn ink_bounds(&self) -> Option<Rect>

Tight visible ink bounds in paragraph coordinates. Vector glyphs use Bézier extrema; color/bitmap glyphs use their non-transparent pixels. This deliberate slower query path is for Canvas-style text metrics; frame recording keeps using precomputed conservative run bounds.

pub fn primary_font(&self) -> Option<(&Font, f32)>

Primary face and size even when the paragraph contains no glyphs.

pub fn bounds(&self) -> Rect

pub fn truncated(&self) -> bool

max_lines dropped content (what an ellipsis marks).

pub fn min_intrinsic_width(&self) -> f32

Widest unbreakable segment — the narrowest useful layout width.

pub fn max_intrinsic_width(&self) -> f32

Width when nothing wraps (widest hard-break line).

pub fn longest_line(&self) -> f32

Widest laid-out line’s content width.

impl Paragraph

pub fn text(&self) -> &str

pub fn demand(&self) -> &FontDemand

What this paragraph could not resolve (families and codepoints no source answered) — a host fetches them and re-registers.

pub fn faces(&self) -> &FaceSet

The faces this paragraph resolved (decoration metrics, glyph lookup at record time).

pub fn line_metrics(&self) -> Vec<LineMetrics>

pub fn caret_for_offset(&self, offset: usize) -> Rect

The caret rectangle (zero width) for a byte offset — the leading edge of the cluster at offset, or the trailing edge of the last cluster before it.

pub fn glyph_position_at(&self, p: Point) -> PositionWithAffinity

The text position under a point (SkParagraph’s getGlyphPositionAtCoordinate): nearest line by y, nearest cluster edge by x.

pub fn rects_for_range(&self, range: Range<usize>) -> Vec<Rect>

Selection boxes for a byte range: one rect per (line, run) span — bidi ranges yield multiple boxes naturally, like SkParagraph’s getRectsForRange.

pub fn word_boundary(&self, offset: usize) -> Range<usize>

The word containing offset (UAX #29 word boundaries).

Trait Implementations

impl Clone for Paragraph

fn clone(&self) -> Paragraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.