pdfrb 0.7.42 → 0.7.43

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab4ad0a762217c8fdfc88589f78152f7ec382f5192cec734457cdba1c538139a
-  data.tar.gz: 1850f2ae9b0fa99006c5fa0fbdc4d290929c72aa5b5f990e30275eab8c19a66b
+  metadata.gz: b0b004db58a66ef4268db7138eb13c2813fcceb4e22a492674597f631d6f889e
+  data.tar.gz: b29ee27e11e4aea41a482e3eb217c7ddf70a5cdf4b21f70b2d16be01747822df
 SHA512:
-  metadata.gz: 37b7a245a79cbf85cbaf8e82b353da55c01b688453589ce7b9bcd4e58a6a8acd988702e5a2af564a0a1516e5f554af32b36c8ca2b7db98a8ef03572b26b49f80
-  data.tar.gz: d3430314391486f081de9a2723857f0c266dff32c3e88487f6e409d6d74a16fdc348003d736b7af202de2761c3608dc48808832f08ed2c45c0b8ff245dd49493
+  metadata.gz: 25dc0c66f65bf454f2ac91c362031c57720d060edaeb54912aba896115216fbe43ce4fd947e21e94a445e521168e1eb629d51db42dc38c9ca5639ca41e8786e5
+  data.tar.gz: 3368f119c878bb7bcce11f21a4bd6edb267e4605ae079ca85dafbce6defa1397e9b5f0649bbdfc3a7084d161eb0f6c20da934b5b0f288344538f296703a031c7

data/lib/pdfrb/content/inline_image.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Content
+    # A BI ... ID ... EI inline image (s8.9.7). Carries the expanded
+    # header keys (abbreviations resolved by the parser), the raw
+    # encoded byte payload, and decodes on demand via the filter
+    # pipeline.
+    class InlineImage
+      # Filter-name abbreviations permitted in inline images
+      # (s8.9.7 Table 89).
+      FILTER_ABBREVIATIONS = {
+        AHx: :ASCIIHexDecode,
+        A85: :ASCII85Decode,
+        Fl: :FlateDecode,
+        LZW: :LZWDecode,
+        CCF: :CCITTFaxDecode,
+        DCT: :DCTDecode,
+        RL: :RunLengthDecode,
+      }.freeze
+
+      # Color-space-name abbreviations (s8.9.7 Table 89).
+      COLOR_SPACE_ABBREVIATIONS = {
+        G: :DeviceGray,
+        RGB: :DeviceRGB,
+        CMYK: :DeviceCMYK,
+        I: :Indexed,
+      }.freeze
+
+      attr_reader :header, :data
+
+      def initialize(header: {}, data: "")
+        @header = header.dup.freeze
+        @data = (data || "".b).dup.freeze
+      end
+
+      def width; header[:Width]; end
+      def height; header[:Height]; end
+      def bits_per_component; header[:BitsPerComponent]; end
+
+      def image_mask?
+        [true, 1].include?(header[:ImageMask])
+      end
+
+      def decode; header[:Decode]; end
+      def interpolate?; header[:Interpolate] == true; end
+
+      # /ColorSpace with the inline abbreviation expanded
+      # (/G -> /DeviceGray etc.).
+      def color_space
+        cs = header[:ColorSpace]
+        return nil unless cs.is_a?(::Symbol)
+
+        COLOR_SPACE_ABBREVIATIONS.fetch(cs, cs)
+      end
+
+      # Decoded filter chain as an array of Symbols; nil when the
+      # image data is stored raw.
+      def filters
+        f = header[:Filter]
+        return [] if f.nil?
+
+        arr = f.is_a?(::Array) ? f : [f]
+        arr.map { |name| FILTER_ABBREVIATIONS.fetch(name.to_sym, name.to_sym) }
+      end
+
+      # Apply the filter chain to the raw payload. Returns the raw
+      # data when no filter is declared.
+      def decoded_data
+        list = filters
+        return @data if list.empty?
+
+        Pdfrb::Filter.apply(
+          @data, filters: list, parms: Array(header[:DecodeParms]),
+                 direction: :decode
+        )
+      end
+
+      # Number of colour components implied by /ColorSpace.
+      def components
+        case color_space
+        when :DeviceGray, :Indexed then 1
+        when :DeviceRGB then 3
+        when :DeviceCMYK then 4
+        end
+      end
+
+      # Expected decoded byte count: rows * width * components *
+      # bits, packed per row.
+      def expected_decoded_size
+        return nil if width.nil? || height.nil? || bits_per_component.nil?
+        return nil if image_mask?
+
+        comps = components
+        return nil if comps.nil?
+
+        bits = width * comps * bits_per_component
+        bytes_per_row = (bits + 7) / 8
+        bytes_per_row * height
+      end
+    end
+  end
+end

data/lib/pdfrb/content/operator.rb

@@ -12,6 +12,12 @@ module Pdfrb
     module Operator
       @registry = {}
 
+      # Referenced directly by the Parser for BI ... ID ... EI
+      # sequences; the remaining operator classes load via
+      # eager_load! / Operator[].
+      autoload :BeginInlineImage, "pdfrb/content/operators/inline_image"
+      autoload :EndInlineImage, "pdfrb/content/operators/inline_image"
+
       class << self
         attr_reader :registry
 

data/lib/pdfrb/content/operators/inline_image.rb

@@ -29,8 +29,8 @@ module Pdfrb
           def invoke(processor, image = nil)
             processor.inline_image(image) if image
           end
-          register
         end
+        register
       end
 
       class EndInlineImage < Base
@@ -38,8 +38,8 @@ module Pdfrb
           def name; "EI"; end
 
           def invoke(_processor, *_operands); end
-          register
         end
+        register
       end
     end
   end

data/lib/pdfrb/content/operators.rb

@@ -16,7 +16,6 @@ module Pdfrb
       autoload :GraphicsStateParams, "pdfrb/content/operators/graphics_state_params"
       autoload :MarkedContent, "pdfrb/content/operators/marked_content"
       autoload :Clipping, "pdfrb/content/operators/clipping"
-      autoload :InlineImage, "pdfrb/content/operators/inline_image"
     end
   end
 end

data/lib/pdfrb/content/parser.rb

@@ -82,7 +82,7 @@ module Pdfrb
         # keyword from the data. Read raw bytes until "\nEI" or
         # " EI" terminator.
         data = read_inline_image_data
-        { header: header, data: data }
+        Pdfrb::Content::InlineImage.new(header: header, data: data)
       end
 
       # Map inline-image abbreviation keys to full PDF names per

data/lib/pdfrb/content/processor.rb

@@ -78,9 +78,9 @@ module Pdfrb
       def marked_content_point(_tag, _properties = nil); end
 
       # Called when a BI/ID/EI inline image is encountered in the
-      # content stream. +image+ is a Hash with :header (the image
-      # dict keys, expanded from abbreviations) and :data (the raw
-      # byte payload). Subclasses override to render or extract.
+      # content stream. +image+ is a Content::InlineImage with the
+      # expanded header keys, the raw payload, and decoded_data /
+      # geometry accessors. Subclasses override to render or extract.
       def inline_image(_image); end
     end
   end

data/lib/pdfrb/content.rb

@@ -5,6 +5,7 @@ module Pdfrb
     autoload :GraphicsState, "pdfrb/content/graphics_state"
     autoload :Operator, "pdfrb/content/operator"
     autoload :Parser, "pdfrb/content/parser"
+    autoload :InlineImage, "pdfrb/content/inline_image"
     autoload :Processor, "pdfrb/content/processor"
     autoload :ColorSpace, "pdfrb/content/color_space"
     autoload :TransformationMatrix, "pdfrb/content/transformation_matrix"

data/lib/pdfrb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pdfrb
-  VERSION = "0.7.42"
+  VERSION = "0.7.43"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.42
+  version: 0.7.43
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-25 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -782,6 +782,7 @@ files:
 - lib/pdfrb/content/graphic_object/rectangle.rb
 - lib/pdfrb/content/graphics_state.rb
 - lib/pdfrb/content/hidden_text_detector.rb
+- lib/pdfrb/content/inline_image.rb
 - lib/pdfrb/content/operator.rb
 - lib/pdfrb/content/operators.rb
 - lib/pdfrb/content/operators/clipping.rb