https://github.com/willglynn/ruby-zbar

Ruby bindings for the ZBar barcode recognition library
https://github.com/willglynn/ruby-zbar

Last synced: 6 days ago
JSON representation

Ruby bindings for the ZBar barcode recognition library

• Host: GitHub
• URL: https://github.com/willglynn/ruby-zbar
• Owner: willglynn
• License: mit
• Created: 2010-08-30T00:28:53.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2022-10-19T10:57:02.000Z (about 2 years ago)
• Last Synced: 2024-12-23T12:16:27.110Z (13 days ago)
• Language: Ruby
• Homepage:
• Size: 124 KB
• Stars: 83
• Watchers: 4
• Forks: 24
• Open Issues: 8
• Metadata Files:
  • Readme: README.rdoc
  • License: LICENSE

Awesome Lists containing this project

README

        
= zbar {}[https://travis-ci.org/willglynn/ruby-zbar]

by Will Glynn

http://github.com/willglynn/ruby-zbar

== Description:

Ruby bindings for ZBar, a barcode recognition library.

== Synopsis:

  require 'zbar'

  

  ZBar::Image.from_jpeg(File.binread('test.jpg')).process

  => [#]

== Download/install:

Add to your Gemfile:

  gem "zbar"

Otherwise:

  $ [sudo] gem install zbar

You'll also need the +zbar+ C library to make it work. This might be available from your package manager:

  $ sudo apt-get install libzbar0    # on Debian or Ubuntu

  $ sudo emerge zbar                 # on Gentoo

  $ brew install zbar                # on Mac OS X with Homebrew

Alternately, install from source at http://zbar.sf.net/.

== Limitations:

Doesn't expose all ZBar functionality, including:

* No video functions

* No low-level interfaces (scanner, decoder)

Additionally, there is a zbar <= 0.10 issue with JPEG decoding; see {lib/zbar/jpeg.rb}[https://github.com/willglynn/ruby-zbar/blob/master/lib/zbar/jpeg.rb] for more. You can check your ZBar::JPEG.bugged? status if you're curious. Otherwise, just try using it, and see if you get a warning on stderr.

== Contributing

 

* Fork the project.

* Make your feature addition or bug fix.

* Add tests for it. This is important so I don't break it in a

  future version unintentionally.

* Commit. Don't change +VERSION+, or if you do, do it in a separate commit.

* Send me a pull request. Bonus points for topic branches.

* Watch the Travis-CI build status on your pull request. Fix any problems.

== Copyright

Copyright (c) 2010-2013 Will Glynn. See LICENSE for details.