Struct Text 

pub struct Text {
    pub position: Point,
    pub content: String,
    pub height: f64,
    pub rotation: f64,
    pub halign: HAlign,
    pub valign: VAlign,
}

Text annotation. Height is the cap-to-descender line height in model units.

Fields

position: Point

Insertion point.

content: String

UTF-8 content; \n separates lines.

height: f64

Text height in model units.

rotation: f64

Rotation in radians.

halign: HAlign

Horizontal alignment.

valign: VAlign

Vertical alignment.

Implementations

impl Text

pub const LINE_SPACING: f64 = 1.2

Line spacing relative to height.

pub const TOP_ABOVE_BASELINE: f64 = 0.8

Top of the text block above the first baseline (relative to height) for Top, Middle and Bottom alignment — the renderer’s layout contract.

pub const FONT_UNITS_PER_EM: f64 = fm::UNITS_PER_EM

Font units per em of the renderer’s default font (the unit of Text::line_pens).

pub fn em_size(height: f64) -> f64

Model units per em for text of height (for renderers that place glyph outlines with Text::line_pens).

pub fn line_pens(line: &str) -> (Vec<(char, f64)>, f64)

Pen positions of one line laid out with the renderer’s default font: each drawn character (after the renderer’s substitutions: tabs and no-break spaces become spaces, control characters are dropped) with its pen position in font units from the line start — advance widths plus pair kerning — and the line’s total advance in font units. The renderer places glyphs with exactly these positions, so drawn text and Text::layout_box agree.

pub fn line_width(line: &str, height: f64) -> f64

Advance width of one line in model units, measured with the renderer’s default font (advance widths and pair kerning — exactly how it is drawn). Tabs count as spaces; control characters are skipped.

pub fn layout_box(&self) -> Aabb

Layout box (before rotation) relative to position: each line’s advance width with its alignment, from the ascender of the first line to the descender of the last. Matches the renderer’s layout of the default font.

pub fn layout_corners(&self) -> [Point; 4]

The four corners of the layout box in model space.

Trait Implementations

impl Clone for Text

fn clone(&self) -> Text

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Text

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Text

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Text

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Text

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Text