Dragonfly Fonts

Wraps common font-related tasks into Dragonfly analysers and processors.

Add this line to your application's Gemfile:

gem 'dragonfly_fonts'

And then execute:

$ bundle

Or install it yourself as:

$ gem install dragonfly_fonts

You will need FontForge with Python extensions installed.

Using Homebrew:

$ brew install fontforge --enable-pyextension

Using debian/ubuntu packages:

$ sudo apt-get install fontforge python-fontforge

See fonttools

See ots-sanitize

See ttf2eot.

See ttfautohint.

See woff2.

Add the :fonts plugin to your Dragonfly config block:

Dragonfly.app.configure do
  plugin :fonts
end

List of supported formats is available as:

DragonflyFonts::SUPPORTED_FORMATS # => ["bdf", "dfont", "bin", …]
DragonflyFonts::SUPPORTED_OUTPUT_FORMATS # => ["eot", "ttf", …]

Returns Struct.new("Bbox", :glyph, :min_x, :min_y, :max_x, :max_y, :width, :height) representing the glyph's bounding box.

DragonflyFonts::Analysers::Bbox.new.call(font, glyph)

Returns information about the font as a Hash with the following keys: :ascent, :cap_height, :comment, :copyright, :default_base_filename, :descent, :descriptor, :designer, :designer_url, :em, :embedding_restrictions, :encoding, :familyname, :fontlog, :fontname, :fullname, :license, :license_url, :path, :sfnt_revision, :trademark, :upos, :uwidth, :vendor_url, :version, :weight, :woff_metadata, :woff_revision, :x_height.

font.font_info

Returns Array of all glyphs contained in the font, each glyph represented by a Hash with the following keys: :glyphclass, :glyphname, :encoding, :script, :width, :unicode.

font.glyphs

Returns Array of gsub tables in the font.

font.gsub_tables

Displays output of the ots-sanitize command.

font.ots_sanitize

Normalizes ascent and descent values.

font.correct_metrics

Allows for conversion to EOT, OTF, SVG, TTF, WOFF, WOFF2, TTX.

font.encode(:woff)

• OTF, SVG, TTF, WOFF conversion is handled by FontForge.
• EOT conversion is handled by ttf2eot. The input font needs to be in TTF format. Due to bug in IE, font FullName MUST begin with FamilyName. For example, if FamilyName is fontello, then FullName should be fontello regular and so on. In this condition is not satisfyed, then font will not be shown in IE.
• WOFF2 conversion is handled by woff2.
• TTX conversion is handled by ttx (fonttools).

Extracts specified glyph in SVG format.

font.extract_glyph('A')

Fix for DFLT tables causing issues in Firefox 44.

font.fix_dflt_table

Fix for rejected EOT's in IE8.

font.normalize_names

Sanitize OTF/TTF & WOFF/2 font files.

font.ots_sanitize!

Adjust ascent & descent by an increment of.

font.set_dimensions(ascent: 10, descent: -10)

Allows to set the following TTF properties: :compatible_full, :copyright, :description, :designer, :designer_url, :fontname, :fullname, :license, :license_url, :manufacturer, :postscript_cid, :postscript_name, :preferred_family, :preferred_subfamily, :sample_text, :trademark, :uid, :vendor_url, :version, :weight. See docs at Adobe for more details.

ttf_names = { designer: 'John Doe' }
font.set_ttf_names(ttf_names)

Allows to set underline properties: position and width.

font.set_underline({ upos: 1, uwidth: 1 })

Sets width of each character. The relative parameter can have the following values:

• when 0 the vertical width will be set exactly to width value
• when 1 then the vertical width will be incremented by width value
• when 2 then the vertical width will be scaled by width value/100.0.

font.set_width(width, relative=1)

Converts font to WOFF and sets license-related values of embedded XML metadata. The rest of the metadata is automatically inferred from font properties (see #set_ttf_names).

font.set_woff_metadata(uniqueid, licensee_name)

Generates FreeType auto hints. See ttfautohint.

font.ttf_autohint

Make web friendly.

font.web_friendly

1. Fork it ( https://github.com/tomasc/dragonfly_fonts/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request