https://github.com/tomasc/dragonfly_harfbuzz
Harfbuzz renderer wrapped by Dragonfly processors.
https://github.com/tomasc/dragonfly_harfbuzz
Last synced: 1 day ago
JSON representation
Harfbuzz renderer wrapped by Dragonfly processors.
- Host: GitHub
- URL: https://github.com/tomasc/dragonfly_harfbuzz
- Owner: tomasc
- License: mit
- Created: 2014-11-29T14:41:14.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2019-01-26T16:55:10.000Z (over 7 years ago)
- Last Synced: 2026-05-07T23:34:55.182Z (about 1 month ago)
- Language: Ruby
- Homepage:
- Size: 477 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Dragonfly Harfbuzz
[](https://travis-ci.org/tomasc/dragonfly_harfbuzz) [](http://badge.fury.io/rb/dragonfly_harfbuzz) [](https://coveralls.io/r/tomasc/dragonfly_harfbuzz)
[Harfbuzz](http://fontforge.github.io) renderer wrapped by [Dragonfly](http://markevans.github.io/dragonfly) processors.
## Installation
Add this line to your application's Gemfile:
gem 'dragonfly_harfbuzz'
And then execute:
$ bundle
Or install it yourself as:
$ gem install dragonfly_harfbuzz
You will also need Harfbuzz installed.
Using [Homebrew](http://brew.sh):
$ brew install --with-cairo harfbuzz
Or build from source. See [Harfbuzz](http://harfbuzz.org) website for instructions.
## Usage
Add the `:harfbuzz` plugin to your Dragonfly config block:
```ruby
Dragonfly.app.configure do
plugin :harfbuzz
# ...
end
```
Then use as:
```ruby
font.hb_view('my text', :svg, { font_size: 36 })
```
See tests and `hb-view --help-all` for more details on options.
## Supported Formats
List of supported formats is available as:
```ruby
DragonflyHarfbuzz::SUPPORTED_FORMATS # => ["otf"]
DragonflyHarfbuzz::SUPPORTED_OUTPUT_FORMATS # => ["ansi", "png", "svg", "pdf", "ps", "eps"]
```
## Options
Additionally (for `` only) you can pass the following options: `translate: Hash[x: 0, y: 0]`, `markup_svg: Boolean`, `split_paths: Boolean` and `flatten_svg: Boolean`.
`translate` translates glyph positions by specified `x` and/or `y` offset.
`markup_svg` returns an `` that is organized into word and characters and marked up with additional data attributes.
`flatten_svg` uses the result of `markup_svg` and further cleans up the ``, replacing the ``, `` elements with nested ``s. This is handy if you want to do some more precise animation/manipulation of the resulting ``.
`split_paths` is a feature of the `markup_svg` and controls whether the paths of each character are split up into smaller components.
## Contributing
1. Fork it ( https://github.com/tomasc/dragonfly_harfbuzz/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