Struct TextItem 

pub struct TextItem {
    text: String,
    em_size: f64,
    font: TextFont,
    fill_rgbas: AlphaColor<Srgb>,
    stroke_rgbas: AlphaColor<Srgb>,
    stroke_width: f32,
    items: OnceLock<Vec<VItem>>,
    inline_length_em: OnceLock<f64>,
}

Available on crate feature typst only.

Simple single-line text item

Fields

text: String

Text content

em_size: f64

Intrinsic em size in local coordinates.

font: TextFont

Font info

fill_rgbas: AlphaColor<Srgb>

Fill color

stroke_rgbas: AlphaColor<Srgb>

Stroke color

stroke_width: f32

Stroke width

items: OnceLock<Vec<VItem>>

Cached items

inline_length_em: OnceLock<f64>

cached text inline size

Implementations

impl TextItem

pub fn new(text: impl Into<String>, em_size: f64) -> Self

Create a new text item

pub fn with_font(self, font: TextFont) -> Self

Set font

pub fn font(&self) -> &TextFont

Get font

pub fn em_size(&self) -> f64

Get intrinsic em size.

pub fn basis(&self) -> (DVec3, DVec3)

Get the canonical local basis.

pub fn text(&self) -> &str

Get text

pub fn inline_length_em(&self) -> f64

Get inline length in em units

pub fn text_box(&self) -> Parallelogram

Returns the canonical local text outline box from the baseline origin.

Positioning and orientation are supplied by Transformed<TextItem, G>.

fn generate_items(&self) -> Vec<VItem>

pub fn vitems(&self) -> &[VItem]

Borrow the canonical local outlines, generating and caching them on first use.

fn transform_items(&mut self, transformation: impl FnOnce(&mut Vec<VItem>))

Trait Implementations

impl Aabb for TextItem

fn aabb(&self) -> [DVec3; 2]

Get the Axis-aligned bounding box represent in [<min>, <max>].

fn aabb_size(&self) -> DVec3

Get the size of the Aabb.

fn aabb_center(&self) -> DVec3

Get the center of the Aabb.

impl Clone for TextItem

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 TextItem

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

Formats the value using the given formatter.

impl Extract for TextItem

fn extract(&self, ctx: &mut ExtractContext<'_>)

Synchronize this value’s render-world outputs.

impl FillColor for TextItem

fn fill_color(&self) -> AlphaColor<Srgb>

Getting fill color of an item

fn set_fill_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting fill color(rgba) of an item

fn set_fill_opacity(&mut self, opacity: f32) -> &mut Self

Setting fill opacity of an item

impl From<TextItem> for Vec<VItem>

fn from(item: TextItem) -> Self

Converts to this type from the input type.

impl Locate<TextItem> for Origin

fn locate(&self, _target: &TextItem) -> DVec3

Locate self on the target

impl StrokeColor for TextItem

fn stroke_color(&self) -> AlphaColor<Srgb>

Getting stroke color of an item

fn set_stroke_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting stroke color(rgba) of an item

fn set_stroke_opacity(&mut self, opacity: f32) -> &mut Self

Setting stroke opacity of an item