ruby-zint 1.5.0-x86_64-linux-gnu

data/lib/zint/hibcpdf.rb

@@ -0,0 +1,8 @@
+module Zint
+  # HIBC PDF417
+  class HibcPdf < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_HIBC_PDF, **kwargs)
+    end
+  end
+end

data/lib/zint/hibcqr.rb

@@ -0,0 +1,8 @@
+module Zint
+  # HIBC QR Code
+  class HibcQr < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_HIBC_QR, **kwargs)
+    end
+  end
+end

data/lib/zint/isbnx.rb

@@ -0,0 +1,8 @@
+module Zint
+  # ISBN
+  class Isbnx < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_ISBNX, **kwargs)
+    end
+  end
+end

data/lib/zint/itf14.rb

@@ -0,0 +1,8 @@
+module Zint
+  # ITF-14
+  class Itf14 < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_ITF14, **kwargs)
+    end
+  end
+end

data/lib/zint/japan_post.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Japanese Postal Code
+  class JapanPost < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_JAPANPOST, **kwargs)
+    end
+  end
+end

data/lib/zint/kix.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Dutch Post KIX Code
+  class Kix < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_KIX, **kwargs)
+    end
+  end
+end

data/lib/zint/korea_post.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Korea Post
+  class KoreaPost < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_KOREAPOST, **kwargs)
+    end
+  end
+end

data/lib/zint/logmars.rb

@@ -0,0 +1,8 @@
+module Zint
+  # LOGMARS
+  class Logmars < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_LOGMARS, **kwargs)
+    end
+  end
+end

data/lib/zint/mailmark.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class Mailmark < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MAILMARK, **kwargs)
+    end
+  end
+end

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, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MAILMARK_2D, **kwargs)
+    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, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MAILMARK_4S, **kwargs)
+    end
+  end
+end

data/lib/zint/maxi_code.rb

@@ -0,0 +1,8 @@
+module Zint
+  # MaxiCode
+  class MaxiCode < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MAXICODE, **kwargs)
+    end
+  end
+end

data/lib/zint/micro_pdf417.rb

@@ -0,0 +1,8 @@
+module Zint
+  # MicroPDF417
+  class MicroPdf417 < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MICROPDF417, **kwargs)
+    end
+  end
+end

data/lib/zint/micro_qr.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Micro QR Code
+  class MicroQr < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MICROQR, **kwargs)
+    end
+  end
+end

data/lib/zint/msiplessey.rb

@@ -0,0 +1,8 @@
+module Zint
+  # MSI Plessey
+  class MsiPlessey < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_MSI_PLESSEY, **kwargs)
+    end
+  end
+end

data/lib/zint/native.rb

@@ -0,0 +1,106 @@
+module Zint
+  module Native
+    extend FFI::Library
+
+    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}")
+    native_gem1 = File.join(root_path, "lib/3.4/libzint.#{RbConfig::CONFIG["DLEXT"]}") # This is where rake-compiler places the file in the gem
+    native_gem2 = File.join(root_path, "lib/3.0/libzint.#{RbConfig::CONFIG["DLEXT"]}") # ... for non-ucrt windows builds
+    ffi_lib [bundled_dll, native_gem1, native_gem2, "libzint.so.2.15", "libzint", "zint"]
+
+    # Error codes (API return values)
+    enum :error_code, [Constants::Warnings::WARNINGS, Constants::Errors::ERRORS].map { |h| h.to_a }.flatten
+
+    # Aliases for better method signatures
+    typedef Structs::Symbol.by_ref, :zint_symbol
+    typedef :pointer, :filename
+    typedef :int32, :length
+    typedef :int32, :rotate_angle
+    typedef :int32, :symbol_id
+    typedef :uint32, :cap_flag
+    typedef :pointer, :source
+
+    # Create and initialize a symbol structure
+    attach_function(:ZBarcode_Create, [], :zint_symbol, blocking: true)
+
+    # Free any output buffers that may have been created and initialize output fields
+    attach_function(:ZBarcode_Clear, [:zint_symbol], :void, blocking: true)
+
+    # Free a symbol structure, including any output buffers
+    #
+    # For use with ruby's garbage collector ZBarcode_Delete must be called with a plain :pointer and not an :zint_symbol.
+    attach_function(:ZBarcode_Delete, [:pointer], :void, blocking: true)
+
+    # Encode a barcode. If `length` is 0, `source` must be NUL-terminated.
+    attach_function(:ZBarcode_Encode, [:zint_symbol, :source, :length], :error_code, blocking: true)
+
+    # Encode a barcode using input data from file `filename`
+    attach_function(:ZBarcode_Encode_File, [:zint_symbol, :filename], :error_code, blocking: true)
+
+    # Output a previously encoded symbol to file `symbol->outfile`
+    attach_function(:ZBarcode_Print, [:zint_symbol, :rotate_angle], :error_code, blocking: true)
+
+    # Encode and output a symbol to file `symbol->outfile`
+    attach_function(:ZBarcode_Encode_and_Print, [:zint_symbol, :source, :length, :rotate_angle], :error_code, blocking: true)
+
+    # Encode a symbol using input data from file `filename` and output to file `symbol->outfile`
+    attach_function(:ZBarcode_Encode_File_and_Print, [:zint_symbol, :filename, :rotate_angle], :error_code, blocking: true)
+
+    # Output a previously encoded symbol to memory as raster (`symbol->bitmap`)
+    attach_function(:ZBarcode_Buffer, [:zint_symbol, :rotate_angle], :error_code, blocking: true)
+
+    # Encode and output a symbol to memory as raster (`symbol->bitmap`)
+    attach_function(:ZBarcode_Encode_and_Buffer, [:zint_symbol, :source, :length, :rotate_angle], :error_code, blocking: true)
+
+    # Encode a symbol using input data from file `filename` and output to memory as raster (`symbol->bitmap`)
+    attach_function(:ZBarcode_Encode_File_and_Buffer, [:zint_symbol, :filename, :rotate_angle], :error_code, blocking: true)
+
+    # Output a previously encoded symbol to memory as vector (`symbol->vector`)
+    attach_function(:ZBarcode_Buffer_Vector, [:zint_symbol, :rotate_angle], :error_code, blocking: true)
+
+    # Encode and output a symbol to memory as vector (`symbol->vector`)
+    attach_function(:ZBarcode_Encode_and_Buffer_Vector, [:zint_symbol, :source, :length, :rotate_angle], :error_code, blocking: true)
+
+    # Encode a symbol using input data from file `filename` and output to memory as vector (`symbol->vector`)
+    attach_function(:ZBarcode_Encode_File_and_Buffer_Vector, [:zint_symbol, :filename, :rotate_angle], :error_code, blocking: true)
+
+    # ********* Segment support *********
+    # int ZBarcode_Encode_Segs(struct zint_symbol *symbol,
+    #       const struct zint_seg segs[], const int seg_count);
+    attach_function(:ZBarcode_Encode_Segs, [:zint_symbol, :pointer, :int], :error_code, blocking: true)
+
+    # int ZBarcode_Encode_Segs_and_Print(struct zint_symbol *symbol,
+    #       const struct zint_seg segs[], const int seg_count, int rotate_angle);
+    attach_function(:ZBarcode_Encode_Segs_and_Print, [:zint_symbol, :pointer, :int, :rotate_angle], :error_code, blocking: true)
+
+    # int ZBarcode_Encode_Segs_and_Buffer(struct zint_symbol *symbol,
+    #       const struct zint_seg segs[], const int seg_count, int rotate_angle);
+    attach_function(:ZBarcode_Encode_Segs_and_Buffer, [:zint_symbol, :pointer, :int, :rotate_angle], :error_code, blocking: true)
+
+    # int ZBarcode_Encode_Segs_and_Buffer_Vector(struct zint_symbol *symbol,
+    #       const struct zint_seg segs[], const int seg_count, int rotate_angle);
+    attach_function(:ZBarcode_Encode_Segs_and_Buffer_Vector, [:zint_symbol, :pointer, :int, :rotate_angle], :error_code, blocking: true)
+
+    # Is `symbol_id` a recognized symbology?
+    attach_function(:ZBarcode_ValidID, [:symbol_id], :bool, blocking: true)
+
+    # Return the capability flags for symbology `symbol_id` that match `cap_flag`
+    attach_function(:ZBarcode_Cap, [:symbol_id, :cap_flag], :uint32, blocking: true)
+
+    # Return the version of Zint linked to
+    attach_function(:ZBarcode_Version, [], :int32, blocking: true)
+
+    # Raises specific error for API return code
+    #
+    # @param res [Symbol, Integer] API return code
+    # @param text [String] error text
+    # @raise [Error]
+    def self.raise_error(res, text)
+      klass = ERROR_CLASS_FOR_RESULT[res.is_a?(Symbol) ? Zint::ERRORS[res] : res]
+      raise klass, text
+    end
+  end
+
+  private_constant :Native
+end

data/lib/zint/nve18.rb

@@ -0,0 +1,8 @@
+module Zint
+  # NVE-18 (SSCC-18)
+  class Nve18 < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_NVE18, **kwargs)
+    end
+  end
+end

data/lib/zint/one_code.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class OneCode < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_ONECODE, **kwargs)
+    end
+  end
+end

data/lib/zint/pdf417.rb

@@ -0,0 +1,8 @@
+module Zint
+  # PDF417
+  class Pdf417 < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PDF417, **kwargs)
+    end
+  end
+end

data/lib/zint/pdf417comp.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Compact PDF417 (Truncated PDF417)
+  class Pdf417comp < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PDF417COMP, **kwargs)
+    end
+  end
+end

data/lib/zint/pdf417trunc.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class Pdf417trunc < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PDF417TRUNC, **kwargs)
+    end
+  end
+end

data/lib/zint/pharma.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Pharmacode One-Track
+  class Pharma < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PHARMA, **kwargs)
+    end
+  end
+end

data/lib/zint/pharmatwo.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Pharmacode Two-Track
+  class PharmaTwo < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PHARMA_TWO, **kwargs)
+    end
+  end
+end

data/lib/zint/planet.rb

@@ -0,0 +1,8 @@
+module Zint
+  # USPS PLANET
+  class Planet < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PLANET, **kwargs)
+    end
+  end
+end

data/lib/zint/plessey.rb

@@ -0,0 +1,8 @@
+module Zint
+  # UK Plessey
+  class Plessey < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PLESSEY, **kwargs)
+    end
+  end
+end

data/lib/zint/postnet.rb

@@ -0,0 +1,8 @@
+module Zint
+  # USPS (U.S. Postal Service) POSTNET
+  class Postnet < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_POSTNET, **kwargs)
+    end
+  end
+end

data/lib/zint/pzn.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Pharmazentralnummer
+  class Pzn < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_PZN, **kwargs)
+    end
+  end
+end

data/lib/zint/qr.rb

@@ -0,0 +1,18 @@
+module Zint
+  # QR Code
+  class Qr < Barcode
+    # ECC Levels
+    ECC_LEVEL_L = 1
+    ECC_LEVEL_M = 2
+    ECC_LEVEL_Q = 3
+    ECC_LEVEL_H = 4
+
+    # Current ECC level of QR code
+    attr_reader :ecc_level
+
+    def initialize(value: nil, input_file: nil, ecc_level: ECC_LEVEL_L, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_QRCODE, **kwargs.merge(option_1: ecc_level))
+      @ecc_level = ecc_level
+    end
+  end
+end

data/lib/zint/rmqr.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Rectangular Micro QR Code (rMQR)
+  class Rmqr < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RMQR, **kwargs)
+    end
+  end
+end

data/lib/zint/rss14.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class Rss14 < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RSS14, **kwargs)
+    end
+  end
+end

data/lib/zint/rss14stack.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class Rss14stack < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RSS14STACK, **kwargs)
+    end
+  end
+end

data/lib/zint/rss14stackomni.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class Rss14stackOmni < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RSS14STACK_OMNI, **kwargs)
+    end
+  end
+end

data/lib/zint/rssexp.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class RssExp < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RSS_EXP, **kwargs)
+    end
+  end
+end

data/lib/zint/rssexpstack.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class RssExpstack < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RSS_EXPSTACK, **kwargs)
+    end
+  end
+end

data/lib/zint/rssltd.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Legacy
+  class RssLtd < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_RSS_LTD, **kwargs)
+    end
+  end
+end

data/lib/zint/structs/seg.rb

@@ -0,0 +1,26 @@
+module Zint
+  module Structs
+    class Seg < FFI::Struct
+      # /* Segment for use with `raw_segs` and API `ZBarcode_Encode_Segs()` */
+      # struct zint_seg {
+      #     unsigned char *source; /* Data to encode, or (`raw_segs`) data encoded */
+      #     int length;         /* Length of `source`. If 0 or negative, `source` must be NUL-terminated */
+      #     int eci;            /* Extended Channel Interpretation */
+      # };
+
+      layout :source, :pointer, # Data to encode, or (`raw_segs`) data encoded
+        :length, :int, # Length of `source`. If 0 or negative, `source` must be NUL-terminated
+        :eci, :int # Extended Channel Interpretation
+
+      # Data to encode, or (`raw_segs`) data encoded
+      def source
+        self[:source].read_bytes(self[:length])
+      end
+
+      # Extended Channel Interpretation
+      def eci
+        self[:eci]
+      end
+    end
+  end
+end

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

data/lib/zint/structs/symbol.rb

@@ -0,0 +1,57 @@
+module Zint
+  module Structs
+    class Symbol < FFI::ManagedStruct
+      layout :symbology, :int, # Symbol to use (see BARCODE_XXX below)
+        :height, :float, # Barcode height in X-dimensions (ignored for fixed-width barcodes)
+        :scale, :float, # Scale factor when printing barcode, i.e. adjusts X-dimension. Default 1
+        :whitespace_width, :int, # Width in X-dimensions of whitespace to left & right of barcode
+        :whitespace_height, :int, # Height in X-dimensions of whitespace above & below the barcode
+        :border_width, :int, # Size of border in X-dimensions
+        :output_options, :int, # Various output parameters (bind, box etc, see below)
+        :fgcolour, [:char, 16], # Foreground as RGB/RGBA hexadecimal string, 6 or 8 characters, NUL-terminated
+        :bgcolour, [:char, 16], # Background as RGB/RGBA hexadecimal string, 6 or 8 characters, NUL-terminated
+        :fgcolor, :pointer, # Pointer to fgcolour (alternate spelling)
+        :bgcolor, :pointer, # Pointer to bgcolour (alternate spelling)
+        :outfile, [:char, 256], # Name of file to output to, NUL-terminated. Default "out.png" ("out.gif" if NO_PNG)
+        :primary, [:char, 128], # Primary message data (MaxiCode, Composite), NUL-terminated
+        :option_1, :int, # Symbol-specific options (see "../docs/manual.txt")
+        :option_2, :int, # Symbol-specific options
+        :option_3, :int, # Symbol-specific options
+        :show_hrt, :int, # Show (1) or hide (0) Human Readable Text (HRT). Default 1
+        :input_mode, :int, # Encoding of input data (see DATA_MODE etc below). Default DATA_MODE
+        :eci, :int, # Extended Channel Interpretation. Default 0 (none)
+        :dpmm, :float, # Resolution of output in dots per mm (BMP/EMF/PCX/PNG/TIF only). Default 0 (none)
+        :dot_size, :float, # Size of dots used in BARCODE_DOTTY_MODE. Default 0.8
+        :text_gap, :float, # float text_gap;     /* Gap between barcode and text (HRT) in X-dimensions. Default 1 */
+        :guard_descent, :float, # Height in X-dimensions that EAN/UPC guard bars descend. Default 5
+        :structapp, Structapp, # Structured Append info. Default structapp.count 0 (none)
+        :warn_level, :int, # Affects error/warning value returned by Zint API (see WARN_XXX below)
+        :debug, :int, # Debugging flags
+        :text, [:uchar, 256], # Human Readable Text (if any), UTF-8, NUL-terminated (output only)
+        :text_length, :int, # int text_length;    /* Length of text in bytes (output only) */
+        :rows, :int, # Number of rows used by the symbol (output only)
+        :width, :int, # Width of the generated symbol (output only)
+        :encoded_data, [:uchar, 200 * 144], # Encoded data (output only). Allows for rows of 1152 modules
+        :row_height, [:float, 200], # Heights of rows (output only). Allows for 200 row DotCode
+        :errtxt, [:char, 100], # Error message if an error or warning occurs, NUL-terminated (output only)
+        :bitmap, :pointer, # Stored bitmap image (raster output only)
+        :bitmap_width, :int, # Width of bitmap image (raster output only)
+        :bitmap_height, :int, # Height of bitmap image (raster output only)
+        :alphamap, :pointer, # Array of alpha values used (raster output only)
+        :vector, Vector.by_ref, # Pointer to vector header (vector output only)
+        :memfile, :pointer, # unsigned char *memfile; /* Pointer to in-memory file buffer if BARCODE_MEMORY_FILE (output only) */
+        :memfile_size, :int # int memfile_size;   /* Length of in-memory file buffer (output only) */
+
+      # Upcomming zint-2.16:
+      # struct zint_seg *raw_segs; /* Pointer to array of raw segs if BARCODE_RAW_TEXT (output only) */
+      # :raw_segs, Seg.by_ref,
+      # int raw_seg_count;  /* Number of `raw_segs` (output only) */
+      # :raw_seg_count, :int
+
+      # @private
+      def self.release(ptr)
+        Native.ZBarcode_Delete(ptr)
+      end
+    end
+  end
+end

data/lib/zint/structs/vector.rb

@@ -0,0 +1,54 @@
+module Zint
+  module Structs
+    class Vector < FFI::Struct
+      layout :width, :float, # Width, height of barcode image (including text, whitespace)
+        :height, :float,
+        :rectangles, VectorRect.by_ref, # Pointer to first rectangle
+        :hexagons, VectorHexagon.by_ref, # Pointer to first hexagon
+        :strings, VectorString.by_ref, # Pointer to first string
+        :circles, VectorCircle.by_ref # Pointer to first circle
+
+      # Height of barcode image (including text, whitespace)
+      def height
+        self[:height]
+      end
+
+      # Width of barcode image (including text, whitespace)
+      def width
+        self[:width]
+      end
+
+      # Calls the given block and passes a {VectorRect} object for each rectangle to be printed.
+      def each_rectangle(&block)
+        each_vector(:rectangles, &block)
+      end
+
+      # Calls the given block and passes a {VectorHexagon} object for each hexagon to be printed.
+      def each_hexagon(&block)
+        each_vector(:hexagons, &block)
+      end
+
+      # Calls the given block and passes a {VectorString} object for each text string to be printed.
+      def each_string(&block)
+        each_vector(:strings, &block)
+      end
+
+      # Calls the given block and passes a {VectorCircle} object for each circle to be printed.
+      def each_circle(&block)
+        each_vector(:circles, &block)
+      end
+
+      private def each_vector(attr)
+        return to_enum(:each_vector, attr) unless block_given?
+
+        o = self[attr]
+        until o.null?
+          # Avoid garbage collection of Vector (and hence Barcode) before Vector*, since all memory is freed by ZBarcode_Delete()
+          o.instance_variable_set(:@vector, self)
+          yield o
+          o = o[:next]
+        end
+      end
+    end
+  end
+end

data/lib/zint/structs/vector_circle.rb

@@ -0,0 +1,32 @@
+module Zint
+  module Structs
+    class VectorCircle < FFI::Struct
+      layout :x, :float,
+        :y, :float,
+        :diameter, :float, # Circle diameter. Does not include width (if any)
+        :width, :float, # Width of circle perimeter (circumference). 0 for fill (disc)
+        :colour, :int,  # Non-zero for draw with background colour (else draw with foreground colour)
+        :next, VectorCircle.by_ref #  Pointer to next circle
+
+      # x position
+      def x
+        self[:x]
+      end
+
+      # y position
+      def y
+        self[:y]
+      end
+
+      # diameter
+      def diameter
+        self[:diameter]
+      end
+
+      #  Non-zero for draw with background colour
+      def colour
+        self[:colour]
+      end
+    end
+  end
+end