Struct Text

#[non_exhaustive]
pub struct Text {
    pub pos: Vec2D,
    pub content: String,
    pub align: TextAlign,
    pub modifier: Modifier,
}

Displays text at the given position

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

pos: Vec2D

The position that the text is drawn from.

content: String

The actual text content of the element

align: TextAlign

How the content should align to the pos property

modifier: Modifier

A raw Modifier, determining the appearance of the Text

Implementations

impl Text

pub fn new(pos: Vec2D, content: &str, modifier: Modifier) -> Self

Create a new Text element with a position, content and modifier

Panics

This function will panic if the content contains a newline, as Text only works with single lines. For multi-line strings, see Sprite

Examples found in repository

examples/self-resizing.rs (line 19)

fn main() {
    let mut scale_view = ScaleFitView::new(ColChar::BACKGROUND);

    let mut text = Text::new(Vec2D::ZERO, "This is some centered text!", Modifier::None)
        .with_align(TextAlign::Centered);

    let mut sprite =
        Sprite::new(Vec2D::ZERO, TEXTURE, Modifier::None).with_align(TextAlign2D::CENTERED);

    loop {
        text.pos = scale_view.intended_size() / 2;
        sprite.pos = scale_view.intended_size() / 2;
        sprite.pos.y -= 5;

        scale_view.update();
        scale_view.view.draw(&text);
        scale_view.view.draw(&sprite);
        let _ = scale_view.view.display_render();

        sleep(Duration::from_millis(10));
    }
}

pub const fn with_align(self, align: TextAlign) -> Self

Return the Text with an updated align property. Consumes the original Text

Examples found in repository

examples/self-resizing.rs (line 20)

fn main() {
    let mut scale_view = ScaleFitView::new(ColChar::BACKGROUND);

    let mut text = Text::new(Vec2D::ZERO, "This is some centered text!", Modifier::None)
        .with_align(TextAlign::Centered);

    let mut sprite =
        Sprite::new(Vec2D::ZERO, TEXTURE, Modifier::None).with_align(TextAlign2D::CENTERED);

    loop {
        text.pos = scale_view.intended_size() / 2;
        sprite.pos = scale_view.intended_size() / 2;
        sprite.pos.y -= 5;

        scale_view.update();
        scale_view.view.draw(&text);
        scale_view.view.draw(&sprite);
        let _ = scale_view.view.display_render();

        sleep(Duration::from_millis(10));
    }
}

Trait Implementations

impl CanDraw for Text

fn draw_to(&self, canvas: &mut impl Canvas)

Draw the element to a struct that implements CanDraw

impl Clone for Text

fn clone(&self) -> Text

Returns a copy 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.