Struct rusttype::PositionedGlyph

pub struct PositionedGlyph<'a> { /* fields omitted */ }

A glyph augmented with positioning and scaling information. You can query such a glyph for information that depends on the scale and position of the glyph.

Methods

impl<'a> PositionedGlyph<'a>

pub fn id(&self) -> GlyphId

The glyph identifier for this glyph.

pub fn font(&self) -> Option<&Font<'a>>

The font to which this glyph belongs. If the glyph is a standalone glyph that owns its resources, it no longer has a reference to the font which it was created from (using standalone()). In which case, None is returned.

pub fn unpositioned(&self) -> &ScaledGlyph<'a>

A reference to this glyph without positioning

pub fn into_unpositioned(self) -> ScaledGlyph<'a>

Removes the positioning from this glyph

pub fn pixel_bounding_box(&self) -> Option<Rect<i32>>

The conservative pixel-boundary bounding box for this glyph. This is the smallest rectangle aligned to pixel boundaries that encloses the shape of this glyph at this position. Note that the origin of the glyph, at pixel-space coordinates (0, 0), is at the top left of the bounding box.

pub fn shape(&self) -> Option<Vec<Contour>>

Similar to ScaledGlyph::shape(), but with the position of the glyph taken into account.

pub fn scale(&self) -> Scale

pub fn position(&self) -> Point<f32>

pub fn draw<O>(&self, o: O) where
    O: FnMut(u32, u32, f32), 

Rasterises this glyph. For each pixel in the rect given by pixel_bounding_box(), o is called:

o(x, y, v)

where x and y are the coordinates of the pixel relative to the min coordinates of the bounding box, and v is the analytically calculated coverage of the pixel by the shape of the glyph. Calls to o proceed in horizontal scanline order, similar to this pseudo-code:

let bb = glyph.pixel_bounding_box();
for y in 0..bb.height() {
    for x in 0..bb.width() {
        o(x, y, calc_coverage(&glyph, x, y));
    }
}

pub fn standalone(&self) -> PositionedGlyph<'static>

Constructs a glyph that owns its data from this glyph. This is similar to Glyph::standalone. See that function for more details.

pub fn set_position(&mut self, p: Point<f32>)

Resets positioning information and recalculates the pixel bounding box

Trait Implementations

impl<'_> Debug for PositionedGlyph<'_>

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

Formats the value using the given formatter.

impl<'a> Clone for PositionedGlyph<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.