Struct FontDesc

pub struct FontDesc<'a> { /* private fields */ }

Describes a font

Implementations

impl<'a> FontDesc<'a>

pub fn new(family: FontFamily<'a>, size: f64, style: FontStyle) -> Self

Create a new font

• family: The font family name
• size: The size of the font
• style: The font variations
• returns The newly created font description

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

Create a new font desc with the same font but different size

• size: The new size to set
• returns The newly created font descriptor with a new size

pub fn style(&self, style: FontStyle) -> Self

Set the style of the font

• style: The new style
• returns The new font description with this style applied

pub fn transform(&self, trans: FontTransform) -> Self

Set the font transformation

• trans: The new transformation
• returns The new font description with this font transformation applied

pub fn get_transform(&self) -> FontTransform

Get the font transformation description

pub fn color<C: Color>(&self, color: &C) -> TextStyle<'a>

Returns a new text style object with the specified color.

Example

use plotters::prelude::*;
let text_style = ("sans-serif", 20).into_font().color(&RED);
let drawing_area = SVGBackend::new("font_desc_color.svg", (200, 100)).into_drawing_area();
drawing_area.fill(&WHITE).unwrap();
drawing_area.draw_text("This is a big red label", &text_style, (10, 50));

The result is a text label colorized accordingly:

See also

IntoTextStyle::with_color()

IntoTextStyle::into_text_style() for a more succinct example

pub fn get_family(&self) -> FontFamily<'_>

Returns the font family

pub fn get_name(&self) -> &str

Get the name of the font

pub fn get_style(&self) -> FontStyle

Get the name of the style

pub fn get_size(&self) -> f64

Get the size of font

pub fn layout_box(&self, text: &str) -> FontResult<((i32, i32), (i32, i32))>

Get the size of the text if rendered in this font

For a TTF type, zero point of the layout box is the left most baseline char of the string Thus the upper bound of the box is most likely be negative

pub fn box_size(&self, text: &str) -> FontResult<(u32, u32)>

Get the size of the text if rendered in this font. This is similar to layout_box function, but it apply the font transformation and estimate the overall size of the font

pub fn draw<E, DrawFunc: FnMut(i32, i32, f32) -> Result<(), E>>( &self, text: &str, (x, y): (i32, i32), draw: DrawFunc, ) -> FontResult<Result<(), E>>

Actually draws a font with a drawing function

Trait Implementations

impl<'a> Clone for FontDesc<'a>

fn clone(&self) -> FontDesc<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> From<&'a str> for FontDesc<'a>

fn from(from: &'a str) -> FontDesc<'a>

Converts to this type from the input type.

impl<'a, T: Into<f64>> From<(&'a str, T)> for FontDesc<'a>

fn from((typeface, size): (&'a str, T)) -> FontDesc<'a>

Converts to this type from the input type.

impl<'a, T: Into<f64>, S: Into<FontStyle>> From<(&'a str, T, S)> for FontDesc<'a>

fn from((typeface, size, style): (&'a str, T, S)) -> FontDesc<'a>

Converts to this type from the input type.

impl<'a, T: Into<f64>> From<(FontFamily<'a>, T)> for FontDesc<'a>

fn from((family, size): (FontFamily<'a>, T)) -> FontDesc<'a>

Converts to this type from the input type.

impl<'a, T: Into<f64>, S: Into<FontStyle>> From<(FontFamily<'a>, T, S)> for FontDesc<'a>

fn from((family, size, style): (FontFamily<'a>, T, S)) -> FontDesc<'a>

Converts to this type from the input type.

impl<'a> From<FontFamily<'a>> for FontDesc<'a>

fn from(family: FontFamily<'a>) -> FontDesc<'a>

Converts to this type from the input type.

impl<'a> IntoTextStyle<'a> for FontDesc<'a>

fn into_text_style<P: HasDimension>(self, _: &P) -> TextStyle<'a>

Converts the value into a TextStyle value.

fn with_color<C: Color>(self, color: C) -> TextStyleBuilder<'a, Self>

where Self: Sized,

Specifies the color of the text element

fn with_anchor<C: Color>(self, pos: Pos) -> TextStyleBuilder<'a, Self>

where Self: Sized,

Specifies the position of the text anchor relative to the text element

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 88 bytes