pdfrb 0.7.32 → 0.7.34

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1cd3d8414d6c20ce3716e042003303eb08b96a0b71c0002cbba9fd1b9a21ecd
-  data.tar.gz: 6c40d53aadb7ead589dbf47949e73aba8c09d25750e115801f5307a1d9b82fc5
+  metadata.gz: 63bc7a84b2c25516f6471a8ef25aa513cd952ba83ea17b7bc3dd2c73171da943
+  data.tar.gz: 8b0177a111dbdf1746f4ad128ec4c1a0fcd4d8d95ca74c8f429708f3c269290e
 SHA512:
-  metadata.gz: a8dd8f8136a9563fb5ed3da98841836026e0fca9164db0f5fa1a7379bffa09f4fd86361361fa91bcff999a97947c72a447053eacec02edfc5354c5852c2248f7
-  data.tar.gz: e506eecbd9cb8536cc80e0d79fea1591912de2fedce5d1d5ea092311f8b8c44e013d8befc5c833d5ebb210b94140382f5121f11f0f43bc84bfd6755d90f948d3
+  metadata.gz: 631ee3dcb0e45ac7ac4801491ab40aed9e8aeaea85bdc966d11ab7f1f06f498654a395d7a1ddc40be63fd8dbf3338a1fe72a6eb27e47ebce1dc3cb132b0e6841
+  data.tar.gz: e744fa0dd1887afb443ba54f8605638a102c2f5e3e6174ab090bd6a31a970b0c07424d7ba3ce751c1f6a61b629df7f47a702152e767e7d08933e4dcff1e25140

data/lib/pdfrb/model/cos/dictionary.rb

@@ -172,7 +172,10 @@ module Pdfrb
               return raw[1..-2].split.then { |tokens| tokens.map { |t| arlington_scalar(t) } }
             end
 
-            arlington_scalar(raw)
+            scalar = arlington_scalar(raw)
+            return scalar.to_sym if scalar.is_a?(::String) && field_def.types_raw.include?("name")
+
+            scalar
           end
           private :arlington_default
 

data/lib/pdfrb/model/type/filter_decode_parms.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # FlateDecode /DecodeParms dictionary (s7.4.4.3): predictor
+      # settings shared with LZWDecode.
+      class FlateDecodeParms < Pdfrb::Model::Cos::Dictionary
+        arlington_object "FilterFlateDecode"
+
+        def predictor; self[:Predictor] || 1; end
+        def colors; self[:Colors] || 1; end
+        def bits_per_component; self[:BitsPerComponent] || 8; end
+        def columns; self[:Columns] || 1; end
+
+        def png_predictor?; predictor >= 10; end
+        def tiff_predictor?; predictor == 2; end
+      end
+
+      # LZWDecode /DecodeParms dictionary (s7.4.4.2): adds EarlyChange.
+      class LZWDecodeParms < FlateDecodeParms
+        arlington_object "FilterLZWDecode"
+
+        def early_change; self[:EarlyChange] || 1; end
+      end
+
+      # DCTDecode /DecodeParms dictionary (s7.4.7): color transform.
+      class DCTDecodeParms < Pdfrb::Model::Cos::Dictionary
+        arlington_object "FilterDCTDecode"
+
+        def color_transform; self[:ColorTransform]; end
+
+        # /ColorTransform 0 = four-component YCCK/CMYK input; 1 (or
+        # absent) = three-component YCbCr/RGB.
+        def cmyk_input?
+          !color_transform.nil? && color_transform.zero?
+        end
+      end
+
+      # CCITTFaxDecode /DecodeParms dictionary (s7.4.6): Group 3/4
+      # facsimile parameters.
+      class CCITTFaxDecodeParms < Pdfrb::Model::Cos::Dictionary
+        arlington_object "FilterCCITTFaxDecode"
+
+        def k; self[:K]; end
+        def end_of_line; self[:EndOfLine]; end
+        def encoded_byte_align; self[:EncodedByteAlign]; end
+        def columns; self[:Columns] || 1728; end
+        def rows; self[:Rows]; end
+        def end_of_block; self[:EndOfBlock]; end
+        def black_is_one; self[:BlackIs1]; end
+        def damaged_rows_before_error; self[:DamagedRowsBeforeError]; end
+
+        def group4?; k&.negative?; end
+        def group3_1d?; k&.zero?; end
+        def group3_2d?; k&.positive?; end
+      end
+
+      # JBIG2Decode /DecodeParms dictionary (s7.4.7): global stream ref.
+      class JBIG2DecodeParms < Pdfrb::Model::Cos::Dictionary
+        arlington_object "FilterJBIG2Decode"
+
+        def jbig2_globals; self[:JBIG2Globals]; end
+      end
+
+      # Crypt /DecodeParms dictionary (s7.6.5.5): names the crypt
+      # filter applied to a stream.
+      class CryptDecodeParms < Pdfrb::Model::Cos::Dictionary
+        arlington_object "FilterCrypt"
+
+        def type; self[:Type]; end
+        def name; self[:Name] || :Identity; end
+      end
+    end
+  end
+end

data/lib/pdfrb/model/type/media_clip.rb

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Media Clip Data stream (s13.3.3). Carries actual media payload.
       class MediaClip < Pdfrb::Model::Cos::Stream
+        arlington_object "MediaClipData"
         def type; self[:Type]; end
         def subtype; self[:S]&.to_sym; end
 
@@ -23,6 +24,56 @@ module Pdfrb
           document.object(ref)
         end
       end
+
+      # Media Clip Data MH/BE sub-dictionary (s13.3.3): /BU alternate
+      # file-by-URL used when the primary fails.
+      class MediaClipDataMHBE < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaClipDataMHBE"
+
+        def alternate_url; self[:BU]; end
+      end
+
+      # Media Clip Section stream (s13.3.4): a temporal sub-section
+      # of a MediaClipData.
+      class MediaClipSection < Pdfrb::Model::Cos::Stream
+        arlington_object "MediaClipSection"
+
+        def subtype; self[:S]&.to_sym; end
+        def name; self[:N]; end
+        def duration; self[:D]; end
+        def alternates; self[:Alt]; end
+        def must_honor; self[:MH]; end
+        def best_effort; self[:BE]; end
+      end
+
+      # Section MH/BE sub-dictionary (s13.3.4): begin/end times.
+      class MediaClipSectionMHBE < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaClipSectionMHBE"
+
+        def begin; self[:B]; end
+        def ends; self[:E]; end
+      end
+
+      # Media duration (s13.3.2): /T time value in seconds.
+      class MediaDuration < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaDuration"
+
+        def seconds; self[:T]; end
+      end
+
+      # Media permissions (s13.3.2, Temp-File TF flags): validity
+      # after saving, printing, and extraction.
+      class MediaPermissions < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaPermissions"
+
+        def temp_file_flags; self[:TF]; end
+
+        # Bit 1: media invalid after saving.
+        def invalid_after_save?; !temp_file_flags.nil? && temp_file_flags.nobits?(1); end
+
+        # Bit 2: media invalid after printing.
+        def invalid_after_print?; !temp_file_flags.nil? && temp_file_flags.nobits?(2); end
+      end
     end
   end
 end

data/lib/pdfrb/model/type/media_offset.rb

@@ -108,6 +108,43 @@ module Pdfrb
           !!bit_rate
         end
       end
+
+      # Media play parameters (s13.3.2): controls for playing a
+      # rendition; /MH and /BE wrap the same set.
+      class MediaPlayParameters < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaPlayParameters"
+
+        def players; self[:PL]; end
+        def must_honor; self[:MH]; end
+        def best_effort; self[:BE]; end
+      end
+
+      # Play parameter set for must-honor (s13.2.2): volume V,
+      # controls C, fit F, duration D, repeat count A, audio RC.
+      class MediaPlayParametersMH < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaPlayParametersMH"
+
+        def volume; self[:V]; end
+        def fit; self[:F]; end
+        def duration; self[:D]; end
+        def repeat_count; self[:A]; end
+        def audio_rewrite; self[:RC]; end
+      end
+
+      # Play parameter set for best-effort (s13.2.2).
+      class MediaPlayParametersBE < MediaPlayParametersMH
+        arlington_object "MediaPlayParametersBE"
+      end
+
+      # Screen parameter set for MH/BE (s13.2.2): window W,
+      # background color B, opacity O, duration M, floating F.
+      class MediaScreenParametersMHBE < Pdfrb::Model::Cos::Dictionary
+        arlington_object "MediaScreenParametersMHBE"
+
+        def window; self[:W]; end
+        def background_color; self[:B]; end
+        def opacity; self[:O]; end
+      end
     end
   end
 end

data/lib/pdfrb/model/type/misc_helpers.rb

@@ -71,6 +71,116 @@ module Pdfrb
           decoded_stream&.force_encoding(Encoding::BINARY)
         end
       end
+
+      # Gamma array [r g b] inside the CalRGB dict (s8.6.3.3).
+      class GammaArray < Pdfrb::Model::PdfArray
+        arlington_object "GammaArray"
+
+        def r; self[0]; end
+        def g; self[1]; end
+        def b; self[2]; end
+      end
+
+      # White point [X Y Z] inside Cal dicts (s8.6.3.1).
+      class WhitepointArray < Pdfrb::Model::PdfArray
+        arlington_object "WhitepointArray"
+
+        def x; self[0]; end
+        def y; self[1]; end
+        def z; self[2]; end
+      end
+
+      # Trailer /ID array [id1 id2] (s7.5.5): two 16-byte strings.
+      class TrailerIDArray < Pdfrb::Model::PdfArray
+        arlington_object "TrailerIDArray"
+
+        def id1; self[0]; end
+        def id2; self[1]; end
+      end
+
+      # Visibility expression array (s8.11.4.6):
+      # [operator operand*] with operators /And /Or /Not.
+      class VisibilityExpressionArray < Pdfrb::Model::PdfArray
+        arlington_object "VisibilityExpressionArray"
+
+        def operator; self[0]; end
+
+        def operands
+          rest = self[1..] || []
+          rest.is_a?(Pdfrb::Model::PdfArray) ? rest.to_a : rest
+        end
+
+        def and?; operator == :And; end
+        def or?; operator == :Or; end
+        def not?; operator == :Not; end
+      end
+
+      # FileSpec /RelatedFiles array (s7.11.3.2, deprecation era):
+      # alternating file-name strings and file streams.
+      class RelatedFilesArray < Pdfrb::Model::PdfArray
+        arlington_object "RelatedFilesArray"
+
+        def each_pair
+          return enum_for(:each_pair) unless block_given?
+
+          (0...size).step(2) do |i|
+            yield self[i], self[i + 1]
+          end
+        end
+      end
+
+      # RichMediaExecute /CMD /A arguments array (s13.6.9.6).
+      class RichMediaCommandArray < Pdfrb::Model::PdfArray
+        arlington_object "RichMediaCommandArray"
+      end
+
+      # UR transform permission name arrays (s7.6.5.9): lists of
+      # permitted operation names. One subclass per /Transform
+      # parameter entry.
+      class URTransformParamArray < Pdfrb::Model::PdfArray
+        arlington_object "URTransformParamDocumentArray"
+      end
+
+      class URTransformParamAnnotsArray < URTransformParamArray
+        arlington_object "URTransformParamAnnotsArray"
+      end
+
+      class URTransformParamEFArray < URTransformParamArray
+        arlington_object "URTransformParamEFArray"
+      end
+
+      class URTransformParamFormArray < URTransformParamArray
+        arlington_object "URTransformParamFormArray"
+      end
+
+      class URTransformParamSignatureArray < URTransformParamArray
+        arlington_object "URTransformParamSignatureArray"
+      end
+
+      # Generic catch-all array (Arlington _UniversalArray): any
+      # mix of PDF values.
+      class UniversalArray < Pdfrb::Model::PdfArray
+        arlington_object "_UniversalArray"
+      end
+
+      # Generic catch-all dictionary (Arlington _UniversalDictionary).
+      class UniversalDictionary < Pdfrb::Model::Cos::Dictionary
+        arlington_object "_UniversalDictionary"
+      end
+
+      # /OOAdditionalStms array [name stream]* (PDF 1.5 era
+      # object-order additional streams).
+      class OOAdditionalStmsArray < Pdfrb::Model::PdfArray
+        arlington_object "OOAdditionalStmsArray"
+
+        def each_pair
+          return enum_for(:each_pair) unless block_given?
+
+          (0...size).step(2) do |i|
+            yield self[i], self[i + 1]
+          end
+        end
+      end
     end
   end
 end

data/lib/pdfrb/model/type/rendition.rb

@@ -26,6 +26,40 @@ module Pdfrb
           document.object(ref)
         end
       end
+
+      # Media rendition /S /MR (s13.3.5): plays a media clip.
+      class RenditionMedia < Rendition
+        arlington_object "RenditionMedia"
+
+        def must_honor; self[:MH]; end
+        def best_effort; self[:BE]; end
+        def media_permissions; self[:P]; end
+        def visible_on_page?; self[:SP] != false; end
+      end
+
+      # Selector rendition /S /SR (s13.3.5): picks among renditions.
+      class RenditionSelector < Rendition
+        arlington_object "RenditionSelector"
+
+        def must_honor; self[:MH]; end
+        def best_effort; self[:BE]; end
+        def renditions; self[:R]; end
+      end
+
+      # Must-honor parameter wrapper {C: params} (s13.2.2): the
+      # conforming reader must satisfy these or abort.
+      class RenditionMH < Pdfrb::Model::Cos::Dictionary
+        arlington_object "RenditionMH"
+
+        def parameters; self[:C]; end
+      end
+
+      # Best-effort parameter wrapper {C: params} (s13.2.2).
+      class RenditionBE < Pdfrb::Model::Cos::Dictionary
+        arlington_object "RenditionBE"
+
+        def parameters; self[:C]; end
+      end
     end
   end
 end

data/lib/pdfrb/model/type.rb

@@ -311,6 +311,19 @@ module Pdfrb
       autoload :AppearanceSubDict, "pdfrb/model/type/appearance_trap_net"
       autoload :MediaClip, "pdfrb/model/type/media_clip"
       autoload :Rendition, "pdfrb/model/type/rendition"
+      autoload :RenditionMedia, "pdfrb/model/type/rendition"
+      autoload :RenditionSelector, "pdfrb/model/type/rendition"
+      autoload :RenditionMH, "pdfrb/model/type/rendition"
+      autoload :RenditionBE, "pdfrb/model/type/rendition"
+      autoload :MediaClipDataMHBE, "pdfrb/model/type/media_clip"
+      autoload :MediaClipSection, "pdfrb/model/type/media_clip"
+      autoload :MediaClipSectionMHBE, "pdfrb/model/type/media_clip"
+      autoload :MediaDuration, "pdfrb/model/type/media_clip"
+      autoload :MediaPermissions, "pdfrb/model/type/media_clip"
+      autoload :MediaPlayParameters, "pdfrb/model/type/media_offset"
+      autoload :MediaPlayParametersMH, "pdfrb/model/type/media_offset"
+      autoload :MediaPlayParametersBE, "pdfrb/model/type/media_offset"
+      autoload :MediaScreenParametersMHBE, "pdfrb/model/type/media_offset"
       autoload :ExDataProjection, "pdfrb/model/type/projection_annotation"
       autoload :AnnotationProjectionDict, "pdfrb/model/type/projection_annotation"
 
@@ -330,6 +343,28 @@ module Pdfrb
       autoload :DestOutputProfileRef, "pdfrb/model/type/misc_helpers"
       autoload :OutputIntentsContainer, "pdfrb/model/type/misc_helpers"
       autoload :CMapStream, "pdfrb/model/type/misc_helpers"
+      autoload :GammaArray, "pdfrb/model/type/misc_helpers"
+      autoload :WhitepointArray, "pdfrb/model/type/misc_helpers"
+      autoload :TrailerIDArray, "pdfrb/model/type/misc_helpers"
+      autoload :VisibilityExpressionArray, "pdfrb/model/type/misc_helpers"
+      autoload :RelatedFilesArray, "pdfrb/model/type/misc_helpers"
+      autoload :RichMediaCommandArray, "pdfrb/model/type/misc_helpers"
+      autoload :URTransformParamArray, "pdfrb/model/type/misc_helpers"
+      autoload :URTransformParamAnnotsArray, "pdfrb/model/type/misc_helpers"
+      autoload :URTransformParamEFArray, "pdfrb/model/type/misc_helpers"
+      autoload :URTransformParamFormArray, "pdfrb/model/type/misc_helpers"
+      autoload :URTransformParamSignatureArray, "pdfrb/model/type/misc_helpers"
+      autoload :UniversalArray, "pdfrb/model/type/misc_helpers"
+      autoload :UniversalDictionary, "pdfrb/model/type/misc_helpers"
+      autoload :OOAdditionalStmsArray, "pdfrb/model/type/misc_helpers"
+
+      # Stream filter /DecodeParms dictionaries (s7.4).
+      autoload :FlateDecodeParms, "pdfrb/model/type/filter_decode_parms"
+      autoload :LZWDecodeParms, "pdfrb/model/type/filter_decode_parms"
+      autoload :DCTDecodeParms, "pdfrb/model/type/filter_decode_parms"
+      autoload :CCITTFaxDecodeParms, "pdfrb/model/type/filter_decode_parms"
+      autoload :JBIG2DecodeParms, "pdfrb/model/type/filter_decode_parms"
+      autoload :CryptDecodeParms, "pdfrb/model/type/filter_decode_parms"
 
       # Explicit destination arrays + maps (s12.3.2).
       autoload :Destination, "pdfrb/model/type/destination"

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.32
+  version: 0.7.34
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-23 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -1036,6 +1036,7 @@ files:
 - lib/pdfrb/model/type/file_spec_rf.rb
 - lib/pdfrb/model/type/file_specification.rb
 - lib/pdfrb/model/type/file_trailer.rb
+- lib/pdfrb/model/type/filter_decode_parms.rb
 - lib/pdfrb/model/type/font.rb
 - lib/pdfrb/model/type/font_cid_type0.rb
 - lib/pdfrb/model/type/font_cid_type2.rb