Struct Axes 

pub struct Axes<'a> {
    records: &'a [VariationAxisRecord],
}

A collection of variation axes.

This is empty if the font is not variable.

Fields

records: &'a [VariationAxisRecord]

Implementations

impl<'a> Axes<'a>

pub(crate) fn new(font: &'a Font) -> Self

pub fn len(&self) -> u32

The number of axes.

pub fn is_empty(&self) -> bool

Returns true if the font has no axes.

pub fn get(&self, index: u32) -> Option<Axis>

Returns the axis at index.

pub fn get_by_tag(&self, tag: Tag) -> Option<Axis>

Returns the first axis with the given tag.

pub fn filter<V>( &self, variations: V, ) -> impl Iterator<Item = Variation> + Clone

where V: IntoIterator, V::Item: Into<Variation>,

Returns the values in variations that apply to these axes.

The rules are the same as those used when building a font instance:

• A variation for an axis the font does not have is dropped.
• If an axis is given more than once, the last value is used.
• Each value is clamped to the range of its axis.

The result is in the font’s axis order and contains only the axes that were given.

// For a font with one `wght` axis from 100 to 900:
let filtered: Vec<_> = font
    .axes()
    .filter([("wght", 400.0), ("opsz", 100.0), ("wght", 1200.0)])
    .collect();
assert_eq!(filtered, [Variation::new(Tag::new(b"wght"), 900.0)]);

pub fn iter(&self) -> impl Iterator<Item = Axis> + 'a + Clone

Returns an iterator over the axes in font order.

Trait Implementations

impl<'a> Clone for Axes<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Axes<'a>