Struct FontBuilder

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

Build a font from some set of tables.

Implementations

impl<'a> FontBuilder<'a>

pub fn new() -> Self

Create a new builder to compile a binary font

pub fn add_table<T>(&mut self, table: &T) -> Result<&mut Self, BuilderError>

where T: FontWrite + Validate + TopLevelTable,

Add a table to the builder.

The table can be any top-level table defined in this crate. This function will attempt to compile the table and then add it to the builder if successful, returning an error otherwise.

pub fn add_raw(&mut self, tag: Tag, data: impl Into<Cow<'a, [u8]>>) -> &mut Self

A builder method to add raw data for the provided tag

pub fn copy_missing_tables(&mut self, font: FontRef<'a>) -> &mut Self

Copy each table from the source font if it does not already exist

pub fn contains(&self, tag: Tag) -> bool

Returns true if the builder contains a table with this tag.

pub fn ordered_tags(&self) -> Vec<Tag>

Returns the builder’s table tags in the order recommended by the OpenType spec.

Table tags not in the recommended order are sorted lexicographically, and ‘DSIG’ is always sorted last. The presence of the ‘CFF ’ table determines which of the two recommended orders is used. This matches fontTools’ sortedTagList function.

See: https://learn.microsoft.com/en-us/typography/opentype/spec/recom#optimized-table-ordering https://github.com/fonttools/fonttools/blob/8d6b2f8f87637fcad8dae498d32eae738cd951bf/Lib/fontTools/ttLib/ttFont.py#L1096-L1117

pub fn build(&mut self) -> Vec<u8>

Assemble all the tables into a binary font file with a Table Directory.

Trait Implementations

impl<'a> Clone for FontBuilder<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FontBuilder<'a>

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

Formats the value using the given formatter.

impl<'a> Default for FontBuilder<'a>

fn default() -> FontBuilder<'a>

Returns the “default value” for a type.