Module: HarfBuzz::Subset

Defined in:

lib/harfbuzz/subset.rb,
lib/harfbuzz/c/subset.rb

Overview

Font subsetting API (requires libharfbuzz-subset)

Defined Under Namespace

Modules: C Classes: Input, Plan

Class Method Summary

• .available? ⇒ Boolean

  True if libharfbuzz-subset is available.

• .subset(face, input) ⇒ HarfBuzz::Face

  Subsets a font face using the given input specification.

Class Method Details

.available? ⇒ Boolean

Returns true if libharfbuzz-subset is available.

Returns:

• (Boolean) —

  true if libharfbuzz-subset is available

# File 'lib/harfbuzz/subset.rb', line 7

def self.available?
  C.available?
end

.subset(face, input) ⇒ HarfBuzz::Face

Subsets a font face using the given input specification

Parameters:

• face (HarfBuzz::Face) —

  Source font face

• input (Input) —

  Subset input specification

Returns:

• (HarfBuzz::Face) —

  Subsetted face

Raises:

• (UnavailableError) —

  If subset library is not available

• (SubsetError) —

  If subsetting fails

# File 'lib/harfbuzz/subset.rb', line 17

def self.subset(face, input)
  raise UnavailableError, "libharfbuzz-subset is not available" unless available?

  ptr = C.hb_subset_or_fail(face.ptr, input.ptr)
  raise SubsetError, "Subsetting failed" if ptr.null?

  HarfBuzz::Face.wrap_owned(ptr)
end