Struct DrawGlyphs 

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

Builder for encoding a glyph run.

Created using Scene::draw_glyphs.

Implementations

impl<'a> DrawGlyphs<'a>

pub fn new(scene: &'a mut Scene, font: &FontData) -> Self

Creates a new builder for encoding a glyph run for the specified encoding with the given font.

pub fn transform(self, transform: Affine) -> Self

Sets the global transform. This is applied to all glyphs after the offset translation.

The default value is the identity matrix.

pub fn glyph_transform(self, transform: Option<Affine>) -> Self

Sets the per-glyph transform. This is applied to all glyphs prior to offset translation. This is common used for applying a shear to simulate an oblique font.

The default value is None.

pub fn brush_transform(self, transform: Option<Affine>) -> Self

Sets the transform applied to the brush contents.

This is applied after the global run transform and is encoded as the glyph run’s paint transform. It affects transformed brushes such as gradients and images; solid colors ignore it.

The default value is None.

pub fn font_size(self, size: f32) -> Self

Sets the font size in pixels per em units.

The default value is 16.0.

pub fn font_embolden(self, embolden: FontEmbolden) -> Self

Sets synthetic embolden settings.

pub fn hint(self, hint: bool) -> Self

Sets whether to enable hinting.

The default value is false.

pub fn normalized_coords(self, coords: &[NormalizedCoord]) -> Self

Sets the normalized design space coordinates for a variable font instance.

pub fn brush(self, brush: impl Into<BrushRef<'a>>) -> Self

Sets the brush.

The default value is solid black.

pub fn brush_alpha(self, alpha: f32) -> Self

Sets an additional alpha multiplier for the brush.

The default value is 1.0.

pub fn draw( self, style: impl Into<StyleRef<'a>>, glyphs: impl Iterator<Item = Glyph>, )

Encodes a fill or stroke for the given sequence of glyphs and consumes the builder.

The style parameter accepts either Fill or Stroke types.

This supports emoji fonts in COLR and bitmap formats. style is ignored for these fonts.

For these glyphs, the given brush is used as the “foreground color”, and should be Solid for maximum compatibility.