Build Status

A ruby implementation of ESC/POS (thermal) printer image command specification.

Add this lines to your application's Gemfile:

gem 'escpos-image'

# Depending on chosen image processor
gem 'mini_magick'
# or
gem 'chunky_png'

And then execute:

$ bundle

Or install it yourself as:

$ gem install escpos-image

And then depending on chosen image processor

$ gem install mini_magick

or

$ gem install chunky_png

@printer = Escpos::Printer.new

# Creating image from path
image = Escpos::Image.new 'path/to/image.png', {
  processor: "ChunkyPng" # or MiniMagick
  # ... other options, see following sections
}

# The ChunkyPng processor requires the chunky_png gem installed
# The MiniMagick processor requires the mini_magick gem installed

# The constructor accepts an instance of:
# - String (path to image)
# - File
# - ChunkyPNG::Image
# - MiniMagick::Image

@printer << image

@printer.to_escpos # returns ESC/POS data ready to be sent to printer
# on linux this can be piped directly to /dev/usb/lp0
# with network printer sent directly to printer socket
# with serial port printer it can be sent directly to the serial port

@printer.to_base64 # returns base64 encoded ESC/POS data

When using ChunkyPng processor, chunky_png gem has to be installed or added to the Gemfile and when using MiniMagick processor, mini_magick gem has to be installed or added to the Gemfile, this makes the gem more lightweight by making dependencies optional and based on chosen image processor.

All options in the following section are optional and opt-in. By default we only take the RGB value from each pixel, average the sum of the components and make the resulting pixel black if the average is under or equal to 128 and white if it is 129 and up.

Bug reports and pull requests are welcome on GitHub at https://github.com/escpos/escpos-image.

1. Fork it ( https://github.com/escpos/escpos-image/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