Struct ParagraphStyle 

pub struct ParagraphStyle { /* private fields */ }

Paragraph description: rich text, base style, width, alignment and optional fonts.

Shaping it yields a ParagraphLayout, the single intermediate representation behind static drawing, reveal effects and captions. Changing a shaping parameter gives a new cache; unchanged ones keep sharing the layout.

Implementations

impl ParagraphStyle

pub fn fit_lines( &self, max_lines: usize, fonts: &FontLibrary, ) -> Result<(Self, bool), ValidationError>

Precomputes a paragraph limited to 1..=512 lines, adding an ellipsis only when truncated. Returns the paragraph and whether source content was removed. Rich styles and extended grapheme boundaries are retained. The supplied font snapshot is frozen on the returned paragraph; no system discovery occurs. Preparation may reshape bounded suffix candidates and is not a frame-loop API.

pub fn layout( &self, fonts: &FontLibrary, ) -> Result<Arc<ParagraphLayout>, ValidationError>

Shapes once per paragraph description and font snapshot, returning actual line/ink metrics. Clones and equal descriptions share the result.

impl ParagraphStyle

pub fn new(text: impl Into<Arc<str>>) -> Self

Creates a paragraph of one inheriting span with size 24 and line height 1.3.

pub fn rich(spans: impl IntoIterator<Item = TextSpan>) -> Self

Creates rich spans, whose unset styles inherit paragraph defaults.

pub fn family(self, family: impl Into<Arc<str>>) -> Self

Selects an explicit family; empty uses the library’s generic default.

pub fn size(self, size: f64) -> Self

Sets finite logical size in (0,4096].

pub fn weight(self, weight: FontWeight) -> Self

Selects OpenType weight; variable weight participates in glyph identity.

pub fn line_height(self, height: f64) -> Self

Sets a positive relative line-height multiplier.

pub fn letter_spacing(self, spacing: f64) -> Self

Sets logical tracking, converted to em internally for shaping.

pub fn max_width(self, width: f64) -> Self

Wraps to finite positive logical width.

pub fn alignment(self, alignment: TextAlignment) -> Self

Selects bidirectional-aware paragraph alignment.

pub fn fonts(self, fonts: &FontLibrary) -> Self

Binds an explicit font snapshot, overriding a DrawContext environment.

Trait Implementations

impl Clone for ParagraphStyle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParagraphStyle

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

Formats the value using the given formatter.