hexapdf 0.46.0 → 1.6.0

data/lib/hexapdf/type/acro_form/appearance_generator.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -134,11 +134,12 @@ module HexaPDF
           if !normal_appearance.kind_of?(HexaPDF::Dictionary) || normal_appearance.kind_of?(HexaPDF::Stream)
             (@widget[:AP] ||= {})[:N] = {Off: nil}
             normal_appearance = @widget[:AP][:N]
-            normal_appearance[@field[:V] == :Off ? :Yes : @field[:V]] = nil
+            normal_appearance[@field.field_value&.to_sym || :Yes] = nil
           end
           on_name = (normal_appearance.value.keys - [:Off]).first
           unless on_name
-            raise HexaPDF::Error, "Widget of button field doesn't define name for on state"
+            on_name = @field.field_value&.to_sym || :Yes
+            normal_appearance[on_name] = nil
           end
 
           @widget[:AS] = (@field[:V] == on_name ? on_name : :Off)
@@ -173,11 +174,59 @@ module HexaPDF
 
         alias create_radio_button_appearances create_check_box_appearances
 
-        # Creates the appropriate appearances for push buttons.
+        # Creates the appropriate appearances for push button fields
         #
-        # This is currently a dummy implementation raising an error.
+        # The following describes how the appearance is built:
+        #
+        # * The widget's rectangle /Rect must be defined.
+        #
+        # * If the font size (used for the caption) is zero, a font size of
+        #   +acro_form.default_font_size+ is used.
+        #
+        # * The line width, style and color of the rectangle are taken from the widget's border
+        #   style. See HexaPDF::Type::Annotations::Widget#border_style.
+        #
+        # * The background color is determined by the widget's background color. See
+        #   HexaPDF::Type::Annotations::Widget#background_color.
         def create_push_button_appearances
-          raise HexaPDF::Error, "Push button appearance generation not yet supported"
+          default_resources = @document.acro_form(create: true).default_resources
+          border_style = @widget.border_style
+          padding = border_style.width
+          marker_style = @widget.marker_style
+          font = retrieve_font_information(marker_style.font_name, default_resources)
+
+          @widget[:AS] = :N
+          @widget.flag(:print)
+          @widget.unflag(:hidden)
+          rect = @widget[:Rect]
+
+          width, height, matrix = perform_rotation(rect.width, rect.height)
+
+          form = (@widget[:AP] ||= {})[:N] ||= @document.add({Type: :XObject, Subtype: :Form})
+          # Wrap existing object in Form class in case the PDF writer didn't include the /Subtype
+          # key or the type of the object is wrong; we can do this since we know this has to be a
+          # Form object
+          unless form.type == :XObject && form[:Subtype] == :Form
+            form = @document.wrap(form, type: :XObject, subtype: :Form)
+          end
+          form.value.replace({Type: :XObject, Subtype: :Form, BBox: [0, 0, width, height],
+                              Matrix: matrix, Resources: HexaPDF::Object.deep_copy(default_resources)})
+          form.contents = ''
+
+          canvas = form.canvas
+          apply_background_and_border(border_style, canvas)
+
+          style = HexaPDF::Layout::Style.new(font: font, font_size: marker_style.size,
+                                             fill_color: marker_style.color)
+          if (text = marker_style.style) && text.kind_of?(String)
+            items = @document.layout.text_fragments(marker_style.style, style: style)
+            layouter = Layout::TextLayouter.new(style)
+            layouter.style.text_align(:center).text_valign(:center).line_spacing(:proportional, 1.25)
+            result = layouter.fit(items, width - 2 * padding, height - 2 * padding)
+            unless result.lines.empty?
+              result.draw(canvas, padding, height - padding)
+            end
+          end
         end
 
         # Creates the appropriate appearances for text fields, combo box fields and list box fields.
@@ -206,7 +255,8 @@ module HexaPDF
         # Note: Rich text fields are currently not supported!
         def create_text_appearances
           default_resources = @document.acro_form.default_resources
-          font, font_size, font_color = retrieve_font_information(default_resources)
+          font_name, font_size, font_color = @field.parse_default_appearance_string(@widget)
+          font = retrieve_font_information(font_name, default_resources)
           style = HexaPDF::Layout::Style.new(font: font, font_size: font_size, fill_color: font_color)
           border_style = @widget.border_style
           padding = [1, border_style.width].max
@@ -226,8 +276,11 @@ module HexaPDF
 
           form = (@widget[:AP] ||= {})[:N] ||= @document.add({Type: :XObject, Subtype: :Form})
           # Wrap existing object in Form class in case the PDF writer didn't include the /Subtype
-          # key; we can do this since we know this has to be a Form object
-          form = @document.wrap(form, type: :XObject, subtype: :Form) unless form[:Subtype] == :Form
+          # key or the type of the object is wrong; we can do this since we know this has to be a
+          # Form object
+          unless form.type == :XObject && form[:Subtype] == :Form
+            form = @document.wrap(form, type: :XObject, subtype: :Form)
+          end
           form.value.replace({Type: :XObject, Subtype: :Form, BBox: [0, 0, width, height],
                               Matrix: matrix, Resources: HexaPDF::Object.deep_copy(default_resources)})
           form.contents = ''
@@ -471,9 +524,9 @@ module HexaPDF
           end
         end
 
-        # Returns the font wrapper and font size to be used for a variable text field.
-        def retrieve_font_information(resources)
-          font_name, font_size, font_color = @field.parse_default_appearance_string(@widget)
+        # Returns the font wrapper, font size and font color to be used for variable text fields and
+        # push button captions.
+        def retrieve_font_information(font_name, resources)
           font_object = resources.font(font_name) rescue nil
           font = font_object&.font_wrapper
           unless font
@@ -489,7 +542,7 @@ module HexaPDF
               raise(HexaPDF::Error, "Font #{font_name} of the AcroForm's default resources not usable")
             end
           end
-          [font, font_size, font_color]
+          font
         end
 
         # Calculates the font size for single line text fields using auto-sizing, based on the font

data/lib/hexapdf/type/acro_form/button_field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/acro_form/choice_field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/acro_form/field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -291,7 +291,10 @@ module HexaPDF
           if embedded_widget?
             yield(document.wrap(self))
           elsif terminal_field?
-            self[:Kids]&.each {|kid| yield(document.wrap(kid)) }
+            self[:Kids]&.each do |kid|
+              kid = document.wrap(kid)
+              yield(kid) if kid.type == :Annot && kid[:Subtype] == :Widget
+            end
           end
 
           unless direct_only
@@ -392,6 +395,7 @@ module HexaPDF
               break # Each annotation dictionary may only appear on one page, see PDF2.0 12.5.2
             end
           end
+          document.revisions.current.update(self)
           widget
         end
 

data/lib/hexapdf/type/acro_form/form.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -81,6 +81,7 @@ module HexaPDF
         define_field :CO,              type: PDFArray, version: '1.3'
         define_field :DR,              type: :XXResources
         define_field :DA,              type: String
+        define_field :Q,               type: Integer
         define_field :XFA,             type: [Stream, PDFArray], version: '1.5'
 
         bit_field(:signature_flags, {signatures_exist: 0, append_only: 1},
@@ -182,24 +183,18 @@ module HexaPDF
         # The optional keyword arguments allow setting often used properties of the field:
         #
         # +font+::
-        #     The font that should be used for the text of the field. If +font_size+, +font_options+
-        #     or +font_color+ is specified but +font+ isn't, the font Helvetica is used.
-        #
-        #     If no font is set on the text field, the default font properties of the AcroForm form
-        #     are used. Note that field specific or form specific font properties have to be set.
-        #     Otherwise there will be an error when trying to generate a visual representation of
-        #     the field value.
+        #     The font that should be used for the text of the field. If not specified, it
+        #     defaults to Helvetica.
         #
         # +font_options+::
-        #     A hash with font options like :variant that should be used.
+        #     A hash with font options like :variant that should be used. If not specified, it
+        #     defaults to the empty hash.
         #
         # +font_size+::
-        #     The font size that should be used. If +font+, +font_options+ or +font_color+ is
-        #     specified but +font_size+ isn't, font size defaults to 0 (= auto-sizing).
+        #     The font size that should be used. If not specified, it defaults to 0 (= auto-sizing).
         #
         # +font_color+::
-        #     The font color that should be used. If +font+, +font_options+ or +font_size+ is
-        #     specified but +font_color+ isn't, font color defaults to 0 (i.e. black).
+        #     The font color that should be used. If not specified, it defaults to 0 (i.e. black).
         #
         # +align+::
         #     The alignment of the text, either :left, :center or :right.
@@ -440,8 +435,7 @@ module HexaPDF
 
         # Returns the dictionary containing the default resources for form field appearance streams.
         def default_resources
-          self[:DR] ||= document.wrap({ProcSet: [:PDF, :Text, :ImageB, :ImageC, :ImageI]},
-                                      type: :XXResources)
+          self[:DR] ||= document.wrap({}, type: :XXResources)
         end
 
         # Sets the global default appearance string using the provided values or the default values
@@ -523,11 +517,11 @@ module HexaPDF
         #
         # See: JavaScriptActions
         def recalculate_fields
-          self[:CO]&.each do |field|
+          (each_field.to_a & self[:CO].to_a).each do |field|
             field = Field.wrap(document, field)
             next unless field && (calculation_action = field[:AA]&.[](:C))
             result = JavaScriptActions.calculate(self, calculation_action)
-            field.form_field.field_value = result if result
+            field.field_value = result if result
           end
         end
 
@@ -561,13 +555,11 @@ module HexaPDF
         # Applies the given variable field properties to the field.
         def apply_variable_text_properties(field, font: nil, font_options: nil, font_size: nil,
                                            font_color: nil, align: nil)
-          if font || font_options || font_size || font_color
-            field.set_default_appearance_string(font: font || 'Helvetica',
-                                                font_options: font_options || {},
-                                                font_size: font_size || 0,
-                                                font_color: font_color || 0)
-          end
-          field.text_alignment(align) if align
+          field.set_default_appearance_string(font: font || 'Helvetica',
+                                              font_options: font_options || {},
+                                              font_size: font_size || 0,
+                                              font_color: font_color || 0)
+          field.text_alignment(align || :left)
         end
 
         def perform_validation # :nodoc:
@@ -576,12 +568,12 @@ module HexaPDF
           seen = {} # used for combining field
 
           validate_array = lambda do |parent, container|
-            container.reject! do |field|
+            container.map! do |field|
               if !field.kind_of?(HexaPDF::Object) || !field.kind_of?(HexaPDF::Dictionary) || field.null?
                 yield("Invalid object in AcroForm field hierarchy", true)
-                next true
+                next nil
               end
-              next false unless field.key?(:T) # Skip widgets
+              next field unless field.key?(:T) # Skip widgets
 
               field = Field.wrap(document, field)
               reject = false
@@ -605,14 +597,15 @@ module HexaPDF
                   widget[:Parent] = other_field
                   kids << widget
                 end
+                document.delete(field)
                 reject = true
               elsif !reject
                 seen[name] = field
               end
 
-              validate_array.call(field, field[:Kids]) if field.key?(:Kids)
-              reject
-            end
+              validate_array.call(field, field[:Kids]) if !field.null? && field.key?(:Kids)
+              reject ? nil : field
+            end.compact!
           end
           validate_array.call(nil, root_fields)
 
@@ -625,8 +618,6 @@ module HexaPDF
             if font_name && !(self[:DR][:Font] && self[:DR][:Font][font_name])
               yield("The font specified in /DA is not in the /DR resource dictionary")
             end
-          else
-            set_default_appearance_string
           end
 
           create_appearances if document.config['acro_form.create_appearances']

data/lib/hexapdf/type/acro_form/java_script_actions.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -496,7 +496,7 @@ module HexaPDF
                    else
                      nil
                    end
-          result && (result == result.truncate ? result.to_i.to_s : result.to_s)
+          result && (result.finite? && result == result.truncate ? result.to_i.to_s : result.to_s)
         end
 
         AF_SIMPLE_CALCULATE_MAPPING = { #:nodoc:
@@ -613,7 +613,14 @@ module HexaPDF
 
         # Returns the numeric value of the string, interpreting comma as point.
         def af_make_number(value)
-          value.to_s.tr(',', '.').to_f
+          value = value.to_s
+          if value.match?(/(?:[+-])?Inf(?:inity)?/i)
+            value.start_with?('-') ? -Float::INFINITY : Float::INFINITY
+          elsif value.match?(/NaN/i)
+            Float::NAN
+          else
+            value.tr(',', '.').to_f
+          end
         end
 
         # Formats the numeric value according to the format string and separator style.

data/lib/hexapdf/type/acro_form/signature_field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -62,8 +62,10 @@ module HexaPDF
 
           define_field :Type,   type: Symbol, default: type
           define_field :Action, type: Symbol, required: true,
-            allowed_values: [:All, :Include, :Exclude]
+                       allowed_values: [:All, :Include, :Exclude]
           define_field :Fields, type: PDFArray
+          define_field :P, type: Numeric, version: '2.0',
+                       allowed_values: [1, 2, 3]
 
           private
 
@@ -83,8 +85,8 @@ module HexaPDF
         # If a flag is set it means that the associated entry is a required constraint. Otherwise it
         # is optional.
         #
-        # The available flags are: filter, sub_filter, v, reasons, legal_attestation, add_rev_info
-        # and digest_method.
+        # The available flags are: filter, sub_filter, v, reasons, legal_attestation, add_rev_info,
+        # digest_method, lock_document and appearance_filter.
         #
         # See: PDF2.0 s12.7.5.5
         class SeedValueDictionary < Dictionary
@@ -98,13 +100,16 @@ module HexaPDF
           define_field :Filter,           type: Symbol
           define_field :SubFilter,        type: PDFArray
           define_field :DigestMethod,     type: PDFArray, version: '1.7'
-          define_field :V,                type: Float
+          define_field :V,                type: Integer
           define_field :Cert,             type: :SVCert
           define_field :Reasons,          type: PDFArray
           define_field :MDP,              type: Dictionary, version: '1.6'
           define_field :TimeStamp,        type: Dictionary, version: '1.6'
           define_field :LegalAttestation, type: PDFArray, version: '1.6'
           define_field :AddRevInfo,       type: Boolean, version: '1.7'
+          define_field :LockDocument,     type: Symbol, version: '2.0',
+                       allowed_values: [:true, :false, :auto]
+          define_field :AppearanceFilter, type: String, version: '2.0'
 
           ##
           # :method: flags
@@ -130,7 +135,8 @@ module HexaPDF
           # all prior flags will be cleared.
           #
           bit_field(:flags, {filter: 0, sub_filter: 1, v: 2, reasons: 3, legal_attestation: 4,
-                             add_rev_info: 5, digest_method: 6},
+                             add_rev_info: 5, digest_method: 6, lock_document: 7,
+                             appearance_filter: 8},
                     lister: "flags", getter: "flagged?", setter: "flag", unsetter: "unflag",
                     value_getter: "self[:Ff]", value_setter: "self[:Ff]")
 
@@ -155,12 +161,16 @@ module HexaPDF
           define_field :Type,      type: Symbol, default: type
           define_field :Ff,        type: Integer, default: 0
           define_field :Subject,   type: PDFArray
+          define_field :SignaturePolicyOID, type: String, version: '2.0'
+          define_field :SignaturePolicyHashValue, type: String, version: '2.0'
+          define_field :SignaturePolicyHashAlgorithm, type: Symbol, version: '2.0'
+          define_field :SignaturePolicyCommitmentType, type: PDFArray, version: '2.0'
           define_field :SubjectDN, type: PDFArray, version: '1.7'
           define_field :KeyUsage,  type: PDFArray, version: '1.7'
           define_field :Issuer,    type: PDFArray
           define_field :OID,       type: PDFArray
           define_field :URL,       type: String
-          define_field :URLType,   type: Symbol, default: :Browser
+          define_field :URLType,   type: Symbol, default: :Browser, version: '1.7'
 
           ##
           # :method: flags
@@ -199,7 +209,8 @@ module HexaPDF
 
         # Returns the associated signature dictionary or +nil+ if the signature is not filled in.
         def field_value
-          self[:V]
+          val = self[:V]
+          val.instance_of?(Dictionary) ? document.wrap(val, type: :Sig) : val
         end
 
         # Sets the signature dictionary as value of this signature field.

data/lib/hexapdf/type/acro_form/text_field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -176,7 +176,7 @@ module HexaPDF
           end
           str = str.gsub(/[[:space:]]/, ' ') if str && concrete_field_type == :single_line_text_field
           if key?(:MaxLen) && str && str.length > self[:MaxLen]
-            raise HexaPDF::Error, "Value exceeds maximum allowed length of #{self[:MaxLen]}"
+            str = @document.config['acro_form.text_field.on_max_len_exceeded'].call(self, str)
           end
           self[:V] = str
           update_widgets
@@ -348,7 +348,14 @@ module HexaPDF
             return
           end
           if (max_len = self[:MaxLen]) && field_value && field_value.length > max_len
-            yield("Text contents of field '#{full_field_name}' is too long")
+            correctable = true
+            begin
+              str = @document.config['acro_form.text_field.on_max_len_exceeded'].call(self, field_value)
+            rescue HexaPDF::Error
+              correctable = false
+            end
+            yield("Text contents of field '#{full_field_name}' is too long", correctable)
+            self.field_value = str if correctable
           end
           if comb_text_field? && !max_len
             yield("Comb text field needs a value for /MaxLen")

data/lib/hexapdf/type/acro_form/variable_text_field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -51,7 +51,7 @@ module HexaPDF
       # See: PDF2.0 s12.7.4.3
       class VariableTextField < Field
 
-        define_field :DA, type: String
+        define_field :DA, type: PDFByteString
         define_field :Q, type: Integer, default: 0, allowed_values: [0, 1, 2]
         define_field :DS, type: String, version: '1.5'
         define_field :RV, type: [String, Stream], version: '1.5'
@@ -106,7 +106,7 @@ module HexaPDF
               font_params[2] = HexaPDF::Content::ColorSpace.prenormalized_device_color(params)
             end
           end
-          HexaPDF::Content::Parser.parse(appearance_string.sub(/\/\//, '/'), &block)
+          HexaPDF::Content::Parser.parse(appearance_string.to_s.sub(/\/\//, '/'), &block)
           block_given? ? nil : font_params
         end
 
@@ -154,13 +154,21 @@ module HexaPDF
         # font_size, font_color].
         #
         # The default appearance string is taken from the given +widget+ of the field, falls back to
-        # the field itself or, if still not available, the default appearance string of the form.
+        # the field itself and then the default appearance string of the form. If it still not
+        # available, a standard default appearance string is set (see
+        # #set_default_appearance_string) and used.
         #
         # The reason why a specific widget of the field can be specified is because the widgets of a
         # field might differ in their visual representation.
         def parse_default_appearance_string(widget = self)
           da = widget[:DA] || self[:DA] || (document.acro_form && document.acro_form[:DA])
-          raise HexaPDF::Error, "No default appearance string set" unless da
+          unless da
+            if (args = document.config['acro_form.fallback_default_appearance'])
+              da = set_default_appearance_string(**args)
+            else
+              raise HexaPDF::Error, "No default appearance string set"
+            end
+          end
           self.class.parse_appearance_string(da)
         end
 

data/lib/hexapdf/type/acro_form.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/action.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/actions/go_to.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -47,6 +47,7 @@ module HexaPDF
 
         define_field :S, type: Symbol, required: true, default: :GoTo
         define_field :D, type: [Symbol, PDFByteString, PDFArray], required: true
+        define_field :SD, type: PDFArray, version: '2.0'
 
       end
 

data/lib/hexapdf/type/actions/go_to_r.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -48,6 +48,7 @@ module HexaPDF
         define_field :S,         type: Symbol, required: true, default: :GoToR
         define_field :F,         type: :Filespec, required: true
         define_field :D,         type: [Symbol, PDFByteString, PDFArray], required: true
+        define_field :SD,        type: PDFArray, version: '2.0'
         define_field :NewWindow, type: Boolean, version: '1.2'
 
       end

data/lib/hexapdf/type/actions/launch.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -60,13 +60,17 @@ module HexaPDF
         define_field :S,         type: Symbol, required: true, default: :Launch
         define_field :F,         type: :Filespec
         define_field :Win,       type: :XXLaunchActionWinParameters
+        define_field :Mac,       type: ::Object, version: '2.0'
+        define_field :Unix,      type: ::Object, version: '2.0'
         define_field :NewWindow, type: Boolean, version: '1.2'
 
         private
 
         def perform_validation #:nodoc:
           super
-          yield("A Launch action needs a target") unless key?(:F) || key?(:Win)
+          unless key?(:Win) || key?(:Mac) || key?(:Unix) || key?(:F)
+            yield("Launch action key /F required if /Win, /Mac and /Unix are absent")
+          end
         end
 
       end

data/lib/hexapdf/type/actions/set_ocg_state.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/actions/uri.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/actions.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as