Struct allsorts::tables::glyf::GlyfTable

source · [−]

pub struct GlyfTable<'a> {
    pub records: Vec<GlyfRecord<'a>>,
}

Expand description

glyf table

https://docs.microsoft.com/en-us/typography/opentype/spec/glyf

Fields

records: Vec<GlyfRecord<'a>>

Implementations

source

impl<'a> GlyfTable<'a>

source

pub fn subset(&self, glyph_ids: &[u16]) -> Result<SubsetGlyf<'a>, ParseError>

Returns a copy of this table that only contains the glyphs specified by glyph_ids.

source

impl<'a> GlyfTable<'a>

source

pub fn get_parsed_glyph(
&mut self,
glyph_index: u16
) -> Result<Option<&Glyph<'_>>, ParseError>

Returns a parsed glyph if present. Returns None if the GlyfRecord is Empty.

Trait Implementations

source

impl<'a> Debug for GlyfTable<'a>

source

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

Formats the value using the given formatter. Read more

source

impl<'a> OutlineBuilder for GlyfTable<'a>

type Error = ParseError

source

fn visit<V: OutlineSink>(
 &mut self,
 glyph_index: u16,
 visitor: &mut V
) -> Result<(), Self::Error>

Visit the glyph outlines in self.

source

impl<'a> PartialEq<GlyfTable<'a>> for GlyfTable<'a>

source

fn eq(&self, other: &GlyfTable<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==. Read more

1.0.0 · source

const fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more

source

impl<'a> ReadBinaryDep<'a> for GlyfTable<'a>

type Args = &'a LocaTable<'a>

type HostType = GlyfTable<'a>

source

fn read_dep(
ctxt: &mut ReadCtxt<'a>,
loca: Self::Args
) -> Result<Self, ParseError>

source

impl<'a> WriteBinaryDep<GlyfTable<'a>> for GlyfTable<'a>

source

fn write_dep<C: WriteContext>(
 ctxt: &mut C,
 table: GlyfTable<'a>,
 index_to_loc_format: IndexToLocFormat
) -> Result<Self::Output, WriteError>

Write this glyf table into ctxt.

A Note About Padding

On the loca table documentation at the bottom it states:

Note that the local offsets should be 32-bit aligned. Offsets which are not 32-bit aligned may seriously degrade performance of some processors.

On the Recommendations for OpenType Fonts page it states:

We recommend that local offsets should be 16-bit aligned, in both the short and long formats of this table.

On Apple’s loca documentation it says:

The glyph data is always word aligned.

Elsewhere in the Apple docs they refer to long as 32-bits, so assuming word here means 16-bits.

An issue was raised against Microsoft’s docs regarding this. Behdad Esfahbod commented:

All the requirements should be removed since 2019.

In reality, in the short format, you are forced to do 16-bit alignment because of how offsets are stored. In the long format, use alignment 1. We’ve been doing that in fonttools for years and never ever heard a complaint whatsoever.

So with this in mind we implement 16-bit alignment when index_to_loc_format is 0, and no alignment/padding otherwise.