ruby-zint 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccdb5e197e8d714e8f2d336b7448a1e104a69a5969b2d811ee6b0ef8998e6cac
-  data.tar.gz: 547681f881a38f9168ac6330f07f300f578e2655eb3241633992e619394239e9
+  metadata.gz: 7cbe79d9fd528474b3cffe957b55cf8cb4aec0bdc97cca55314dc675e74f58c3
+  data.tar.gz: a99a851ff4cfc42387d58e2d439c2ae01976fe03ad81595ccdc60cd94f0f5a89
 SHA512:
-  metadata.gz: 772885463ca263b7a44405a78851961817a04d97b7e2fe2bb7691a5f5b06c0a7c2055bcf5f9dcfc07e1c2b5d235dbf75dcd8a161d5b0d2d2f04629fb4fb603b4
-  data.tar.gz: 565dcf8defee2948e4a4335e9681111056b7ee81a5dd03134f77cb030425131829964f7e2847813ee8866e61de3210e1796f855ae9c09ad601b623a8609dd9e4
+  metadata.gz: 75f8c14c3f4a3ad2f3990fa1c60204264f7120902e2ca31e2a51afc011c5e069d88bd3dcbeb0a8a73757163703c457c0ca49003da7470704afef01fb204585fe
+  data.tar.gz: '0689e71889b46f0278886f717ad3966c2a1b215dd6502666637913112fc84abad23f5ae604d0a1b82bcf2c0379d77975bedaa43887d24d2dab6295734abf0b23'

data/README.md

@@ -27,7 +27,7 @@ Install the libzint binary with your package manager (e. g. `apt install zint` o
 
 Other platforms require building [from source](https://www.zint.org.uk/manual/chapter/2).
 
-**NOTE:** It is assumed that you are using libzint with the version [2.10](https://sourceforge.net/projects/zint/files/zint/2.10.0/).
+**NOTE:** It is assumed that you are using libzint with the version [2.12](https://sourceforge.net/projects/zint/files/zint/2.12.0/).
 
 Then install this gem and enforce system libzint:
 

data/ext/ruby-zint/extconf.rb

@@ -45,11 +45,11 @@ def libzint_usable?
   m = Module.new do
     extend FFI::Library
 
-    ffi_lib(%w[libzint.so.2.10 libzint zint])
+    ffi_lib(%w[libzint.so.2.12 libzint zint])
     attach_function(:ZBarcode_Version, [], :int32)
   end
 
-  (21000...21100) === m.ZBarcode_Version
+  (21200...21300) === m.ZBarcode_Version
 rescue LoadError
   false
 end

data/lib/zint/aus_post.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Australia Post 4-State Barcode
   class AusPost < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_AUSPOST, options: options)

data/lib/zint/aus_redirect.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Australia Post Redirection
   class AusRedirect < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_AUSREDIRECT, options: options)

data/lib/zint/aus_reply.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Australia Post Reply Paid
   class AusReply < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_AUSREPLY, options: options)

data/lib/zint/aus_route.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Australia Post Routing
   class AusRoute < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_AUSROUTE, options: options)

data/lib/zint/azrune.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Aztec Runes
   class Azrune < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_AZRUNE, options: options)

data/lib/zint/aztec.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Aztec Code
   class Aztec < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_AZTEC, options: options)

data/lib/zint/barcode.rb

@@ -31,7 +31,9 @@ module Zint
 
     # Exports barcode to file
     #
-    # @param path [String] Path to export file
+    # @param path [String] Path to export file.
+    #                      Contains the name of the file to output a resulting barcode symbol to.
+    #                      Must end in .png, .gif, .bmp, .emf, .eps, .pcx, .svg, .tif or .txt
     # @param rotate_angle [Integer] Rotate angle in degrees (0, 90, 180, 270)
     def to_file(path:, rotate_angle: 0)
       @zint_symbol[:outfile] = path
@@ -124,7 +126,7 @@ module Zint
       @zint_symbol[:symbology]
     end
 
-    # Sets type of barcode
+    # Sets symbol to use (see BARCODE_XXX below)
     #
     # @param type [Integer] Type of barcode
     def symbology=(type)
@@ -138,7 +140,7 @@ module Zint
       @zint_symbol[:height]
     end
 
-    # Sets height of barcode
+    # Sets height in X-dimensions (ignored for fixed-width barcodes)
     #
     # @param height [Float] Height of barcode
     def height=(height)
@@ -147,12 +149,12 @@ module Zint
       @zint_symbol[:height] = height
     end
 
-    # Gets scale of barcode
+    # Gets scale factor of barcode
     def scale
       @zint_symbol[:scale]
     end
 
-    # Sets scale of barcode
+    # Sets scale factor when printing barcode
     #
     # @param scale [Float] Scale of barcode
     def scale=(scale)
@@ -161,12 +163,12 @@ module Zint
       @zint_symbol[:scale] = scale
     end
 
-    # Gets whitespace width of barcode
+    # Gets width in X-dimensions of whitespace to left & right of barcode
     def whitespace_width
       @zint_symbol[:whitespace_width]
     end
 
-    # Sets whitespace width of barcode
+    # Sets width in X-dimensions of whitespace to left & right of barcode
     #
     # @param whitespace width [Integer] Whitespace width of barcode
     def whitespace_width=(whitespace_width)
@@ -175,12 +177,12 @@ module Zint
       @zint_symbol[:whitespace_width] = whitespace_width
     end
 
-    # Gets whitespace height of barcode
+    # Gets height in X-dimensions of whitespace above & below the barcode
     def whitespace_height
       @zint_symbol[:whitespace_height]
     end
 
-    # Sets whitespace height of barcode
+    # Sets height in X-dimensions of whitespace above & below the barcode
     #
     # @param whitespace height [Integer] Whitespace height of barcode
     def whitespace_height=(whitespace_height)
@@ -189,12 +191,12 @@ module Zint
       @zint_symbol[:whitespace_height] = whitespace_height
     end
 
-    # Gets border width of barcode
+    # Gets size of border in X-dimensions
     def border_width
       @zint_symbol[:border_width]
     end
 
-    # Sets border width of barcode
+    # Sets size of border in X-dimensions
     #
     # @param border width [Integer] Border width of barcode
     def border_width=(border_width)
@@ -208,7 +210,7 @@ module Zint
       @zint_symbol[:output_options]
     end
 
-    # Sets output options of barcode
+    # Set various output parameters (bind, box etc, see below) of barcode
     #
     # @param output options [Integer] Output options of barcode
     def output_options=(output_options)
@@ -219,10 +221,10 @@ module Zint
 
     # Gets foreground colour of barcode
     def fgcolour
-      @zint_symbol[:fgcolour]
+      @zint_symbol[:fgcolour].to_s
     end
 
-    # Sets foreground colour of barcode
+    # Sets foreground as RGB/RGBA hexadecimal string, 6 or 8 characters, NUL-terminated
     #
     # @param fgcolour [String] Foreground colour of barcode
     def fgcolour=(fgcolour)
@@ -233,10 +235,10 @@ module Zint
 
     # Gets background colour of barcode
     def bgcolour
-      @zint_symbol[:bgcolour]
+      @zint_symbol[:bgcolour].to_s
     end
 
-    # Sets background colour of barcode
+    # Sets background as RGB/RGBA hexadecimal string, 6 or 8 characters, NUL-terminated
     #
     # @param bgcolour [String] Background color of barcode
     def bgcolour=(bgcolour)
@@ -245,9 +247,11 @@ module Zint
       @zint_symbol[:bgcolour] = bgcolour
     end
 
-    # Gets outfile of barcode
+    # Contains the name of the file to output a resulting barcode symbol to.
+    #
+    # Must end in .png, .gif, .bmp, .emf, .eps, .pcx, .svg, .tif or .txt
     def outfile
-      @zint_symbol[:outfile]
+      @zint_symbol[:outfile].to_s
     end
 
     # Gets option 1 of barcode
@@ -255,7 +259,7 @@ module Zint
       @zint_symbol[:option_1]
     end
 
-    # Sets option 1 of barcode
+    # Sets option 1 (symbol-specific options (see "../docs/manual.txt"))
     #
     # @param option_1 [Integer] Option 1 of barcode
     def option_1=(option_1)
@@ -269,7 +273,7 @@ module Zint
       @zint_symbol[:option_2]
     end
 
-    # Sets option 2 of barcode
+    # Sets option 2 (symbol-specific options) of barcode
     #
     # @param option 2 [Integer] Option 2 of barcode
     def option_2=(option_2)
@@ -283,7 +287,7 @@ module Zint
       @zint_symbol[:option_3]
     end
 
-    # Sets option 3 of barcode
+    # Sets option 3 (symbol-specific options) of barcode
     #
     # @param option 3 [Integer] Option 3 of barcode
     def option_3=(option_3)
@@ -298,7 +302,7 @@ module Zint
     end
 
     # Sets show_hrt of barcode
-    # Set to 0 to hide text.
+    # show = 1 or hide = 0 Human Readable Text. Default is show (1)
     #
     # @param show_hrt [Integer] show_hrt of barcode
     def show_hrt=(show_hrt)
@@ -312,7 +316,7 @@ module Zint
       @zint_symbol[:fontsize]
     end
 
-    # Sets font size of barcode
+    # Sets font size of barcode (Unused)
     #
     # @param font size [Integer] Font size of barcode
     def fontsize=(fontsize)
@@ -326,7 +330,7 @@ module Zint
       @zint_symbol[:input_mode]
     end
 
-    # Sets input mode of barcode
+    # Sets encoding of input data (see DATA_MODE etc below). Default DATA_MODE
     #
     # @param input_mode [Integer] Input mode of barcode
     def input_mode=(input_mode)
@@ -340,7 +344,7 @@ module Zint
       @zint_symbol[:eci]
     end
 
-    # Sets ECI of barcode
+    # Sets extended Channel Interpretation. Default 0 (none)
     #
     # @param eci [Integer] ECI of barcode
     def eci=(eci)
@@ -349,12 +353,54 @@ module Zint
       @zint_symbol[:eci] = eci
     end
 
-    # Gets text of barcode
+    # Gets resolution of output in dots per mm (BMP/EMF/PCX/PNG/TIF only). Default 0 (none)
+    def dpmm
+      @zint_symbol[:dpmm]
+    end
+
+    # Sets resolution of output in dots per mm (BMP/EMF/PCX/PNG/TIF only). Default 0 (none)
+    #
+    # @param text [Float] Text of barcode
+    def dpmm=(dpmm)
+      reset_symbol
+
+      @zint_symbol[:dpmm] = dpmm
+    end
+
+    # Gets height in X-dimensions that EAN/UPC guard bars descend. Default 5
+    def guard_descent
+      @zint_symbol[:guard_descent]
+    end
+
+    # Sets height in X-dimensions that EAN/UPC guard bars descend. Default 5
+    #
+    # @param text [Float] Text of barcode
+    def guard_descent=(guard_descent)
+      reset_symbol
+
+      @zint_symbol[:guard_descent] = guard_descent
+    end
+
+    # Gets structured append info. Default structapp.count 0 (none)
+    def structapp
+      @zint_symbol[:structapp]
+    end
+
+    # Sets structured append info. Default structapp.count 0 (none)
+    #
+    # @param text [Structs::Structapp] Text of barcode
+    def structapp=(structapp)
+      reset_symbol
+
+      @zint_symbol[:structapp] = structapp
+    end
+
+    # Human Readable Text, which usually consists of input data plus one more check digit. Uses UTF-8 formatting.
     def text
-      @zint_symbol[:text]
+      @zint_symbol[:text].to_s.force_encoding(Encoding::UTF_8)
     end
 
-    # Sets text of barcode
+    # Sets Human Readable Text (if any), UTF-8, NUL-terminated (output only) of barcode
     #
     # @param text [String] Text of barcode
     def text=(text)
@@ -373,12 +419,12 @@ module Zint
       @zint_symbol[:width]
     end
 
-    # Gets primary message data for more complex symbols, with a terminating NUL, of barcode
+    # Gets primary message data for more complex symbols
     def primary
-      @zint_symbol[:primary]
+      @zint_symbol[:primary].to_s
     end
 
-    # Sets primary message of barcode
+    # Sets primary message data (MaxiCode, Composite), NUL-terminated of barcode
     #
     # @param primary [String] Primary of barcode
     def primary=(primary)
@@ -387,12 +433,12 @@ module Zint
       @zint_symbol[:primary] = primary
     end
 
-    # Gets encoded_data of barcode
+    # Gets encoded data of barcode
     def encoded_data
       @zint_symbol[:encoded_data]
     end
 
-    # Sets encoded_data of barcode
+    # Sets encoded data (output only). Allows for rows of 1144 modules of barcode
     #
     # @param encoded_data [String] Encoded data of barcode
     def encoded_data=(encoded_data)
@@ -406,9 +452,9 @@ module Zint
       @zint_symbol[:row_height]
     end
 
-    # Gets error text of barcode
+    # Gets error message in the event that an error occurred
     def errtxt
-      @zint_symbol[:errtxt]
+      @zint_symbol[:errtxt].to_s.force_encoding(Encoding::UTF_8)
     end
 
     # Gets bitmap width of barcode
@@ -431,7 +477,7 @@ module Zint
       @zint_symbol[:dot_size]
     end
 
-    # Sets dot size of barcode
+    # Sets size of dots used in BARCODE_DOTTY_MODE
     #
     # @param dot size [Float] Dot size of barcode
     def dot_size=(dot_size)
@@ -440,12 +486,12 @@ module Zint
       @zint_symbol[:dot_size] = dot_size
     end
 
-    # Gets debug level of barcode
+    # Gets debugging flags
     def debug
       @zint_symbol[:debug]
     end
 
-    # Sets debug level of barcode
+    # Sets debugging flags
     #
     # @param debug [Integer] Debug level of barcode
     def debug=(debug)
@@ -459,7 +505,7 @@ module Zint
       @zint_symbol[:warn_level]
     end
 
-    # Sets warn level of barcode
+    # Sets warn level (affects error/warning value returned by Zint API (see WARN_XXX below)) of barcode
     #
     # @param warn_level [Integer] Warn level of barcode
     def warn_level=(warn_level)

data/lib/zint/{bind.rb → bc_412.rb}

@@ -1,7 +1,8 @@
 module Zint
-  class Bind < Barcode
+  # IBM BC412 (SEMI T1-95)
+  class Bc412 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
-      super(value: value, input_file: input_file, type: Zint::BARCODE_BIND, options: options)
+      super(value: value, input_file: input_file, type: Zint::BARCODE_BC412, options: options)
     end
   end
 end

data/lib/zint/c25iata.rb

@@ -1,4 +1,5 @@
 module Zint
+  # 2 of 5 IATA
   class C25iata < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_C25IATA, options: options)

data/lib/zint/c25ind.rb

@@ -1,4 +1,5 @@
 module Zint
+  #  2 of 5 Industrial
   class C25ind < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_C25IND, options: options)

data/lib/zint/c25inter.rb

@@ -1,4 +1,5 @@
 module Zint
+  # 2 of 5 Interleaved
   class C25inter < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_C25INTER, options: options)

data/lib/zint/c25logic.rb

@@ -1,4 +1,5 @@
 module Zint
+  # 2 of 5 Data Logic
   class C25logic < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_C25LOGIC, options: options)

data/lib/zint/c25matrix.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Legacy
   class C25matrix < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_C25MATRIX, options: options)

data/lib/zint/c25standard.rb

@@ -1,4 +1,5 @@
 module Zint
+  # 2 of 5 Standard (Matrix)
   class C25standard < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_C25STANDARD, options: options)

data/lib/zint/{dotty_mode.rb → cep_net.rb}

@@ -1,7 +1,8 @@
 module Zint
-  class DottyMode < Barcode
+  # Brazilian CEPNet Postal Code
+  class CepNet < Barcode
     def initialize(value: nil, input_file: nil, options: {})
-      super(value: value, input_file: input_file, type: Zint::BARCODE_DOTTY_MODE, options: options)
+      super(value: value, input_file: input_file, type: Zint::BARCODE_CEPNET, options: options)
     end
   end
 end

data/lib/zint/channel.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Channel Code
   class Channel < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CHANNEL, options: options)

data/lib/zint/codabar.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Codabar
   class Codabar < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODABAR, options: options)

data/lib/zint/codablock_f.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Codablock-F
   class CodablockF < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODABLOCKF, options: options)

data/lib/zint/code11.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 11
   class Code11 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE11, options: options)

data/lib/zint/code128.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 128
   class Code128 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE128, options: options)

data/lib/zint/{noascii.rb → code128ab.rb}

@@ -1,7 +1,8 @@
 module Zint
-  class NoAscii < Barcode
+  # Code 128 (Suppress Code Set C)
+  class Code128AB < Barcode
     def initialize(value: nil, input_file: nil, options: {})
-      super(value: value, input_file: input_file, type: Zint::BARCODE_NO_ASCII, options: options)
+      super(value: value, input_file: input_file, type: Zint::BARCODE_CODE128AB, options: options)
     end
   end
 end

data/lib/zint/code128b.rb

@@ -1,7 +1,5 @@
 module Zint
-  class Code128b < Barcode
-    def initialize(value: nil, input_file: nil, options: {})
-      super(value: value, input_file: input_file, type: Zint::BARCODE_CODE128B, options: options)
-    end
+  # Legacy
+  class Code128B < Code128AB
   end
 end

data/lib/zint/code16k.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 16k
   class Code16k < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE16K, options: options)

data/lib/zint/code32.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 32
   class Code32 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE32, options: options)

data/lib/zint/code39.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 39
   class Code39 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE39, options: options)

data/lib/zint/code49.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 49
   class Code49 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE49, options: options)

data/lib/zint/code93.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code 93
   class Code93 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODE93, options: options)

data/lib/zint/code_one.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Code One
   class CodeOne < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_CODEONE, options: options)

data/lib/zint/constants/capability_flags.rb

@@ -2,17 +2,20 @@ module Zint
   module Constants
     # Capability flags (ZBarcode_Cap() `cap_flag`)
     module CapabilityFlags
-      ZINT_CAP_HRT = 0x0001 # Prints Human Readable Text?
-      ZINT_CAP_STACKABLE = 0x0002 # Is stackable?
-      ZINT_CAP_EXTENDABLE = 0x0004 # Is extendable with add-on data? (Is UPC/EAN?)
-      ZINT_CAP_COMPOSITE = 0x0008 # Can have composite data?
-      ZINT_CAP_ECI = 0x0010 # Supports Extended Channel Interpretations?
-      ZINT_CAP_GS1 = 0x0020 # Supports GS1 data?
-      ZINT_CAP_DOTTY = 0x0040 # Can be output as dots?
-      ZINT_CAP_FIXED_RATIO = 0x0100 # Has fixed width-to-height (aspect) ratio?
-      ZINT_CAP_READER_INIT = 0x0200 # Supports Reader Initialisation?
-      ZINT_CAP_FULL_MULTIBYTE = 0x0400 # Supports full-multibyte option?
-      ZINT_CAP_MASK = 0x0800 # Is mask selectable?
+      ZINT_CAP_HRT = 0x0001 # Prints Human Readable Text? */
+      ZINT_CAP_STACKABLE = 0x0002 # Is stackable? */
+      ZINT_CAP_EXTENDABLE = 0x0004 # Is extendable with add-on data? (Is EAN/UPC?) */
+      ZINT_CAP_COMPOSITE = 0x0008 # Can have composite data? */
+      ZINT_CAP_ECI = 0x0010 # Supports Extended Channel Interpretations? */
+      ZINT_CAP_GS1 = 0x0020 # Supports GS1 data? */
+      ZINT_CAP_DOTTY = 0x0040 # Can be output as dots? */
+      ZINT_CAP_QUIET_ZONES = 0x0080 # Has default quiet zones? */
+      ZINT_CAP_FIXED_RATIO = 0x0100 # Has fixed width-to-height (aspect) ratio? */
+      ZINT_CAP_READER_INIT = 0x0200 # Supports Reader Initialisation? */
+      ZINT_CAP_FULL_MULTIBYTE = 0x0400 # Supports full-multibyte option? */
+      ZINT_CAP_MASK = 0x0800 # Is mask selectable? */
+      ZINT_CAP_STRUCTAPP = 0x1000 # Supports Structured Append? */
+      ZINT_CAP_COMPLIANT_HEIGHT = 0x2000 # Has compliant height? */
     end
   end
 end

data/lib/zint/constants/input_data_types.rb

@@ -2,13 +2,14 @@ module Zint
   module Constants
     # Input data types (`symbol->input_mode`)
     module InputDataTypes
-      DATA_MODE = 0
-      UNICODE_MODE = 1
-      GS1_MODE = 2
-      # The following may be OR-ed with above
-      ESCAPE_MODE = 8
-      GS1PARENS_MODE = 16
-      GS1NOCHECK_MODE = 32
+      DATA_MODE = 0 #  Binary
+      UNICODE_MODE = 1 #  UTF-8
+      GS1_MODE = 2 #  GS1
+      ESCAPE_MODE = 0x0008 #  Process escape sequences
+      GS1PARENS_MODE = 0x0010 #  Process parentheses as GS1 AI delimiters (instead of square brackets)
+      GS1NOCHECK_MODE = 0x0020 #  Do not check validity of GS1 data (except that printable ASCII only)
+      HEIGHTPERROW_MODE = 0x0040 #  Interpret `height` as per-row rather than as overall height
+      FAST_MODE = 0x0080 #  Use faster if less optimal encodation or other shortcuts if available (affects DATAMATRIX, MICROPDF417, PDF417, QRCODE & UPNQR only)
     end
   end
 end