Struct rin_gl::Ttf

pub struct Ttf { /* fields omitted */ }

Implementations

impl Ttf

pub fn line_height(&self) -> f32

distance between baselines

pub fn ascender(&self) -> f32

distance between baseline and top of highest character in the font

pub fn descender(&self) -> f32

distance between the baseline and bottom of the lowest character in the font

pub fn line_gap(&self) -> f32

distance between the bottom of the lowest character in the font and the top of the highest character if they were put in consecutive lines. separation between 2 lines

pub fn gamma(&self) -> f32

level of antialiasing, this value should be read by renderers and applied on rendering, doesn’t affect the loaded glyphs, default is 1.0

pub fn antialiasing_type(&self) -> Antialiasing

returns the type of antialiasing of this font

pub fn mesh(
    &self,
    string: &str,
    pos: &Pnt2,
    coordinate_origin: CoordinateOrigin
) -> Mesh<Vertex2DTex>

returns the mesh for the string passed, put this mesh in a vao when drawing the same text for a long time or use a renderer draw_string function if it changes very often

pub fn bounding_box(
    &self,
    string: &str,
    pos: &Pnt2,
    coordinate_origin: CoordinateOrigin
) -> Rect<f32>

returns the bounding box of a text drawn from a mesh returned by like the mesh function like gl::draw_string or other renderers do

pub fn box_mesh<H>(
    &self,
    string: &str,
    pos: &Pnt2,
    w: BoxCoordinatesX,
    h: H,
    coordinate_origin: CoordinateOrigin,
    flags: BoxFlags
) -> BoxMesh<Vertex2DTex> where
    H: Into<Option<BoxCoordinatesY>>, 

returns the mesh of a text so it fits in a box of the size and position passed as parameters, if h is some height, it will stop drawing the text before the next line overflows the specified height. Otherwise it won’t adjust for height

pub fn box_size(&self, string: &str, w: BoxCoordinatesX) -> Vec2

returns the total height of a box of text with width w

pub fn next_pos(
    &self,
    string: &str,
    pos: &Pnt2,
    coordinate_origin: CoordinateOrigin
) -> Pnt2

returns the position where a text should be drawn to correctly appear next to the one passed as parameter. the kerning with the next character is of course not added since we don’t know which will be that next character yet, and should be added when rendering the next string

pub fn shape_iter<'a>(
    &'a self,
    string: &'a str,
    pos: &'a Pnt2,
    coordinate_origin: CoordinateOrigin
) -> impl Iterator<Item = Shape> + 'a

useful for advanced layout, calls back the f closure for each glyph passing the bottom left and top right corners where it should be drawn after applying kerning and the glyph itself which contains information like it’s ascendent, descendent, offset, width… http://www.freetype.org/freetype2/docs/tutorial/step2.html#section-1

pub fn box_shape_iter<'a, H>(
    &'a self,
    string: &'a str,
    pos: &Pnt2,
    w: BoxCoordinatesX,
    h: H,
    coordinate_origin: CoordinateOrigin,
    flags: BoxFlags
) -> impl Iterator<Item = Shape> + 'a where
    H: Into<Option<BoxCoordinatesY>> + 'a, 

useful for advanced box layout, calculates the layout of text fitted in a box of w x h and calls back the f closure for each word passing the x and y coordinates where it should be drawn, combined with shape it can be used to calculate the layout for each glyph on the text. returns the final height of the bounding box for the resulting text

pub fn texture(&self) -> Ref<'_, Texture>

pub fn material<C: ToRgba>(&self, color: &C) -> Material

pub fn material_no_color(&self) -> Material

pub fn texture_for(context: &CreationProxy, ttf: &Ttf) -> Result<Texture>