MultiEncoder
QRcode and Barcode generation for Rails apps. Saves resulting png's to the filesystem or as3. It includes a C extension that wraps the GNU Barcode project. For qrcode generation, it uses the [qrcode gem] (http://nycrb.rubyforge.org/qrencoder/), which in turn, wraps the libqrencode C library.
Installation
If you intend to generate QRCodes, you'll need to compile the C library libqrencode available [here] (http://megaui.net/fukuchi/works/qrencode/index.en.html).
curl http://fukuchi.org/works/qrencode/qrencode-3.2.0.tar.gz | tar xz
cd qrencode-3.2.0
./configure
make
sudo make install
You'll also need ImageMagick to generate the barcode png's.
Add this line to your application's Gemfile:
gem 'multi_encoder'
And then execute:
$ bundle
This will compile the gbarcode extension, included within.
Usage
<%= qrcode 'whasupbro' %>
<%= barcode 'notmuchmate' %>
Options
Barcodes
The <%= barcode %> heleper generates a barcode in BARCODE_128 format and accepts the following options:
width
height
scaling_factor
xoff
yoff
margin
Example:
<%= barcode width: 100, height: 30, xoff: 100 %>
The resulting PNG will be saved on the filesystem (or as3) and rendered into the view.
Configuration
There is nothing to configure if you want the resulting png's saved to the filesystem. This is the default. If you want to upload the images to AS3 you'll need to configure the sorage options, like so:
MultiEncoder::Storage.configure do |c|
c.destination = :aws
c.aws_bucket_prefix = SOME_PREFIX
c.aws_access_key = YOUR_ACCESS_KEY
c.aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
end
It is also possible to set these values as environment valiables
That's it, you are ready to go.
The gem will create buckets with the following names, depending on the Rails environment:
[prefix]-development-barcodes
[prefix]-development-qrcodes
and so on.
Licence
MIT