pdfrb 0.7.33 → 0.7.34

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7df27df1b605b7360c642707bcb6496b6316d52dc7bbf9373acd7127f2098513
-  data.tar.gz: 121359ec98110dca31e4c3e6f1c11fa00a0a6a3cdf3fa70a2749d2b34566f8c7
+  metadata.gz: 63bc7a84b2c25516f6471a8ef25aa513cd952ba83ea17b7bc3dd2c73171da943
+  data.tar.gz: 8b0177a111dbdf1746f4ad128ec4c1a0fcd4d8d95ca74c8f429708f3c269290e
 SHA512:
-  metadata.gz: d6d55dcf0d53c4d21d6bb149affda69999eec6580177a50f8f4dbf6988df3f9933a2c67d16ba3a6acebb4c9a1b376cc05f04641ff5347cd4dd9451502c08a9fd
-  data.tar.gz: 7080ccf0f4416a5f84214b9a0b83ce673cf9722d9cd4a481998579c370b90f3aa0ce9a608ecd481d6269995221a01769f70eecef4da08b5da6ca9658f5ff28cc
+  metadata.gz: 631ee3dcb0e45ac7ac4801491ab40aed9e8aeaea85bdc966d11ab7f1f06f498654a395d7a1ddc40be63fd8dbf3338a1fe72a6eb27e47ebce1dc3cb132b0e6841
+  data.tar.gz: e744fa0dd1887afb443ba54f8605638a102c2f5e3e6174ab090bd6a31a970b0c07424d7ba3ce751c1f6a61b629df7f47a702152e767e7d08933e4dcff1e25140

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.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"
 

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.33
+  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