pdf417 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,15 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+*~
+ext/pdf417/*.dll
+lib/pdf417/*.so
+lib/pdf417/*.bundle
+lib/pdf417/*.o
+lib/pdf417/Makefile
+stash
+.rake_tasks
+tmp
+*.gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 jamesprior
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,46 @@
+= pdf417
+
+A wrapper for the pdf417lib C Library, from the README:
+
+    A library to generate the 2D barcode PDF417
+
+    Project: http://sourceforge.net/projects/pdf417.lib
+    Creator: Paulo Soares (psoares@consiste.pt)
+    License: LGPL or MPL 1.1
+
+    This library generates a PDF417 image of the barcode in a 1x1 scale.
+    It requires that the displayed image be as least stretched 3 times
+    in the vertical direction in relation with the horizontal dimension.
+    
+Fetching the codewords only can be handy for using rtex and the pst-barcode package.  If you're using prawn
+or RMagic the to_blob function should help generate a complete barcode.
+
+== Usage
+
+There are a few ways to use the library, at its simplest:
+
+  PDF417.encode_text("readable barcode data") => [12, 827, 120, 90, 41, 146, 30, 512, 423, 146, 90, 570]
+  
+If you want to get the bitmap:
+
+ barcode = PDF417.new("readable barcode data")
+ barcode.to_blob  # oops, wrong text
+ barcode.text = "ACTUAL barcode data"
+ barcode.to_blob
+ 
+See the RDocs for more information.
+
+== Note on Patches/Pull Requests
+ 
+* 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, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2011 jamesprior. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,59 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "pdf417"
+    gem.summary = %Q{A Ruby wrapper for the PDF417 barcode library}
+    gem.description = %Q{Generate a series of codewords or a binary blob for PDF417 barcodes}
+    gem.email = "j.prior@asee.org"
+    gem.homepage = "http://github.com/asee/pdf417"
+    gem.authors = ["jamesprior"]
+    gem.extensions << 'ext/pdf417/extconf.rb'
+    gem.require_paths << 'ext'
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "pdf417 #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include("*.rdoc")
+  rdoc.rdoc_files.include("ext/pdf417/*.c")
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/ext/pdf417/Makefile

@@ -0,0 +1,157 @@
+
+SHELL = /bin/sh
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = /opt/ruby-enterprise-1.8.7-2010.01/lib/ruby/1.8/i686-darwin10.3.0
+hdrdir = $(topdir)
+VPATH = $(srcdir):$(topdir):$(hdrdir)
+exec_prefix = $(prefix)
+prefix = $(DESTDIR)/opt/ruby-enterprise-1.8.7-2010.01
+sharedstatedir = $(prefix)/com
+mandir = $(datarootdir)/man
+psdir = $(docdir)
+oldincludedir = $(DESTDIR)/usr/include
+localedir = $(datarootdir)/locale
+bindir = $(exec_prefix)/bin
+libexecdir = $(exec_prefix)/libexec
+sitedir = $(libdir)/ruby/site_ruby
+htmldir = $(docdir)
+vendorarchdir = $(vendorlibdir)/$(sitearch)
+includedir = $(prefix)/include
+infodir = $(datarootdir)/info
+vendorlibdir = $(vendordir)/$(ruby_version)
+sysconfdir = $(prefix)/etc
+libdir = $(exec_prefix)/lib
+sbindir = $(exec_prefix)/sbin
+rubylibdir = $(libdir)/ruby/$(ruby_version)
+docdir = $(datarootdir)/doc/$(PACKAGE)
+dvidir = $(docdir)
+vendordir = $(libdir)/ruby/vendor_ruby
+datarootdir = $(prefix)/share
+pdfdir = $(docdir)
+archdir = $(rubylibdir)/$(arch)
+sitearchdir = $(sitelibdir)/$(sitearch)
+datadir = $(datarootdir)
+localstatedir = $(prefix)/var
+sitelibdir = $(sitedir)/$(ruby_version)
+
+CC = gcc
+LIBRUBY = $(LIBRUBY_A)
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = 
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static
+
+RUBY_EXTCONF_H = 
+CFLAGS   =  -fno-common -g -O2  -pipe -fno-common $(cflags) 
+INCFLAGS = -I. -I$(topdir) -I$(hdrdir) -I$(srcdir)
+DEFS     = 
+CPPFLAGS =   -D_XOPEN_SOURCE -D_DARWIN_C_SOURCE $(DEFS) $(cppflags)
+CXXFLAGS = $(CFLAGS) 
+ldflags  = -L. 
+dldflags = 
+archflag = 
+DLDFLAGS = $(ldflags) $(dldflags) $(archflag)
+LDSHARED = cc -dynamic -bundle -undefined suppress -flat_namespace
+AR = ar
+EXEEXT = 
+
+RUBY_INSTALL_NAME = ruby
+RUBY_SO_NAME = ruby
+arch = i686-darwin10.3.0
+sitearch = i686-darwin10.3.0
+ruby_version = 1.8
+ruby = /opt/ruby-enterprise-1.8.7-2010.01/bin/ruby
+RUBY = $(ruby)
+RM = rm -f
+MAKEDIRS = mkdir -p
+INSTALL = /usr/bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+
+#### End of system configuration section. ####
+
+preload = 
+
+libpath = . $(libdir)
+LIBPATH =  -L. -L$(libdir)
+DEFFILE = 
+
+CLEANFILES = mkmf.log
+DISTCLEANFILES = 
+
+extout = 
+extout_prefix = 
+target_prefix = 
+LOCAL_LIBS = 
+LIBS =   -ldl -lobjc  
+SRCS = pdf417.c pdf417lib.c
+OBJS = pdf417.o pdf417lib.o
+TARGET = pdf417
+DLLIB = $(TARGET).bundle
+EXTSTATIC = 
+STATIC_LIB = 
+
+BINDIR        = $(bindir)
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+
+TARGET_SO     = $(DLLIB)
+CLEANLIBS     = $(TARGET).bundle $(TARGET).il? $(TARGET).tds $(TARGET).map
+CLEANOBJS     = *.o *.a *.s[ol] *.pdb *.exp *.bak
+
+all:		$(DLLIB)
+static:		$(STATIC_LIB)
+
+clean:
+		@-$(RM) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES)
+
+distclean:	clean
+		@-$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		@-$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+
+realclean:	distclean
+install: install-so install-rb
+
+install-so: $(RUBYARCHDIR)
+install-so: $(RUBYARCHDIR)/$(DLLIB)
+$(RUBYARCHDIR)/$(DLLIB): $(DLLIB)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+install-rb: pre-install-rb install-rb-default
+install-rb-default: pre-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+$(RUBYARCHDIR):
+	$(MAKEDIRS) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .cxx .cpp .C .o
+
+.cc.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cxx.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cpp.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.C.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.c.o:
+	$(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) -c $<
+
+$(DLLIB): $(OBJS) Makefile
+	@-$(RM) $@
+	$(LDSHARED) -o $@ $(OBJS) $(LIBPATH) $(DLDFLAGS) $(LOCAL_LIBS) $(LIBS)
+
+
+
+$(OBJS): ruby.h defines.h

data/ext/pdf417/extconf.rb

@@ -0,0 +1,4 @@
+require 'mkmf'
+extension_name = 'pdf417'
+dir_config(extension_name)
+create_makefile(extension_name)

data/ext/pdf417/pdf417.c

@@ -0,0 +1,291 @@
+/*  NOTE:  This relies on the PDF417 Library from http://sourceforge.net/projects/pdf417lib and is included here 
+ *
+*/
+
+#include <ruby.h>
+#include "pdf417lib.h"
+#include "pdf417.h"
+
+/*  A wrapper for the pdf417lib C Library, from the README:
+
+      A library to generate the 2D barcode PDF417
+
+      Project: http://sourceforge.net/projects/pdf417.lib
+      Creator: Paulo Soares (psoares@consiste.pt)
+      License: LGPL or MPL 1.1
+
+      This library generates a PDF417 image of the barcode in a 1x1 scale.
+      It requires that the displayed image be as least stretched 3 times
+      in the vertical direction in relation with the horizontal dimension.
+   
+   This class will interface with the C library to take a text string representing
+   the barcode data and produce a list of data codewords, or a binary string (blob)
+   representing a bitmap.
+
+ */
+
+
+// The initialization method for this module
+void Init_pdf417() {
+  rb_cPdf417 = rb_define_class("PDF417", rb_cObject);
+  rb_define_singleton_method(rb_cPdf417, "encode_text", rb_pdf417_encode_text, 1);
+  rb_define_singleton_method(rb_cPdf417, "new", rb_pdf417_new, 1);
+  rb_define_method(rb_cPdf417, "initialize", rb_pdf417_init, 1);
+  rb_define_method(rb_cPdf417, "codewords", rb_pdf417_codewords, 0);
+  rb_define_method(rb_cPdf417, "to_blob", rb_pdf417_to_blob, 0);
+  rb_define_method(rb_cPdf417, "bit_columns", rb_pdf417_bitColumns, 0);
+  rb_define_method(rb_cPdf417, "bit_length", rb_pdf417_lenBits, 0);
+  rb_define_method(rb_cPdf417, "code_rows", rb_pdf417_codeRows, 0);
+  rb_define_method(rb_cPdf417, "code_columns", rb_pdf417_codeColumns, 0);
+  rb_define_method(rb_cPdf417, "codeword_length", rb_pdf417_lenCodewords, 0);
+  rb_define_method(rb_cPdf417, "error_level", rb_pdf417_errorLevel, 0);
+  rb_define_method(rb_cPdf417, "generation_options", rb_pdf417_options, 0);
+  rb_define_method(rb_cPdf417, "aspect_ratio", rb_pdf417_aspectRatio, 0);
+  rb_define_method(rb_cPdf417, "y_height", rb_pdf417_yHeight, 0);
+  rb_define_method(rb_cPdf417, "generation_error", rb_pdf417_error, 0);  
+}
+
+/*
+ * call-seq:
+ *   encode_text(text)
+ *
+ * Returns an array of integers showing the codewords
+ */
+static VALUE rb_pdf417_encode_text(VALUE self, VALUE text) {
+  VALUE list;
+  int k;
+  
+  pdf417param p;
+  pdf417init(&p);
+  p.text = StringValuePtr(text);
+  fetchCodewords(&p);
+  if (p.error) {
+      pdf417free(&p);
+      return Qnil; //could also return list or raise something
+  }
+  
+  list = rb_ary_new2(p.lenCodewords);
+  
+  pdf417free(&p); 
+  
+  for (k = 0; k < p.lenCodewords; ++k) {
+    rb_ary_push(list, INT2NUM(p.codewords[k]));
+  }
+  return list;
+}
+
+/* :nodoc: */
+static void rb_pdf417_cleanup(void *p) {
+  pdf417free(p); 
+}
+
+/* :nodoc: */
+static VALUE rb_pdf417_init(VALUE self, VALUE text) {
+  rb_iv_set(self, "@text", text);
+  return self;
+}
+
+/*
+ * call-seq:
+ *  new(text)
+ *
+ * Makes a new PDF417 object for the given text string
+ */
+static VALUE rb_pdf417_new(VALUE class, VALUE text) {
+  VALUE argv[1];
+  pdf417param *ptr;
+  VALUE tdata = Data_Make_Struct(class, pdf417param, 0, rb_pdf417_cleanup, ptr);
+  pdf417init(ptr);
+  argv[0] = text;
+  rb_obj_call_init(tdata, 1, argv);
+  return tdata;
+}
+
+/*
+ * call-seq:
+ *  codewords
+ *
+ * Generates an array of codewords from the current text attribute
+ */
+static VALUE rb_pdf417_codewords(VALUE self) {
+  VALUE list;
+  int k;
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  
+  // Only re-do it if our text has changed
+  if ( ptr->text != STR2CSTR(rb_iv_get(self, "@text")) ) {
+    ptr->text = STR2CSTR(rb_iv_get(self, "@text")); //StringValuePtr(text); 
+
+    paintCode(ptr); //paintCode also sets the error correction, we call it here so we can get the blob if needed w/o trouble
+  }
+  
+  // otherwise, fill the array and respond
+  if (ptr->error) {
+      return Qnil; //could also return list
+  }
+  
+  list = rb_ary_new2(ptr->lenCodewords);
+  
+  // The first codeword is the length of the data, which is all we're interested in here.
+  for (k = 0; k < ptr->codewords[0]; ++k) {
+    rb_ary_push(list, INT2NUM(ptr->codewords[k]));
+  }
+  return list;  
+}
+
+/*
+ * call-seq:
+ *  to_blob
+ *
+ * Returns a binary string representing the image bits, requires scaling before display
+ */
+static VALUE rb_pdf417_to_blob(VALUE self) {
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  
+  // Only re-do it if our text has changed
+  if ( ptr->text != STR2CSTR(rb_iv_get(self, "@text")) ) {
+    ptr->text = STR2CSTR(rb_iv_get(self, "@text")); //StringValuePtr(text); 
+
+    paintCode(ptr);
+  }
+  
+  // otherwise, fill the array and respond
+  if (ptr->error) {
+      return Qnil; //could also return list
+  }
+  
+  return rb_str_new2(ptr->outBits);
+}
+
+/*
+ * call-seq:
+ *  bit_columns
+ *
+ * The number of column bits in the bitmap
+ */
+static VALUE rb_pdf417_bitColumns(VALUE self) {
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->bitColumns);
+}
+
+/*
+ * call-seq:
+ *  bit_length
+ *
+ * The size in bytes of the bitmap
+ */
+static VALUE rb_pdf417_lenBits(VALUE self) {
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->lenBits);
+}
+
+/*
+ * call-seq:
+ *  code_rows
+ *
+ * The number of code rows and bitmap lines
+ */
+static VALUE rb_pdf417_codeRows(VALUE self) {
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->codeRows);
+}
+
+/*
+ * call-seq:
+ *  code_columns
+ *
+ * The number of code columns
+ */
+static VALUE rb_pdf417_codeColumns(VALUE self) {
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->codeColumns);
+}
+
+/*
+ * call-seq:
+ *  codeword_length
+ *
+ * The size of the code words, including error correction codes
+ */
+static VALUE rb_pdf417_lenCodewords(VALUE self) {
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->lenCodewords);
+}
+
+/*
+ * call-seq:
+ *  error_level
+ *
+ * The error level required 0-8
+ */
+static VALUE rb_pdf417_errorLevel(VALUE self){
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->errorLevel);
+}
+
+/*
+ * call-seq:
+ *  generation_options
+ *
+ * The int representing the options used to generate the barcode, defined in the library as:
+ * [PDF417_USE_ASPECT_RATIO] use aspectRatio to set the y/x dimension. Also uses yHeight
+ * [PDF417_FIXED_RECTANGLE] make the barcode dimensions at least codeColumns by codeRows
+ * [PDF417_FIXED_COLUMNS] make the barcode dimensions at least codeColumns
+ * [PDF417_FIXED_ROWS] make the barcode dimensions at least codeRows
+ * [PDF417_AUTO_ERROR_LEVEL] automatic error level depending on text size
+ * [PDF417_USE_ERROR_LEVEL] the error level is errorLevel. The used errorLevel may be different
+ * [PDF417_USE_RAW_CODEWORDS] use codewords instead of text
+ * [PDF417_INVERT_BITMAP] invert the resulting bitmap
+ */
+static VALUE rb_pdf417_options(VALUE self){
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->options);
+}
+
+/*
+ * call-seq:
+ *  aspect_ratio
+ *
+ * The y/x aspect ratio
+ */
+static VALUE rb_pdf417_aspectRatio(VALUE self){
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return rb_float_new(ptr->aspectRatio);
+}
+
+/*
+ * call-seq:
+ *  y_height
+ *
+ * The y/x dot ratio
+ */
+static VALUE rb_pdf417_yHeight(VALUE self){
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return rb_float_new(ptr->yHeight);
+}
+
+/*
+ * call-seq:
+ *  generation_error
+ *
+ * The error returned as an int, defined in C as:
+ * [PDF417_ERROR_SUCCESS] no errors
+ * [PDF417_ERROR_TEXT_TOO_BIG] the text was too big the PDF417 specifications
+ * [PDF417_ERROR_INVALID_PARAMS] invalid parameters. Only used with PDF417_USE_RAW_CODEWORDS
+ */
+static VALUE rb_pdf417_error(VALUE self){
+  pdf417param *ptr;
+  Data_Get_Struct(self, pdf417param, ptr);
+  return INT2NUM(ptr->error);
+}