escpos 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 07e5de3027f521cd1b3ed0be7c34be9bc54fc9d5
-  data.tar.gz: 0b48cb01f97e2e1bc77e4d8deb88711f3d163322
+  metadata.gz: fb7ee79d9d2c9a0bb174647d37bba0dc123f50ef
+  data.tar.gz: 217b77168da1f85b9e35fc60c03de5b1cfc4e21a
 SHA512:
-  metadata.gz: 76c976c0f10b0b418d57971bbcba86850d01622efb0ef70585dd0ac393d14dbbab0b1cad7b0ec8c96acb6e1bf7456c853ed438251ca87863427c231990f87f73
-  data.tar.gz: 7aa7b8cf020f4d2889b7f80fbceb9446dd0a5108dfa5b72615fb03f38b6a2c2ae1c2c14b4c4662c48d0198c5d6ee3de2cbe6abd88c4c48ea2c4b117e340b9bcf
+  metadata.gz: 26dbc112a89688ed3cff1abf4feff0dd87360b4d27393524dff4c04a59fcc6e4924d291149fb70e2c120c9d12e9b2aa051bdbbb34b408f5efcb9a688d4f894cb
+  data.tar.gz: f9defcbfa5b312537a8c41504d1e2f9d82a6dd762e3587f005ba39f56fc608e3db181be20065251adb7bfbb75d8ac95be475b4ddff005911695828e91a902775

data/README.md

@@ -8,6 +8,9 @@ Add this line to your application's Gemfile:
 
 ```ruby
 gem 'escpos'
+
+# see https://github.com/escpos/escpos-image
+gem 'escpos-image' # add this if you want to print PNG images
 ```
 
 And then execute:
@@ -18,6 +21,12 @@ Or install it yourself as:
 
     $ gem install escpos
 
+## Examples
+
+![](https://github.com/escpos/escpos/blob/master/examples/IMG_20160608_001339_HDR.jpg)
+![](https://github.com/escpos/escpos/blob/master/examples/IMG_20160610_161302_HDR.jpg)
+![](https://github.com/escpos/escpos/blob/master/examples/IMG_20160610_204358_HDR.jpg)
+
 ## Usage
 
 ```ruby
@@ -64,8 +73,8 @@ report = MyReport.new 'path/to/my_report.erb'
 
 - text: Normal text formatting
 - double_height: Double height text
-- quad_text, big, title header, double_width_double_height, double_height_double_width: Double width & Double height text
-- double_width: Double iwdth text
+- quad_text, big, title, header, double_width_double_height, double_height_double_width: Double width & Double height text
+- double_width: Double width text
 - underline, u: Underlined text
 - underline2, u2: Stronger underlined text
 - bold, b: Bold text

data/lib/escpos/helpers.rb

@@ -2,37 +2,48 @@ module Escpos
   module Helpers
 
     # Encodes UTF-8 string to encoding acceptable for the printer
-    # The printer must be set to that encoding, defaults to ISO-8859-2
+    # The printer must be set to that encoding
     # Available encodings can be listed in console using Encoding.constants
     def encode(data, opts = {})
-      data.encode(opts.fetch(:encoding, 'ISO-8859-2'), 'UTF-8', {
+      data.encode(opts.fetch(:encoding), 'UTF-8', {
         invalid: opts.fetch(:invalid, :replace),
         undef: opts.fetch(:undef, :replace),
         replace: opts.fetch(:replace, '?')        
       })
     end
 
+    # Set printer encoding
+    # example: encoding(Escpos::CP_ISO8859_2)
+    def encoding(data)
+      [
+        Escpos.sequence(Escpos::CP_SET),
+        Escpos.sequence(data)
+      ].join
+    end
+    alias :set_encoding :encoding
+    alias :set_printer_encoding :encoding
+
     def text(data)
       [
-        Escpos.sequence(TXT_NORMAL),
+        Escpos.sequence(Escpos::TXT_NORMAL),
         data,
-        Escpos.sequence(TXT_NORMAL),
+        Escpos.sequence(Escpos::TXT_NORMAL),
       ].join
     end
 
     def double_height(data)
       [
-        Escpos.sequence(TXT_2HEIGHT),
+        Escpos.sequence(Escpos::TXT_2HEIGHT),
         data,
-        Escpos.sequence(TXT_NORMAL),
+        Escpos.sequence(Escpos::TXT_NORMAL),
       ].join
     end
 
     def quad_text(data)
       [
-        Escpos.sequence(TXT_4SQUARE),
+        Escpos.sequence(Escpos::TXT_4SQUARE),
         data,
-        Escpos.sequence(TXT_NORMAL),
+        Escpos.sequence(Escpos::TXT_NORMAL),
       ].join
     end
     alias :big :quad_text
@@ -43,67 +54,76 @@ module Escpos
 
     def double_width(data)
       [
-        Escpos.sequence(TXT_2WIDTH),
+        Escpos.sequence(Escpos::TXT_2WIDTH),
         data,
-        Escpos.sequence(TXT_NORMAL),
+        Escpos.sequence(Escpos::TXT_NORMAL),
       ].join
     end
 
     def underline(data)
       [
-        Escpos.sequence(TXT_UNDERL_ON),
+        Escpos.sequence(Escpos::TXT_UNDERL_ON),
         data,
-        Escpos.sequence(TXT_UNDERL_OFF),
+        Escpos.sequence(Escpos::TXT_UNDERL_OFF),
       ].join
     end
     alias :u :underline
 
     def underline2(data)
       [
-        Escpos.sequence(TXT_UNDERL2_ON),
+        Escpos.sequence(Escpos::TXT_UNDERL2_ON),
         data,
-        Escpos.sequence(TXT_UNDERL_OFF),
+        Escpos.sequence(Escpos::TXT_UNDERL_OFF),
       ].join
     end
     alias :u2 :underline2
 
     def bold(data)
       [
-        Escpos.sequence(TXT_BOLD_ON),
+        Escpos.sequence(Escpos::TXT_BOLD_ON),
         data,
-        Escpos.sequence(TXT_BOLD_OFF),
+        Escpos.sequence(Escpos::TXT_BOLD_OFF),
       ].join
     end
     alias :b :bold
 
-    def left(data)
+    def left(data = '')
+      [
+        Escpos.sequence(Escpos::TXT_ALIGN_LT),
+        data,
+        Escpos.sequence(Escpos::TXT_ALIGN_LT),
+      ].join
+    end
+
+    def right(data = '')
       [
-        Escpos.sequence(TXT_ALIGN_LT),
+        Escpos.sequence(Escpos::TXT_ALIGN_RT),
         data,
-        Escpos.sequence(TXT_ALIGN_LT),
+        Escpos.sequence(Escpos::TXT_ALIGN_LT),
       ].join
     end
 
-    def right(data)
+    def center(data = '')
       [
-        Escpos.sequence(TXT_ALIGN_RT),
+        Escpos.sequence(Escpos::TXT_ALIGN_CT),
         data,
-        Escpos.sequence(TXT_ALIGN_LT),
+        Escpos.sequence(Escpos::TXT_ALIGN_LT),
       ].join
     end
 
-    def center(data)
+    def inverted(data)
       [
-        Escpos.sequence(TXT_ALIGN_CT),
+        Escpos.sequence(Escpos::TXT_INVERT_ON),
         data,
-        Escpos.sequence(TXT_ALIGN_LT),
+        Escpos.sequence(Escpos::TXT_INVERT_OFF),
       ].join
     end
+    alias :invert :inverted
 
     def barcode(data, opts = {})
-      text_position = opts.fetch(:text_position, BARCODE_TXT_OFF)
-      unless [BARCODE_TXT_OFF, BARCODE_TXT_ABV, BARCODE_TXT_BLW, BARCODE_TXT_BTH].include?(text_position)
-        raise ArgumentError("Text position must be one of the following: BARCODE_TXT_OFF, BARCODE_TXT_ABV, BARCODE_TXT_BLW, BARCODE_TXT_BTH.")
+      text_position = opts.fetch(:text_position, Escpos::BARCODE_TXT_OFF)
+      unless [Escpos::BARCODE_TXT_OFF, Escpos::BARCODE_TXT_ABV, Escpos::BARCODE_TXT_BLW, Escpos::BARCODE_TXT_BTH].include?(text_position)
+        raise ArgumentError("Text position must be one of the following: Escpos::BARCODE_TXT_OFF, Escpos::BARCODE_TXT_ABV, Escpos::BARCODE_TXT_BLW, Escpos::BARCODE_TXT_BTH.")
       end
       height = opts.fetch(:height, 50)
       raise ArgumentError("Height must be in range from 1 to 255.") if height && (height < 1 || height > 255)
@@ -111,21 +131,21 @@ module Escpos
       raise ArgumentError("Width must be in range from 2 to 6.") if width && (width < 2 || width > 6)
       [
         Escpos.sequence(text_position),
-        Escpos.sequence(BARCODE_WIDTH),
+        Escpos.sequence(Escpos::BARCODE_WIDTH),
         Escpos.sequence([width]),
-        Escpos.sequence(BARCODE_HEIGHT),
+        Escpos.sequence(Escpos::BARCODE_HEIGHT),
         Escpos.sequence([height]),
-        Escpos.sequence(opts.fetch(:format, BARCODE_EAN13)),
+        Escpos.sequence(opts.fetch(:format, Escpos::BARCODE_EAN13)),
         data
       ].join
     end
 
     def partial_cut
-      Escpos.sequence(PAPER_PARTIAL_CUT)
+      Escpos.sequence(Escpos::PAPER_PARTIAL_CUT)
     end
 
     def cut
-      Escpos.sequence(PAPER_FULL_CUT)
+      Escpos.sequence(Escpos::PAPER_FULL_CUT)
     end
 
   end

data/lib/escpos/printer.rb

@@ -7,7 +7,7 @@ module Escpos
     def initialize
       # ensure only supported sequences are generated
       @data = "".force_encoding("ASCII-8BIT")
-      @data = Escpos.sequence HW_INIT
+      @data << Escpos.sequence(HW_INIT)
     end
 
     def write(data)

data/lib/escpos/version.rb

@@ -1,3 +1,3 @@
 module Escpos
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/lib/escpos.rb

@@ -20,11 +20,57 @@ module Escpos
   # Paper
   PAPER_FULL_CUT               = [ 0x1d, 0x56, 0x00 ]			   # Full paper cut 
   PAPER_PARTIAL_CUT            = [ 0x1d, 0x56, 0x01 ]			   # Partial paper cut
+  PAPER_CUT_A                  = [ 0x1d, 0x56, 0x41 ]			   # Paper cut A
+  PAPER_CUT_B                  = [ 0x1d, 0x56, 0x42 ]			   # Paper cut B
 
   # Cash Drawer
   CD_KICK_2                    = [ 0x1b, 0x70, 0x00 ]			   # Send pulse to pin 2
   CD_KICK_5                    = [ 0x1b, 0x70, 0x01 ]			   # Send pulse to pin 5
 
+  # Code Pages
+  CP_SET                       = [ 0x1b, 0x74 ]	      		   # Set Code Page
+  CP_CP437                     = [ 0x0 ]
+  CP_CP850                     = [ 0x2 ]
+  CP_CP860                     = [ 0x3 ]
+  CP_CP863                     = [ 0x4 ]
+  CP_CP865                     = [ 0x5 ]
+  CP_CP1251                    = [ 0x6 ]
+  CP_CP866                     = [ 0x7 ]
+  CP_MACCYRILLIC               = [ 0x8 ]
+  CP_CP775                     = [ 0x9 ]
+  CP_CP1253                    = [ 0x10 ]
+  CP_CP737                     = [ 0x11 ]
+  CP_CP857                     = [ 0x12 ]
+  CP_ISO8859_9                 = [ 0x13 ]
+  CP_CP864                     = [ 0x14 ]
+  CP_CP862                     = [ 0x15 ]
+  CP_ISO8859_2                 = [ 0x16 ]
+  CP_CP1253_ALT                = [ 0x17 ]
+  CP_CP1250                    = [ 0x18 ]
+  CP_CP858                     = [ 0x19 ]
+  CP_CP1254                    = [ 0x20 ]
+  CP_CP737_ALT                 = [ 0x24 ]
+  CP_CP1257                    = [ 0x25 ]
+  CP_CP847                     = [ 0x26 ]
+  CP_CP885                     = [ 0x28 ]
+  CP_CP857_ALT                 = [ 0x29 ]
+  CP_CP1250_ALT                = [ 0x30 ]
+  CP_CP775_ALT                 = [ 0x31 ]
+  CP_CP1254_ALT                = [ 0x32 ]
+  CP_CP1256                    = [ 0x34 ]
+  CP_CP1258                    = [ 0x35 ]
+  CP_ISO8859_2_ALT             = [ 0x36 ]
+  CP_ISO8859_3                 = [ 0x37 ]
+  CP_ISO8859_4                 = [ 0x38 ]
+  CP_ISO8859_5                 = [ 0x39 ]
+  CP_ISO8859_6                 = [ 0x40 ]
+  CP_ISO8859_7                 = [ 0x41 ]
+  CP_ISO8859_8                 = [ 0x42 ]
+  CP_ISO8859_9_ALT             = [ 0x43 ]
+  CP_ISO8859_15                = [ 0x44 ]
+  CP_CP856                     = [ 0x47 ]
+  CP_CP874                     = [ 0x47 ]
+
   # Text formating
   TXT_NORMAL                   = [ 0x1b, 0x21, 0x00 ]        # Normal text
   TXT_2HEIGHT                  = [ 0x1b, 0x21, 0x10 ]        # Double height text
@@ -40,6 +86,8 @@ module Escpos
   TXT_ALIGN_LT                 = [ 0x1b, 0x61, 0x00 ]        # Left justification
   TXT_ALIGN_CT                 = [ 0x1b, 0x61, 0x01 ]        # Centering
   TXT_ALIGN_RT                 = [ 0x1b, 0x61, 0x02 ]        # Right justification
+  TXT_INVERT_ON                = [ 0x1d, 0x42, 0x01 ]        # Inverted coloer text
+  TXT_INVERT_OFF               = [ 0x1d, 0x42, 0x00 ]        # Inverted coloer text
 
   # Barcodes
   BARCODE_TXT_OFF             = [ 0x1d, 0x48, 0x00 ]         # HRI barcode chars OFF

data/test/fixtures/styles.erb

@@ -1,6 +1,8 @@
 Unformatted text
 
-<%= encode "ISO-8859-2 encoded text. (ěščřžýáíéúů)", encoding: "ISO-8859-2" %>
+<%= set_printer_encoding(Escpos::CP_ISO8859_2) %>
+
+<%= encode "UTF-8 to ISO-8859-2 text: (ěščřžýáíéúů)", encoding: "ISO-8859-2" %>
 
 <%= text "Normal text" %>
 
@@ -22,6 +24,10 @@ Unformatted text
 
 <%= center "Centered text" %>
 
+<%= left %>
+
+<%= invert "Inverted color text" %>
+
 <%= barcode "8594404000572" %>
 
 

data/test/lib/escpos/printer_test.rb

@@ -11,7 +11,7 @@ class TestPrinter < Minitest::Test
     @printer.write template.result(Class.new { include Escpos::Helpers }.new.instance_eval { binding })
     @printer.cut!
     #pp @printer.to_base64
-    assert_equal @printer.to_base64, 'G0BVbmZvcm1hdHRlZCB0ZXh0CgpJU08tODg1OS0yIGVuY29kZWQgdGV4dC4gKOy56Pi+/eHt6fr5KQoKGyEATm9ybWFsIHRleHQbIQAKChshEERvdWJsZSBoZWlnaHQgdGV4dBshAAoKGyEgRG91YmxlIHdpZHRoIHRleHQbIQAKChshMFF1YWQgYXJlYSB0ZXh0GyEACgobLQFVbmRlcmxpbmVkIHRleHQbLQAKChstAlVuZGVybGluZWQgdGV4dCAoMikbLQAKChtFAUJvbGQgdGV4dBtFAAoKG2EATGVmdCBhbGlnbmVkIHRleHQbYQAKChthAlJpZ2h0IGFsaWduZWQgdGV4dBthAAoKG2EBQ2VudGVyZWQgdGV4dBthAAoKHUgAHXcDHWgyHWsCODU5NDQwNDAwMDU3MgoKCgoKHVYA'
+    assert_equal @printer.to_base64, 'G0BVbmZvcm1hdHRlZCB0ZXh0CgobdBYKClVURi04IHRvIElTTy04ODU5LTIgdGV4dDogKOy56Pi+/eHt6fr5KQoKGyEATm9ybWFsIHRleHQbIQAKChshEERvdWJsZSBoZWlnaHQgdGV4dBshAAoKGyEgRG91YmxlIHdpZHRoIHRleHQbIQAKChshMFF1YWQgYXJlYSB0ZXh0GyEACgobLQFVbmRlcmxpbmVkIHRleHQbLQAKChstAlVuZGVybGluZWQgdGV4dCAoMikbLQAKChtFAUJvbGQgdGV4dBtFAAoKG2EATGVmdCBhbGlnbmVkIHRleHQbYQAKChthAlJpZ2h0IGFsaWduZWQgdGV4dBthAAoKG2EBQ2VudGVyZWQgdGV4dBthAAoKG2EAG2EACgodQgFJbnZlcnRlZCBjb2xvciB0ZXh0HUIACgodSAAddwMdaDIdawI4NTk0NDA0MDAwNTcyCgoKCgodVgA='
   end
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: escpos
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Jan Svoboda
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-10 00:00:00.000000000 Z
+date: 2016-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -69,6 +69,9 @@ files:
 - bin/setup
 - config
 - escpos.gemspec
+- examples/IMG_20160608_001339_HDR.jpg
+- examples/IMG_20160610_161302_HDR.jpg
+- examples/IMG_20160610_204358_HDR.jpg
 - examples/report.erb
 - examples/report.rb
 - lib/escpos.rb
@@ -101,7 +104,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.4
 signing_key: 
 specification_version: 4
 summary: A ruby implementation of ESC/POS (thermal) printer command specification.