escper 1.0.3 → 1.0.4

data/.gitignore

@@ -1,3 +1,5 @@
 pkg/*
 *.gem
 .bundle
+*.*~
+*~

data/README

@@ -0,0 +1,44 @@
+= Escper (read: "escaper") -- Convert an image to ESCPOS commands for thermal receipt printers
+
+== Usage:
+
+    gem install escper
+
+Test it in a Ruby script:
+
+    require 'escper'
+    puts Escper::Image.new('test.png', :file).to_s
+
+Or if you read the image from an image upload form in Rails, do this:
+
+    Escper::Image.new(data.read, :blob).to_s
+
+... where "data" is a variable containing the image data of a multipart HTML form.
+
+Or if you have an Magick::Image already loaded, call it like this:
+
+    Escper::Image.new(magickobject, :object)
+
+
+For optimal visual results, image.png should previously be converted to an indexed, black and white 1-bit palette image. In Gimp, click on "Image -> Mode -> Indexed..." and select "Use black and white (1-bit) palette". For dithering, choose "Floyd-Steinberg (reduced color bleeding)". The image size depends on the resolution of the printer.
+
+To send an image directly to a thermal receipt printer:
+
+    File.open('/dev/usb/lp0','w') { |f| f.write Escper::Image.new('image.png', :file).to_s }
+
+== Licence
+
+Copyright (C) 2011-2012  Michael Franzl <office@michaelfranzl.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.

data/escper.gemspec

@@ -18,4 +18,6 @@ Gem::Specification.new do |s|
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
+
+  s.add_dependency "rmagick"
 end

data/lib/escper.rb

@@ -1,41 +1,52 @@
+# Escper -- Convert an image to ESCPOS commands for thermal printers
+# Copyright (C) 2011-2012  Michael Franzl <michael@billgastro.com>
+# 
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as
+# published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
 require 'RMagick'
+
 module Escper
   class Image
-    def initialize(data, type)
+    def initialize(source, type)
       if type == :file
-        @image = convert(Magick::Image.read(data).first)
+        @image = Magick::Image.read(source).first
       elsif type == :blob
-        @image = convert(Magick::Image.from_blob(data).first)
+        @image = Magick::Image.from_blob(source).first
+      elsif type == :object
+        @image = source
       end
+      @x = (@image.columns / 8.0).round
+      @y = (@image.rows / 8.0).round
+      @x = 1 if @x.zero?
+      @y = 1 if @y.zero?
     end
 
-    def convert(img=nil)
-      if img.nil? and @image
-        @image = @image.quantize 2, Magick::GRAYColorspace
-        @image = crop(@image)
-        return @image
-      else
-        img = img.quantize 2, Magick::GRAYColorspace
-        img = crop(img)
-        return img
-      end
+    def convert
+      @image = @image.quantize 2, Magick::GRAYColorspace
     end
 
-    def crop(image)
-      @x = (image.columns / 8.0).round
-      @y = (image.rows / 8.0).round
-      @x = 1 if @x == 0
-      @y = 1 if @y == 0
-      image = image.extent @x * 8, @y * 8
-      return image
+    def crop
+      @image = @image.extent @x * 8, @y * 8
     end
 
     def to_a
-      colorarray = @image.export_pixels
-      return colorarray
+      @image.export_pixels
     end
 
     def to_s
+      self.convert
+      self.crop
       colorarray = self.to_a
       bits = []
       mask = 0x80
@@ -44,7 +55,7 @@ module Escper
       (@x * @y * 8 * 3 * 8).times do |j|
         next unless (j % 3).zero?
         temp |= mask if colorarray[j] == 0 # put 1 in place if black
-        mask = mask >> 1 # shift mask
+        mask = mask >> 1
         i += 3
         if i == 24
 	        bits << temp

data/lib/escper/version.rb

@@ -1,3 +1,3 @@
 module Escper
-  VERSION = "1.0.3"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,70 +1,69 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: escper
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 1
-  - 0
-  - 3
-  version: 1.0.3
+version: !ruby/object:Gem::Version
+  version: 1.0.4
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Michael Franzl
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-10-24 00:00:00 +02:00
-default_executable: 
-dependencies: []
-
-description: ""
-email: 
+date: 2012-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ''
+email:
 - office@michaelfranzl.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - Gemfile
+- README
 - Rakefile
 - escper.gemspec
 - lib/escper.rb
+- lib/escper/test.png
 - lib/escper/version.rb
-has_rdoc: true
 homepage: http://michaelfranzl.com
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: escper
-rubygems_version: 1.3.7
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Converts bitmaps to the ESC/POS receipt printer command
 test_files: []
-