pdfrb 0.7.16 → 0.7.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c59e3261ad38e5013f1adae6c5a5f48197ddfdc6226acd96e7fe09e6d7d9b3a5
-  data.tar.gz: f39fadf09d0a6b8ad2a401111c12384ac3a2fab66f7bbf8c40dc55cc174f1775
+  metadata.gz: 10ae262fc764f359b2eebcfa7384fd94fb41094fc906987fcba0f254fecd0e11
+  data.tar.gz: 6ca04beff81f5a83621caeeff912aa0d4dd4268e1141a8aa8b49479a0efa2465
 SHA512:
-  metadata.gz: 8cc9ef29aa8e9be785306010db555dc7bdac6ddd45c6de13107bb0cf194b5c28091d13b61a321252edc39ec41500b82eb478b338aae88480eae6c51e7861416b
-  data.tar.gz: 14ed721ff08a6a3fc8a6ce8cd3ced4aa09edec502c870d008aef7a9f7374cddcedf8ab4472e3d48773773e4b8530b059ed73fd42ec1ba5988af7ae2cc98cece6
+  metadata.gz: c301c11937103aadbbc335c10649dd2bc8dd5d2b0b12d6673a8b43f5d3961f54362f4fcc8433e69a82fcabc7f2f9c4b123025b556892e9ba423f3af88a59695b
+  data.tar.gz: f9a1cebbde8c0465ae6574d744aa0b4eb059e4e4f594aef81d59f377209fdbc11c7fcf7db2431ff460ea80e211e807b806fbf02b59e6ecd2167c4ee707dabbb7

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

@@ -95,8 +95,8 @@ module Pdfrb
           end
           private :own_fields
 
-          def arlington_loaded_for?(_name)
-            @arlington_loaded_name == name
+          def arlington_loaded_for?(arlington_name)
+            @arlington_loaded_name == arlington_name
           end
           private :arlington_loaded_for?
 
@@ -113,11 +113,23 @@ module Pdfrb
           end
           private :arlington_available?
 
+          # Merge Arlington field metadata with any hand-coded
+          # define_field declaration. Hand-coded fields win: if the
+          # class already declares this key explicitly (with a type),
+          # we rebuild the Field preserving the hand-coded
+          # type/default/required and only attach the Arlington def
+          # for reference.
           def define_field_from_arlington(field_def)
             types = arlington_types_to_ruby(field_def)
             return if types.empty?
 
             key = arlington_key_to_symbol(field_def.key)
+            existing = own_fields[key]
+            if existing
+              own_fields[key] = merged_field(existing, field_def)
+              return
+            end
+
             define_field(
               key,
               type: types.length == 1 ? types.first : types,
@@ -129,6 +141,20 @@ module Pdfrb
           end
           private :define_field_from_arlington
 
+          def merged_field(existing, field_def)
+            Fields::Field.new(
+              existing.pdf_name,
+              type: existing.type,
+              required: existing.required,
+              default: existing.default,
+              indirect: existing.indirect,
+              allowed_values: existing.allowed_values,
+              version: arlington_version(field_def),
+              arlington: field_def
+            )
+          end
+          private :merged_field
+
           def arlington_types_to_ruby(field_def)
             field_def.types.map { |t| arlington_one_type_to_ruby(t) }.flatten.compact.uniq
           end

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

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Sound action (ISO 32000-2 §12.6.4.11, PDF 1.2, deprecated
+      # PDF 2.0). Plays a sound object.
+      class ActionSound < Pdfrb::Model::Cos::Dictionary
+        arlington_object "ActionSound"
+
+        # /Type — optional, fixed "Action".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /S — required, fixed "Sound".
+        def action_type
+          value[:S]&.to_sym
+        end
+
+        # /Sound — required indirect stream with the sound data.
+        def sound(document = nil)
+          ref = value[:Sound]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /Volume — optional, -1.0 to 1.0 (default 1.0).
+        def volume
+          value[:Volume] || 1.0
+        end
+
+        # /Synchronous — optional, default false.
+        def synchronous?
+          value[:Synchronous] == true
+        end
+
+        # /Repeat — optional, default false.
+        def repeat?
+          value[:Repeat] == true
+        end
+
+        # /Mix — optional, default false. Whether to mix with
+        # existing sounds.
+        def mix?
+          value[:Mix] == true
+        end
+
+        # /Next — optional next action(s).
+        def next_action(document = nil)
+          ref = value[:Next]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Additional Actions for the Catalog (ISO 32000-2 §12.6.3.17,
+      # PDF 1.4+). Referenced via /AA on the Catalog dict. Each entry
+      # is an indirect ECMAScript action triggered by the named
+      # document event.
+      class AddActionCatalog < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AddActionCatalog"
+
+        # /DC — document close.
+        def document_close(document = nil)
+          resolve_action(:DC, document)
+        end
+
+        # /WS — will save.
+        def will_save(document = nil)
+          resolve_action(:WS, document)
+        end
+
+        # /DS — did save.
+        def did_save(document = nil)
+          resolve_action(:DS, document)
+        end
+
+        # /WP — will print.
+        def will_print(document = nil)
+          resolve_action(:WP, document)
+        end
+
+        # /DP — did print.
+        def did_print(document = nil)
+          resolve_action(:DP, document)
+        end
+
+        private
+
+        def resolve_action(key, document)
+          ref = value[key]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # AlternateImage (ISO 32000-2 §8.9.5, PDF 1.3+). An alternate
+      # image representation used when the primary image's color
+      # space isn't available (e.g. a DeviceGray fallback for a
+      # DeviceCMYK image on a monochrome printer).
+      class AlternateImage < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AlternateImage"
+
+        # /Image — required indirect reference to the alternate
+        # image XObject.
+        def image(document = nil)
+          ref = value[:Image]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /DefaultForPrinting — optional, default false. When true,
+        # the alternate image is used for printing.
+        def default_for_printing?
+          value[:DefaultForPrinting] == true
+        end
+
+        # /OC — optional optional-content group controlling the
+        # alternate's visibility (PDF 1.5+).
+        def optional_content(document = nil)
+          ref = value[:OC]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+      end
+    end
+  end
+end

data/lib/pdfrb/model/type.rb

@@ -385,6 +385,15 @@ module Pdfrb
 
       # Trapping (Adobe TechNote 5620).
       autoload :TrapRegion, "pdfrb/model/type/trap_region"
+
+      # Additional actions on the Catalog (s12.6.3.17).
+      autoload :AddActionCatalog, "pdfrb/model/type/add_action_catalog"
+
+      # Alternate image (s8.9.5).
+      autoload :AlternateImage, "pdfrb/model/type/alternate_image"
+
+      # Sound action (s12.6.4.11, deprecated 2.0).
+      autoload :ActionSound, "pdfrb/model/type/action_sound"
     end
   end
 end

data/lib/pdfrb/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.16
+  version: 0.7.18
 platform: ruby
 authors:
 - Ribose Inc.
@@ -968,13 +968,16 @@ files:
 - lib/pdfrb/model/type/action_rich_media_execute.rb
 - lib/pdfrb/model/type/action_set_ocg_state.rb
 - lib/pdfrb/model/type/action_set_state.rb
+- lib/pdfrb/model/type/action_sound.rb
 - lib/pdfrb/model/type/action_sound_action.rb
 - lib/pdfrb/model/type/action_submit_form.rb
 - lib/pdfrb/model/type/action_thread.rb
 - lib/pdfrb/model/type/action_trans.rb
 - lib/pdfrb/model/type/action_uri.rb
+- lib/pdfrb/model/type/add_action_catalog.rb
 - lib/pdfrb/model/type/af_embedded_file.rb
 - lib/pdfrb/model/type/af_file_specification.rb
+- lib/pdfrb/model/type/alternate_image.rb
 - lib/pdfrb/model/type/annotation.rb
 - lib/pdfrb/model/type/appearance.rb
 - lib/pdfrb/model/type/appearance_characteristics.rb