Struct Shaper

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

A configured shaper.

Implementations

impl<'a> Shaper<'a>

pub fn units_per_em(&self) -> i32

Returns font’s units per EM.

pub fn coords(&self) -> &'a [NormalizedCoord]

Returns the currently active normalized coordinates.

pub fn shape(&self, buffer: UnicodeBuffer, features: &[Feature]) -> GlyphBuffer

Shapes the buffer content using provided font and features.

Consumes the buffer. You can then run GlyphBuffer::clear to get the UnicodeBuffer back without allocating a new one.

If you plan to shape multiple strings, prefer shape_with_plan. This is because ShapePlan initialization is pretty slow and should preferably be called once for each shaping configuration.

pub fn shape_with_plan( &self, plan: &ShapePlan, buffer: UnicodeBuffer, features: &[Feature], ) -> GlyphBuffer

Shapes the buffer content using the provided font and plan.

Consumes the buffer. You can then run GlyphBuffer::clear to get the UnicodeBuffer back without allocating a new one.

It is up to the caller to ensure that the shape plan matches the properties of the provided buffer, otherwise the shaping result will likely be incorrect.

Panics

Will panic when debugging assertions are enabled if the buffer and plan have mismatched properties.

Trait Implementations

impl<'a> Clone for hb_font_t<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.