ruby-zint 1.1.0 → 1.2.0

data/lib/zint/constants/output_options.rb

@@ -2,17 +2,20 @@ module Zint
   module Constants
     # Output options (`symbol->output_options`)
     module OutputOptions
-      BARCODE_NO_ASCII = 1   # Legacy (no-op)
-      BARCODE_BIND = 2   # Boundary bars above & below the symbol and between stacked symbols
-      BARCODE_BOX = 4   # Box around symbol
-      BARCODE_STDOUT = 8   # Output to stdout
-      READER_INIT = 16  # Reader Initialisation (Programming)
-      SMALL_TEXT = 32  # Use smaller font
-      BOLD_TEXT = 64  # Use bold font
-      CMYK_COLOUR = 128 # CMYK colour space (Encapsulated PostScript and TIF)
-      BARCODE_DOTTY_MODE = 256 # Plot a matrix symbol using dots rather than squares
-      GS1_GS_SEPARATOR = 512 # Use GS instead of FNC1 as GS1 separator (Data Matrix)
-      OUT_BUFFER_INTERMEDIATE = 1024 # Return ASCII values in bitmap buffer (OUT_BUFFER only)
+      BARCODE_BIND_TOP = 0x0001 # Boundary bar above the symbol only (not below), does not affect stacking */
+      BARCODE_BIND = 0x0002 # Boundary bars above & below the symbol and between stacked symbols */
+      BARCODE_BOX = 0x0004 # Box around symbol */
+      BARCODE_STDOUT = 0x0008 # Output to stdout */
+      READER_INIT = 0x0010 # Reader Initialisation (Programming) */
+      SMALL_TEXT = 0x0020 # Use smaller font */
+      BOLD_TEXT = 0x0040 # Use bold font */
+      CMYK_COLOUR = 0x0080 # CMYK colour space (Encapsulated PostScript and TIF) */
+      BARCODE_DOTTY_MODE = 0x0100 # Plot a matrix symbol using dots rather than squares */
+      GS1_GS_SEPARATOR = 0x0200 # Use GS instead of FNC1 as GS1 separator (Data Matrix) */
+      OUT_BUFFER_INTERMEDIATE = 0x0400 # Return ASCII values in bitmap buffer (OUT_BUFFER only) */
+      BARCODE_QUIET_ZONES = 0x0800 # Add compliant quiet zones (additional to any specified whitespace); Note: CODE16K, CODE49, CODABLOCKF, ITF14, EAN/UPC have default quiet zones */
+      BARCODE_NO_QUIET_ZONES = 0x1000 # Disable quiet zones, notably those with defaults as listed above */
+      COMPLIANT_HEIGHT = 0x2000 # Warn if height not compliant and use standard height (if any) as default */
     end
   end
 end

data/lib/zint/constants/symbologies.rb

@@ -35,25 +35,27 @@ module Zint
       BARCODE_UPCA_CHK = 35 #  UPC-A + Check Digit
       BARCODE_UPCE = 37 #  UPC-E
       BARCODE_UPCE_CHK = 38 #  UPC-E + Check Digit
-      BARCODE_POSTNET = 40 #  USPS POSTNET
+      BARCODE_POSTNET = 40 # USPS (U.S. Postal Service) POSTNET
       BARCODE_MSI_PLESSEY = 47 #  MSI Plessey
       BARCODE_FIM = 49 #  Facing Identification Mark
       BARCODE_LOGMARS = 50 #  LOGMARS
       BARCODE_PHARMA = 51 #  Pharmacode One-Track
       BARCODE_PZN = 52 #  Pharmazentralnummer
       BARCODE_PHARMA_TWO = 53 #  Pharmacode Two-Track
+      BARCODE_CEPNET = 54  # Brazilian CEPNet Postal Code
       BARCODE_PDF417 = 55 #  PDF417
       BARCODE_PDF417COMP = 56 #  Compact PDF417 (Truncated PDF417)
       BARCODE_PDF417TRUNC = 56 #  Legacy
       BARCODE_MAXICODE = 57 #  MaxiCode
       BARCODE_QRCODE = 58 #  QR Code
-      BARCODE_CODE128B = 60 #  Code 128 (Subset B)
+      BARCODE_CODE128AB = 60 #  Code 128 (Suppress subset C)
+      BARCODE_CODE128B = 60 # Legacy
       BARCODE_AUSPOST = 63 #  Australia Post Standard Customer
       BARCODE_AUSREPLY = 66 #  Australia Post Reply Paid
       BARCODE_AUSROUTE = 67 #  Australia Post Routing
       BARCODE_AUSREDIRECT = 68 #  Australia Post Redirection
       BARCODE_ISBNX = 69 #  ISBN
-      BARCODE_RM4SCC = 70 #  Royal Mail 4 State
+      BARCODE_RM4SCC = 70 #  Royal Mail 4-State Customer Code
       BARCODE_DATAMATRIX = 71 #  Data Matrix (ECC200)
       BARCODE_EAN14 = 72 #  EAN-14
       BARCODE_VIN = 73 #  Vehicle Identification Number
@@ -71,7 +73,7 @@ module Zint
       BARCODE_MICROPDF417 = 84 #  MicroPDF417
       BARCODE_USPS_IMAIL = 85 #  USPS Intelligent Mail (OneCode)
       BARCODE_ONECODE = 85 #  Legacy
-      BARCODE_PLESSEY = 86 #  Plessey Code
+      BARCODE_PLESSEY = 86 #  UK Plessey
 
       #  Tbarcode 8 codes
       BARCODE_TELEPEN_NUM = 87 #  Telepen Numeric
@@ -83,7 +85,7 @@ module Zint
       BARCODE_MICROQR = 97 #  Micro QR Code
 
       #  Tbarcode 9 codes
-      BARCODE_HIBC_128 = 98 #  HIBC Code 128
+      BARCODE_HIBC_128 = 98 #  HIBC (Health Industry Barcode) Code 128
       BARCODE_HIBC_39 = 99 #  HIBC Code 39
       BARCODE_HIBC_DM = 102 #  HIBC Data Matrix
       BARCODE_HIBC_QR = 104 #  HIBC QR Code
@@ -97,7 +99,10 @@ module Zint
       BARCODE_HANXIN = 116 #  Han Xin (Chinese Sensible) Code
 
       #  Tbarcode 11 codes
-      BARCODE_MAILMARK = 121 #  Royal Mail 4-state Mailmark
+      BARCODE_MAILMARK_2D = 119 # Royal Mail 2D Mailmark (CMDM) (Data Matrix)
+      BARCODE_UPU_S10 = 120 # Universal Postal Union S10
+      BARCODE_MAILMARK_4S = 121 # Royal Mail 4-State Mailmark
+      BARCODE_MAILMARK = 121 # Legacy
 
       #  Zint specific
       BARCODE_AZRUNE = 128 #  Aztec Runes
@@ -125,6 +130,8 @@ module Zint
       BARCODE_UPNQR = 143 #  UPNQR (Univerzalnega Plačilnega Naloga QR)
       BARCODE_ULTRA = 144 #  Ultracode
       BARCODE_RMQR = 145 #  Rectangular Micro QR Code (rMQR)
+      BARCODE_BC412 = 146 # IBM BC412 (SEMI T1-95)
+      BARCODE_LAST = 146 # Max barcode number marker, not barcode
     end
   end
 end

data/lib/zint/constants/warn_levels.rb

@@ -1,6 +1,6 @@
 module Zint
   module Constants
-    # Warning warn (`symbol->warn_level`)
+    # Warning level (`symbol->warn_level`)
     module WarnLevels
       WARN_DEFAULT = 0  # Default behaviour
       WARN_FAIL_ALL = 2 # Treat warning as error

data/lib/zint/daft.rb

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

data/lib/zint/data_matrix.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Data Matrix (ECC200)
   class DataMatrix < Barcode
     # Options
     DM_NULL = 0

data/lib/zint/dbarexp.rb

@@ -1,4 +1,5 @@
 module Zint
+  # GS1 DataBar Expanded
   class DbarExp < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DBAR_EXP, options: options)

data/lib/zint/dbarexpstk.rb

@@ -1,4 +1,5 @@
 module Zint
+  # GS1 DataBar Expanded Stacked
   class DbarExpstk < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DBAR_EXPSTK, options: options)

data/lib/zint/dbarltd.rb

@@ -1,4 +1,5 @@
 module Zint
+  #  GS1 DataBar Limited
   class DbarLtd < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DBAR_LTD, options: options)

data/lib/zint/dbaromn.rb

@@ -1,4 +1,5 @@
 module Zint
+  # GS1 DataBar Omnidirectional
   class DbarOmn < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DBAR_OMN, options: options)

data/lib/zint/dbaromnstk.rb

@@ -1,4 +1,5 @@
 module Zint
+  # GS1 DataBar Stacked Omnidirectional
   class DbarOmnstk < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DBAR_OMNSTK, options: options)

data/lib/zint/dbarstk.rb

@@ -1,4 +1,5 @@
 module Zint
+  # GS1 DataBar Stacked
   class DbarStk < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DBAR_STK, options: options)

data/lib/zint/dependencies.rb

@@ -1,8 +1,8 @@
 module Zint
-  ZINT_VERSION = ENV["ZINT_VERSION"] || "2.10.0"
+  ZINT_VERSION = ENV["ZINT_VERSION"] || "2.12.0"
   # ZINT_SOURCE_URI = "file://#{File.join(File.expand_path("../../../", __FILE__))}/ports/archives/zint-#{ZINT_VERSION}-src.tar.gz"
   ZINT_SOURCE_URI = "https://downloads.sourceforge.net/zint/zint-#{ZINT_VERSION}-src.tar.gz"
-  ZINT_SOURCE_SHA1 = "e4a8a5ccbc9e1901e4b592ccc80e17184f2ff5e8"
+  ZINT_SOURCE_SHA1 = "6e16036d9822895edededd96e65da755ef3fdb69"
 
   MINI_PORTILE_VERSION = "~> 2.1"
 end

data/lib/zint/dot_code.rb

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

data/lib/zint/dpd.rb

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

data/lib/zint/dpident.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Deutsche Post Identcode
   class Dpident < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DPIDENT, options: options)

data/lib/zint/dpleit.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Deutsche Post Leitcode
   class Dpleit < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_DPLEIT, options: options)

data/lib/zint/ean128.rb

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

data/lib/zint/ean14.rb

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

data/lib/zint/eanx.rb

@@ -1,4 +1,5 @@
 module Zint
+  # EAN (European Article Number)
   class Eanx < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_EANX, options: options)

data/lib/zint/eanxchk.rb

@@ -1,4 +1,5 @@
 module Zint
+  # EAN + Check Digit
   class EanxChk < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_EANX_CHK, options: options)

data/lib/zint/excode39.rb

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

data/lib/zint/fim.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Facing Identification Mark
   class Fim < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_FIM, options: options)

data/lib/zint/flat.rb

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

data/lib/zint/grid_matrix.rb

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

data/lib/zint/gs1_128.rb

@@ -1,5 +1,6 @@
 module Zint
   # standard:disable Naming/ClassAndModuleCamelCase
+  # GS1-128
   class Gs1_128 < Barcode
     # standard:enable Naming/ClassAndModuleCamelCase
     def initialize(value: nil, input_file: nil, options: {})

data/lib/zint/hanxin.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Han Xin (Chinese Sensible) Code
   class Hanxin < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_HANXIN, options: options)

data/lib/zint/hibc128.rb

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

data/lib/zint/hibc39.rb

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

data/lib/zint/hibcaztec.rb

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

data/lib/zint/hibcblockf.rb

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

data/lib/zint/hibcdm.rb

@@ -1,4 +1,5 @@
 module Zint
+  # HIBC Data Matrix
   class HibcDm < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_HIBC_DM, options: options)

data/lib/zint/hibcmicpdf.rb

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

data/lib/zint/hibcpdf.rb

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

data/lib/zint/hibcqr.rb

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

data/lib/zint/isbnx.rb

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

data/lib/zint/itf14.rb

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

data/lib/zint/japan_post.rb

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

data/lib/zint/kix.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Dutch Post KIX Code
   class Kix < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_KIX, options: options)

data/lib/zint/korea_post.rb

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

data/lib/zint/logmars.rb

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

data/lib/zint/mailmark.rb

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

data/lib/zint/mailmark_2d.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Royal Mail 2D Mailmark (CMDM) (Data Matrix)
+  class Mailmark2D < Barcode
+    def initialize(value: nil, input_file: nil, options: {})
+      super(value: value, input_file: input_file, type: Zint::BARCODE_MAILMARK_2D, options: options)
+    end
+  end
+end

data/lib/zint/mailmark_4s.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Royal Mail 4-State Mailmark
+  class Mailmark4S < Barcode
+    def initialize(value: nil, input_file: nil, options: {})
+      super(value: value, input_file: input_file, type: Zint::BARCODE_MAILMARK_4S, options: options)
+    end
+  end
+end

data/lib/zint/maxi_code.rb

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

data/lib/zint/micro_pdf417.rb

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

data/lib/zint/micro_qr.rb

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

data/lib/zint/msiplessey.rb

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

data/lib/zint/native.rb

@@ -5,7 +5,7 @@ module Zint
     root_path = File.expand_path("../../..", __FILE__)
     prefix = FFI::Platform::LIBPREFIX.empty? ? "lib" : FFI::Platform::LIBPREFIX
     bundled_dll = File.join(root_path, "lib/#{prefix}zint.#{FFI::Platform::LIBSUFFIX}")
-    ffi_lib [bundled_dll, "libzint.so.2.10", "libzint", "zint"]
+    ffi_lib [bundled_dll, "libzint.so.2.12", "libzint", "zint"]
 
     # Error codes (API return values)
     enum :error_code, [Constants::Warnings::WARNINGS, Constants::Errors::ERRORS].map { |h| h.to_a }.flatten

data/lib/zint/nve18.rb

@@ -1,4 +1,5 @@
 module Zint
+  # NVE-18 (SSCC-18)
   class Nve18 < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_NVE18, options: options)

data/lib/zint/one_code.rb

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

data/lib/zint/pdf417.rb

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

data/lib/zint/pdf417comp.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Compact PDF417 (Truncated PDF417)
   class Pdf417comp < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_PDF417COMP, options: options)

data/lib/zint/pdf417trunc.rb

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

data/lib/zint/pharma.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Pharmacode One-Track
   class Pharma < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_PHARMA, options: options)

data/lib/zint/pharmatwo.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Pharmacode Two-Track
   class PharmaTwo < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_PHARMA_TWO, options: options)

data/lib/zint/planet.rb

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

data/lib/zint/plessey.rb

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

data/lib/zint/postnet.rb

@@ -1,4 +1,5 @@
 module Zint
+  # USPS (U.S. Postal Service) POSTNET
   class Postnet < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_POSTNET, options: options)

data/lib/zint/pzn.rb

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

data/lib/zint/qr.rb

@@ -1,4 +1,5 @@
 module Zint
+  # QR Code
   class Qr < Barcode
     # ECC Levels
     ECC_LEVEL_L = 1

data/lib/zint/rmqr.rb

@@ -1,4 +1,5 @@
 module Zint
+  # Rectangular Micro QR Code (rMQR)
   class Rmqr < Barcode
     def initialize(value: nil, input_file: nil, options: {})
       super(value: value, input_file: input_file, type: Zint::BARCODE_RMQR, options: options)

data/lib/zint/rss14.rb

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

data/lib/zint/rss14stack.rb

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

data/lib/zint/rss14stackomni.rb

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

data/lib/zint/rssexp.rb

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

data/lib/zint/rssexpstack.rb

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

data/lib/zint/rssltd.rb

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

data/lib/zint/structs/structapp.rb

@@ -0,0 +1,25 @@
+module Zint
+  module Structs
+    #  Structured Append info - ignored unless `zint_structapp.count` is set to non-zero value
+    class Structapp < FFI::Struct
+      layout :index, :int, # Position in Structured Append sequence, 1-based. Must be <= `count`
+        :count, :int, # Number of symbols in Structured Append sequence. Set >= 2 to add SA Info
+        :id, [:char, 32] # Optional ID to distinguish sequence, ASCII, NUL-terminated unless max 32 long
+
+      # Position in Structured Append sequence, 1-based. Must be <= `count`
+      def index
+        self[:index]
+      end
+
+      # Number of symbols in Structured Append sequence. Set >= 2 to add SA Info
+      def count
+        self[:count]
+      end
+
+      # Optional ID to distinguish sequence, ASCII, NUL-terminated unless max 32 long
+      def id
+        self[:id]
+      end
+    end
+  end
+end