Struct allsorts::cff::CFF

source · [−]

pub struct CFF<'a> {
    pub header: Header,
    pub name_index: Index<'a>,
    pub string_index: MaybeOwnedIndex<'a>,
    pub global_subr_index: Index<'a>,
    pub fonts: Vec<Font<'a>>,
}

Expand description

Top level representation of a CFF font file, typically read from a CFF OpenType table.

Refer to Technical Note #5176

Fields

header: Headername_index: Index<'a>string_index: MaybeOwnedIndex<'a>global_subr_index: Index<'a>fonts: Vec<Font<'a>>

Implementations

impl<'a> CFF<'a>

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

glpyh_ids contains the ids of the glyphs to retain. When subsetting a Type 1 CFF font and retaining more than 255 glyphs the convert_cff_to_cid_if_more_than_255_glyphs argument controls whether the Type 1 font is converted to a CID keyed font in the process. The primary motivation for this is broader compatibility, especially if the subset font is embedded in a PDF.

Known Limitations

Currently the subsetting process does not produce the smallest possible output font. There are various parts of the source font that are copied to the output font as-is. Specifically the subsetting process does not subset the String INDEX, or the Local or Global subroutines.

Subsetting the String INDEX requires updating all String IDs (SID) in the font so that they point at their new position in the String INDEX. Subsetting the subroutines requires parsing the CharStrings, which describe the glyph outlines. The CharStrings format is non-trivial so this has been left for now.

impl<'a> CFF<'a>

pub fn read_string(&self, sid: u16) -> Result<String, ParseError>

Read a string with the given SID from the String INDEX

Trait Implementations

impl<'a> Clone for CFF<'a>

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

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

impl<'a> From<SubsetCFF<'a>> for CFF<'a>

fn from(subset: SubsetCFF<'a>) -> CFF<'a>

Converts to this type from the input type.

impl<'a> OutlineBuilder for CFF<'a>

type Error = CFFError

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

Visit the glyph outlines in self.

impl<'a> ReadBinary<'a> for CFF<'a>

type HostType = CFF<'a>

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

impl<'a> WriteBinary<&CFF<'a>> for CFF<'a>

type Output = ()

The type of the value returned by write.

fn write<C: WriteContext>(ctxt: &mut C, cff: &CFF<'a>) -> Result<(), WriteError>

Write the binary representation of Self to ctxt.

Auto Trait Implementations

impl<'a> RefUnwindSafe for CFF<'a>

impl<'a> Send for CFF<'a>

impl<'a> Sync for CFF<'a>

impl<'a> Unpin for CFF<'a>

impl<'a> UnwindSafe for CFF<'a>

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<'a, T> ReadBinaryDep<'a> for T where
T: ReadBinary<'a>,

type Args = ()

type HostType = <T as ReadBinary<'a>>::HostType

fn read_dep(
ctxt: &mut ReadCtxt<'a>,
<T as ReadBinaryDep<'a>>::Args
) -> Result<<T as ReadBinaryDep<'a>>::HostType, ParseError>

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T, HostType> WriteBinaryDep<HostType> for T where
T: WriteBinary<HostType>,

type Args = ()

The type of the arguments supplied to write_dep.

type Output = <T as WriteBinary<HostType>>::Output

The type of the value returned by write_dep.

fn write_dep<C>(
    ctxt: &mut C,
    val: HostType,
    <T as WriteBinaryDep<HostType>>::Args
) -> Result<<T as WriteBinaryDep<HostType>>::Output, WriteError> where
    C: WriteContext,

Write the binary representation of Self to ctxt.