pdfrb 0.7.33 → 0.7.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7df27df1b605b7360c642707bcb6496b6316d52dc7bbf9373acd7127f2098513
-  data.tar.gz: 121359ec98110dca31e4c3e6f1c11fa00a0a6a3cdf3fa70a2749d2b34566f8c7
+  metadata.gz: ad01ecf1a7f70ecba1d47e315442c0bf8f855409126d234734e15f7e577b56ee
+  data.tar.gz: f51fd9f743922d396f5b2126cf6ae8e5dc6be4664969dc3f5cfa175642c15309
 SHA512:
-  metadata.gz: d6d55dcf0d53c4d21d6bb149affda69999eec6580177a50f8f4dbf6988df3f9933a2c67d16ba3a6acebb4c9a1b376cc05f04641ff5347cd4dd9451502c08a9fd
-  data.tar.gz: 7080ccf0f4416a5f84214b9a0b83ce673cf9722d9cd4a481998579c370b90f3aa0ce9a608ecd481d6269995221a01769f70eecef4da08b5da6ca9658f5ff28cc
+  metadata.gz: a58c6d6ab22846f316597741a0ab027e8b9859cf31e0f59e0e1b4dc99c6c07dcbe35e2d1d6a8aad055e9f8d3287a699a008e5c123b2c65d24cdc2bfab99beafc
+  data.tar.gz: a212dc856e1d245030cbabf346a896136c156ba9ef5444c300732974c94dee7c5ef4cb40aed1783cc305e9745b2b6b68fea17c9f9eef3ae8d927294832dc3f54

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

@@ -54,6 +54,21 @@ module Pdfrb
         def small_cap?; flags&.anybits?(0x20000); end
         def force_bold?; flags&.anybits?(0x40000); end
       end
+
+      # Font descriptor for TrueType fonts (s9.6.6.2): allows
+      # /FontFile2 embedding.
+      class FontDescriptorTrueType < FontDescriptor
+        arlington_object "FontDescriptorTrueType"
+
+        def font_file2; self[:FontFile2]; end
+        def font_file3; self[:FontFile3]; end
+      end
+
+      # Font descriptor for Type 3 fonts (s9.6.6.2): never carries
+      # font-file keys.
+      class FontDescriptorType3 < FontDescriptor
+        arlington_object "FontDescriptorType3"
+      end
     end
   end
 end

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

@@ -18,6 +18,25 @@ module Pdfrb
         def type1c?; subtype == :Type1C; end
         def truetype?; subtype == :TrueType; end
       end
+
+      # FontFile3 with /Subtype /Type1C: CFF glyph program for Type 1
+      # fonts (s9.6.6.2).
+      class FontFile3Type1 < FontFile3
+        arlington_object "FontFile3Type1"
+      end
+
+      # FontFile3 with /Subtype /CIDFontType0C: CFF program for CID
+      # fonts (s9.7.5.2).
+      class FontFile3CIDType0 < FontFile3
+        arlington_object "FontFile3CIDType0"
+      end
+
+      # FontFile3 with /Subtype /OpenType: OpenType wrapper whose
+      # table directory offsets are relative to the stream start
+      # (s9.6.6.4).
+      class FontFile3OpenType < FontFile3
+        arlington_object "FontFile3OpenType"
+      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/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/soft_mask.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Soft-mask dictionary /SMask in an ExtGState (s11.6.5.2).
+      # The transfer function TR and backdrop color BC apply while
+      # compositing the mask group G.
+      class SoftMaskAlpha < Pdfrb::Model::Cos::Dictionary
+        arlington_object "SoftMaskAlpha"
+
+        def type; self[:Type]; end
+        def subtype; self[:S]; end
+        def group; self[:G]; end
+        def backdrop_color; self[:BC]; end
+        def transfer_function; self[:TR]; end
+
+        def alpha?; true; end
+        def luminosity?; false; end
+      end
+
+      # Luminosity soft mask (s11.6.5.3): the group's luminosity
+      # drives the mask.
+      class SoftMaskLuminosity < Pdfrb::Model::Cos::Dictionary
+        arlington_object "SoftMaskLuminosity"
+
+        def type; self[:Type]; end
+        def subtype; self[:S]; end
+        def group; self[:G]; end
+        def backdrop_color; self[:BC]; end
+        def transfer_function; self[:TR]; end
+
+        def alpha?; false; end
+        def luminosity?; true; end
+      end
+
+      # Resources /ExtGState dictionary (s7.8.3): name ->
+      # ExtGState dictionaries.
+      class GraphicsStateParameterMap < Pdfrb::Model::Cos::Dictionary
+        arlington_object "GraphicsStateParameterMap"
+
+        def [](name)
+          value[name.to_sym] || value[name.to_s]
+        end
+
+        def add(name, parameters)
+          value[name.to_sym] = parameters
+          name.to_sym
+        end
+
+        def names
+          value.keys
+        end
+      end
+
+      # Transparency group /Group dictionary (s11.2.4.5): isolation
+      # and knockout flags, blending color space.
+      class GroupAttributes < Pdfrb::Model::Cos::Dictionary
+        arlington_object "GroupAttributes"
+
+        def type; self[:Type]; end
+        def subtype; self[:S]; end
+        def color_space; self[:CS]; end
+        def isolated?; self[:I] == true; end
+        def knockout?; self[:K] == true; end
+
+        def transparency_group?
+          subtype == :Transparency
+        end
+      end
+    end
+  end
+end

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

@@ -49,6 +49,60 @@ module Pdfrb
           arr[0] == 1 && arr[1].zero? && arr[2].zero? && arr[3] == 1 && arr[4].zero? && arr[5].zero?
         end
       end
+
+      # PostScript XObject /Subtype /PS (s8.8.2): Level-1 PostScript
+      # fallback rendering.
+      class XObjectFormPS < Pdfrb::Model::Cos::Stream
+        arlington_object "XObjectFormPS"
+
+        def level1; self[:Level1]; end
+      end
+
+      # PostScript passthrough XObject (s8.8.2, PDF 1.3 PS extension
+      # /Subtype2 /PS): embedded PS consumed by passthrough printers.
+      class XObjectFormPSpassthrough < Pdfrb::Model::Cos::Stream
+        arlington_object "XObjectFormPSpassthrough"
+
+        def level1; self[:Level1]; end
+        def postscript; self[:PS]; end
+      end
+
+      # Printer's mark form XObject (s14.11.4): registration styles.
+      class XObjectFormPrinterMark < Pdfrb::Model::Cos::Stream
+        arlington_object "XObjectFormPrinterMark"
+
+        def mark_style; self[:MarkStyle]; end
+        def colorants; self[:Colorants]; end
+      end
+
+      # Trap network appearance form XObject (s14.11.2):
+      # trapping parameters.
+      class XObjectFormTrapNet < Pdfrb::Model::Cos::Stream
+        arlington_object "XObjectFormTrapNet"
+
+        def pcm; self[:PCM]; end
+        def separation_color_names; self[:SeparationColorNames]; end
+        def trap_regions; self[:TrapRegions]; end
+        def trap_styles; self[:TrapStyles]; end
+      end
+
+      # Resources /XObject dictionary (s7.8.3): name -> XObject.
+      class XObjectMap < Pdfrb::Model::Cos::Dictionary
+        arlington_object "XObjectMap"
+
+        def [](name)
+          value[name.to_sym] || value[name.to_s]
+        end
+
+        def add(name, xobject)
+          value[name.to_sym] = xobject
+          name.to_sym
+        end
+
+        def names
+          value.keys
+        end
+      end
     end
   end
 end

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

@@ -64,6 +64,28 @@ module Pdfrb
           ((width * components * bits_per_component) + 7) / 8
         end
       end
+
+      # Image-mask image XObject /ImageMask true (s8.9.6.4):
+      # 1-bpp stencil painted with the current fill color.
+      class XObjectImageMask < Pdfrb::Model::Cos::Stream
+        arlington_object "XObjectImageMask"
+
+        def width; self[:Width]; end
+        def height; self[:Height]; end
+        def decode; self[:Decode]; end
+
+        # /Decode [0 1] = paint 1-bits; [1 0] = inverted.
+        def inverted?; decode && decode[0] == 1; end
+      end
+
+      # Soft-mask image XObject (s8.9.6.5): grayscale companion used
+      # as a shape/opacity mask via /SMask.
+      class XObjectImageSoftMask < Pdfrb::Model::Cos::Stream
+        arlington_object "XObjectImageSoftMask"
+
+        def color_space; self[:ColorSpace]; end
+        def matte; self[:Matte]; end
+      end
     end
   end
 end

data/lib/pdfrb/model/type.rb

@@ -121,6 +121,22 @@ module Pdfrb
       autoload :FontDescriptorCIDType2, "pdfrb/model/type/font_descriptor_cid_type2"
       autoload :ToUnicodeCMapStream, "pdfrb/model/type/to_unicode_cmap_stream"
       autoload :XObjectForm, "pdfrb/model/type/xobject_form"
+      autoload :XObjectFormPS, "pdfrb/model/type/xobject_form"
+      autoload :XObjectFormPSpassthrough, "pdfrb/model/type/xobject_form"
+      autoload :XObjectFormPrinterMark, "pdfrb/model/type/xobject_form"
+      autoload :XObjectFormTrapNet, "pdfrb/model/type/xobject_form"
+      autoload :XObjectMap, "pdfrb/model/type/xobject_form"
+      autoload :XObjectImageMask, "pdfrb/model/type/xobject_image"
+      autoload :XObjectImageSoftMask, "pdfrb/model/type/xobject_image"
+      autoload :FontFile3Type1, "pdfrb/model/type/font_file3"
+      autoload :FontFile3CIDType0, "pdfrb/model/type/font_file3"
+      autoload :FontFile3OpenType, "pdfrb/model/type/font_file3"
+      autoload :FontDescriptorTrueType, "pdfrb/model/type/font_descriptor"
+      autoload :FontDescriptorType3, "pdfrb/model/type/font_descriptor"
+      autoload :SoftMaskAlpha, "pdfrb/model/type/soft_mask"
+      autoload :SoftMaskLuminosity, "pdfrb/model/type/soft_mask"
+      autoload :GraphicsStateParameterMap, "pdfrb/model/type/soft_mask"
+      autoload :GroupAttributes, "pdfrb/model/type/soft_mask"
       autoload :XObjectImage, "pdfrb/model/type/xobject_image"
 
       # Function family (s8.9).
@@ -311,6 +327,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"
 

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.33
+  version: 0.7.35
 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
@@ -1143,6 +1143,7 @@ files:
 - lib/pdfrb/model/type/signature.rb
 - lib/pdfrb/model/type/signature_build.rb
 - lib/pdfrb/model/type/signature_field.rb
+- lib/pdfrb/model/type/soft_mask.rb
 - lib/pdfrb/model/type/software_identifier.rb
 - lib/pdfrb/model/type/sound.rb
 - lib/pdfrb/model/type/sound_annotation.rb