Prawn::Emoji

Build Status

Prawn::Emoji is an extention for Prawn, provides feature for drawing Emoji.

Installation

Add this line to your application's Gemfile:

gem 'prawn-emoji', require: false

And then execute:

$ bundle

Or install it yourself as:

$ gem install prawn-emoji

Usage

require 'prawn'
require 'prawn/emoji'

Prawn::Docment.generate 'foo.pdf' do
  font 'DejaVuSans.ttf'
  text 'I want to eat ๐Ÿฃ.'

  font 'ipag.ttf'
  text_box '๐ŸฃใŒ้ฃŸในใŸใ„', at: [100, 100], width: 300

  draw_text '๐Ÿฃ๐Ÿฃ๐Ÿฃ๐Ÿฃ๐Ÿฃ', at: [100, 200]
end

CAUTION

In order to draw emoji, you will need to use a TTF - True Type Font. I strongly recommended you use a Japanese font.

Feature

  • Over 1600 emoji support provided by Emoji One
  • RTL support
  • Character specing support
  • Rotation support
  • Alignment support
  • Font size support

Supported versions

  • Ruby 2.1, 2.2, 2.3
  • Prawn 1.3, 2.0.2

See https://travis-ci.org/hidakatsuya/prawn-emoji.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/hidakatsuya/prawn-emoji.

Credit

Emoji One

Emoji provided free by Emoji One.

IPA Font

IPA Font License Agreement v1.0

License

ยฉ 2015 Katsuya HIDAKA. See MIT-LICENSE for further details.