hexapdf 0.46.0 → 1.6.0

data/lib/hexapdf/cli/command.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
@@ -35,7 +35,6 @@
 #++
 
 require 'io/console'
-require 'ostruct'
 require 'cmdparse'
 require 'hexapdf/document'
 require 'hexapdf/font/true_type'
@@ -53,7 +52,7 @@ module HexaPDF
       module Extensions #:nodoc:
         def help_banner #:nodoc:
           "hexapdf #{HexaPDF::VERSION} - Versatile PDF Manipulation Tool\n" \
-            "Copyright (c) 2014-2024 Thomas Leitner; licensed under the AGPLv3\n\n" \
+            "Copyright (c) 2014-2025 Thomas Leitner; licensed under the AGPLv3\n\n" \
             "#{format(usage, indent: 7)}\n\n"
         end
 
@@ -68,21 +67,22 @@ module HexaPDF
 
       def initialize(*args, **kwargs, &block) #:nodoc:
         super
-        @out_options = OpenStruct.new
-        @out_options.compact = true
-        @out_options.compress_pages = false
-        @out_options.object_streams = :preserve
-        @out_options.xref_streams = :preserve
-        @out_options.streams = :preserve
-        @out_options.optimize_fonts = false
-        @out_options.prune_page_resources = false
-
-        @out_options.encryption = :preserve
-        @out_options.enc_user_pwd = @out_options.enc_owner_pwd = nil
-        @out_options.enc_key_length = 128
-        @out_options.enc_algorithm = :aes
-        @out_options.enc_force_v4 = false
-        @out_options.enc_permissions = []
+        @out_options = {
+          compact: true,
+          compress_pages: false,
+          object_streams: :preserve,
+          xref_streams: :preserve,
+          streams: :preserve,
+          optimize_fonts: false,
+          prune_page_resources: false,
+          encryption: :preserve,
+          enc_user_pwd: nil,
+          enc_owner_pwd: nil,
+          enc_key_length: 128,
+          enc_algorithm: :aes,
+          enc_force_v4: false,
+          enc_permissions: [],
+        }
       end
 
       protected
@@ -163,7 +163,7 @@ module HexaPDF
           if command_parser.verbosity_info?
             puts "Creating output document #{out_file}"
           end
-          doc.write(out_file, validate: false, incremental: incremental)
+          doc.write(out_file, validate: false, compact: false, incremental: incremental)
         end
       end
 
@@ -183,35 +183,35 @@ module HexaPDF
         options.separator("")
         options.separator("Optimization options:")
         options.on("--[no-]compact", "Delete unnecessary PDF objects (default: " \
-                   "#{@out_options.compact})") do |c|
-          @out_options.compact = c
+                   "#{@out_options[:compact]})") do |c|
+          @out_options[:compact] = c
         end
         options.on("--object-streams MODE", [:generate, :preserve, :delete],
                    "Handling of object streams (either generate, preserve or delete; " \
-                     "default: #{@out_options.object_streams})") do |os|
-          @out_options.object_streams = os
+                     "default: #{@out_options[:object_streams]})") do |os|
+          @out_options[:object_streams] = os
         end
         options.on("--xref-streams MODE", [:generate, :preserve, :delete],
                    "Handling of cross-reference streams (either generate, preserve or delete; " \
-                     "default: #{@out_options.xref_streams})") do |x|
-          @out_options.xref_streams = x
+                     "default: #{@out_options[:xref_streams]})") do |x|
+          @out_options[:xref_streams] = x
         end
         options.on("--streams MODE", [:compress, :preserve, :uncompress],
                    "Handling of stream data (either compress, preserve or uncompress; default: " \
-                     "#{@out_options.streams})") do |streams|
-          @out_options.streams = streams
+                     "#{@out_options[:streams]})") do |streams|
+          @out_options[:streams] = streams
         end
         options.on("--[no-]compress-pages", "Recompress page content streams (may take a long " \
-                   "time; default: #{@out_options.compress_pages})") do |c|
-          @out_options.compress_pages = c
+                   "time; default: #{@out_options[:compress_pages]})") do |c|
+          @out_options[:compress_pages] = c
         end
         options.on("--[no-]prune-page-resources", "Prunes unused objects from the page resources " \
-                   "(may take a long time; default: #{@out_options.prune_page_resources})") do |c|
-          @out_options.prune_page_resources = c
+                   "(may take a long time; default: #{@out_options[:prune_page_resources]})") do |c|
+          @out_options[:prune_page_resources] = c
         end
         options.on("--[no-]optimize-fonts", "Optimize embedded font files; " \
-                   "default: #{@out_options.optimize_fonts})") do |o|
-          @out_options.optimize_fonts = o
+                   "default: #{@out_options[:optimize_fonts]})") do |o|
+          @out_options[:optimize_fonts] = o
         end
       end
 
@@ -222,37 +222,37 @@ module HexaPDF
         options.separator("")
         options.separator("Encryption options:")
         options.on("--decrypt", "Remove any encryption") do
-          @out_options.encryption = :remove
+          @out_options[:encryption] = :remove
         end
         options.on("--encrypt", "Encrypt the output file") do
-          @out_options.encryption = :add
+          @out_options[:encryption] = :add
         end
         options.on("--owner-password PASSWORD", String, "The owner password to be set on the " \
                    "output file (use - for reading from standard input)") do |pwd|
-          @out_options.encryption = :add
-          @out_options.enc_owner_pwd = (pwd == '-' ? read_password("Owner password") : pwd)
+          @out_options[:encryption] = :add
+          @out_options[:enc_owner_pwd] = (pwd == '-' ? read_password("Owner password") : pwd)
         end
         options.on("--user-password PASSWORD", String, "The user password to be set on the " \
                    "output file (use - for reading from standard input)") do |pwd|
-          @out_options.encryption = :add
-          @out_options.enc_user_pwd = (pwd == '-' ? read_password("User password") : pwd)
+          @out_options[:encryption] = :add
+          @out_options[:enc_user_pwd] = (pwd == '-' ? read_password("User password") : pwd)
         end
         options.on("--algorithm ALGORITHM", [:aes, :arc4],
                    "The encryption algorithm: aes or arc4 (default: " \
-                     "#{@out_options.enc_algorithm})") do |a|
-          @out_options.encryption = :add
-          @out_options.enc_algorithm = a
+                     "#{@out_options[:enc_algorithm]})") do |a|
+          @out_options[:encryption] = :add
+          @out_options[:enc_algorithm] = a
         end
         options.on("--key-length BITS", Integer,
                    "The encryption key length in bits (default: " \
-                     "#{@out_options.enc_key_length})") do |i|
-          @out_options.encryption = :add
-          @out_options.enc_key_length = i
+                     "#{@out_options[:enc_key_length]})") do |i|
+          @out_options[:encryption] = :add
+          @out_options[:enc_key_length] = i
         end
         options.on("--force-V4",
                    "Force use of encryption version 4 if key length=128 and algorithm=arc4") do
-          @out_options.encryption = :add
-          @out_options.enc_force_v4 = true
+          @out_options[:encryption] = :add
+          @out_options[:enc_force_v4] = true
         end
         syms = HexaPDF::Encryption::StandardSecurityHandler::Permissions::SYMBOL_TO_PERMISSION.keys
         options.on("--permissions PERMS", Array,
@@ -264,8 +264,8 @@ module HexaPDF
             end
             perm.to_sym
           end
-          @out_options.encryption = :add
-          @out_options.enc_permissions = perms
+          @out_options[:encryption] = :add
+          @out_options[:enc_permissions] = perms
         end
       end
 
@@ -273,12 +273,12 @@ module HexaPDF
       #
       # See: #define_optimization_options
       def apply_optimization_options(doc)
-        doc.task(:optimize, compact: @out_options.compact,
-                 object_streams: @out_options.object_streams,
-                 xref_streams: @out_options.xref_streams,
-                 compress_pages: @out_options.compress_pages,
-                 prune_page_resources: @out_options.prune_page_resources)
-        if @out_options.streams != :preserve || @out_options.optimize_fonts
+        doc.task(:optimize, compact: @out_options[:compact],
+                 object_streams: @out_options[:object_streams],
+                 xref_streams: @out_options[:xref_streams],
+                 compress_pages: @out_options[:compress_pages],
+                 prune_page_resources: @out_options[:prune_page_resources])
+        if @out_options[:streams] != :preserve || @out_options[:optimize_fonts]
           doc.each do |obj|
             optimize_stream(obj)
             optimize_font(obj)
@@ -292,15 +292,15 @@ module HexaPDF
 
       # Applies the chosen stream mode to the given object.
       def optimize_stream(obj)
-        return if @out_options.streams == :preserve || !obj.respond_to?(:set_filter) ||
+        return if @out_options[:streams] == :preserve || !obj.respond_to?(:set_filter) ||
           Array(obj[:Filter]).any? {|f| IGNORED_FILTERS[f] }
 
-        obj.set_filter(@out_options.streams == :compress ? :FlateDecode : nil)
+        obj.set_filter(@out_options[:streams] == :compress ? :FlateDecode : nil)
       end
 
       # Optimize the object if it is a font object.
       def optimize_font(obj)
-        return unless @out_options.optimize_fonts && obj.kind_of?(HexaPDF::Type::Font) &&
+        return unless @out_options[:optimize_fonts] && obj.kind_of?(HexaPDF::Type::Font) &&
           (obj[:Subtype] == :TrueType ||
            (obj[:Subtype] == :Type0 && obj.descendant_font[:Subtype] == :CIDFontType2)) &&
           obj.embedded?
@@ -319,14 +319,14 @@ module HexaPDF
       #
       # See: #define_encryption_options
       def apply_encryption_options(doc)
-        case @out_options.encryption
+        case @out_options[:encryption]
         when :add
-          doc.encrypt(algorithm: @out_options.enc_algorithm,
-                      key_length: @out_options.enc_key_length,
-                      force_v4: @out_options.enc_force_v4,
-                      permissions: @out_options.enc_permissions,
-                      owner_password: @out_options.enc_owner_pwd,
-                      user_password: @out_options.enc_user_pwd)
+          doc.encrypt(algorithm: @out_options[:enc_algorithm],
+                      key_length: @out_options[:enc_key_length],
+                      force_v4: @out_options[:enc_force_v4],
+                      permissions: @out_options[:enc_permissions],
+                      owner_password: @out_options[:enc_owner_pwd],
+                      user_password: @out_options[:enc_user_pwd])
         when :remove
           doc.encrypt(name: nil)
         end

data/lib/hexapdf/cli/debug_info.rb

@@ -0,0 +1,98 @@
+# -*- encoding: utf-8; frozen_string_literal: true -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# 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
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#
+# If the GNU Affero General Public License doesn't fit your need,
+# commercial licenses are available at <https://gettalong.at/hexapdf/>.
+#++
+
+require 'hexapdf/cli/command'
+
+module HexaPDF
+  module CLI
+
+    # Creates debugging information for adding to an issue.
+    class DebugInfo < Command
+
+      def initialize #:nodoc:
+        super('debug-info', takes_commands: false)
+        short_desc("Create debug information for a PDF file")
+        long_desc(<<~EOF)
+          Creates debug information for a possibly malformed PDF file that can be attached to an
+          issue.
+
+          Two files are created: anonymized-FILE where all strings are replaced with zeroes and
+          debug_info.txt with additional debug information.
+        EOF
+
+        options.on("--password PASSWORD", "-p", String,
+                   "The password for decryption. Use - for reading from standard input.") do |pwd|
+          @password = (pwd == '-' ? read_password : pwd)
+        end
+
+        @password = nil
+      end
+
+      def execute(file) #:nodoc:
+        output_name = "anonymized-#{file}"
+        puts "Creating anonymized file '#{output_name}'"
+        data = File.binread(file)
+        data.gsub!(/(>>\s*stream\s*)(.*?)(\s*endstream)/m) {|m| "#{$1}#{'0' * $2.length}#{$3}" }
+        data.gsub!(/([^<]<)([0-9A-Fa-f#{Tokenizer::WHITESPACE}]*?)>/m) {|m| "#{$1}#{'0' * $2.length}>" }
+        data.gsub!(/\((.*?)\)/m) {|m| "(#{'0' * $1.length})" }
+        File.binwrite(output_name, data)
+
+        debug_info = +''
+        puts "Collecting debug information in debug_info.txt"
+        begin
+          output = capture_output { HexaPDF::CLI::Application.new.parse(['info', '--check', file]) }
+          debug_info << "Output:\n"<< output
+        rescue
+          debug_info << "Error collecting info: #{$!.message}\n"
+        end
+        File.write('debug_info.txt', debug_info)
+      end
+
+      private
+
+      def capture_output
+        stdout, stderr = $stdout, $stderr
+        $stdout = $stderr = StringIO.new
+        yield
+        $stdout.string
+      ensure
+        $stdout, $stderr = stdout, stderr
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/cli/files.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/cli/fonts.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/cli/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
@@ -161,8 +161,8 @@ module HexaPDF
             (field.alternate_field_name ? " (#{field.alternate_field_name})" : '')
           concrete_field_type = field.concrete_field_type
           nice_field_type = concrete_field_type.to_s.split('_').map(&:capitalize).join(' ')
-          size = "(#{widget[:Rect].width.round(3)}x#{widget[:Rect].height.round(3)})"
-          position = "(#{widget[:Rect].left}, #{widget[:Rect].bottom})"
+          size = "#{widget[:Rect].width.round(3)}x#{widget[:Rect].height.round(3)}"
+          position = "x=#{widget[:Rect].left}, y=#{widget[:Rect].bottom}"
           field_value = if !field.field_value || concrete_field_type != :signature_field
                           field.field_value.inspect
                         else
@@ -172,10 +172,15 @@ module HexaPDF
                           temp
                         end
 
+          if concrete_field_type == :radio_button
+            rb_name = ((widget.appearance_dict&.normal_appearance&.value&.keys || []) - [:Off]).first
+            rb_name = " (#{rb_name.inspect})"
+          end
+
           flags = field_flags(field)
-          puts "  #{field_name}" << (flags.empty? ? '' : " (#{flags.join(', ')})")
+          puts "  #{field_name}#{rb_name}" << (flags.empty? ? '' : " (#{flags.join(', ')})")
           if command_parser.verbosity_info?
-            printf("    └─ %-22s | %-20s\n", nice_field_type, "#{size} #{position}")
+            printf("    └─ %-22s | %-20s\n", nice_field_type, "#{position}, #{size} ")
           end
           puts "    └─ #{field_value}"
           if command_parser.verbosity_info?
@@ -285,7 +290,7 @@ module HexaPDF
           page.each_annotation do |annotation|
             next unless annotation[:Subtype] == :Widget
             field = annotation.form_field
-            next if field.concrete_field_type == :push_button
+            next if !field.concrete_field_type || field.concrete_field_type == :push_button
             if with_seen || !seen[field.full_field_name]
               yield(page, page_index, field, annotation)
               seen[field.full_field_name] = true

data/lib/hexapdf/cli/image2pdf.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/cli/images.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
@@ -35,6 +35,7 @@
 #++
 
 require 'set'
+require 'fileutils'
 require 'hexapdf/cli/command'
 
 module HexaPDF
@@ -132,7 +133,7 @@ module HexaPDF
         printf("%5s %5s %9s %6s %6s %5s %4s %3s %5s %5s %6s %5s %8s\n",
                "index", "page", "oid", "width", "height", "color", "comp", "bpc",
                "x-ppi", "y-ppi", "size", "type", "writable")
-        puts("-" * 77)
+        puts("-" * 84)
         each_image(doc) do |image, index, pindex, (x_ppi, y_ppi)|
           info = image.info
           size = human_readable_file_size(image[:Length] + image[:SMask]&.[](:Length).to_i)
@@ -145,20 +146,34 @@ module HexaPDF
 
       # Extracts the images with the given indices.
       def extract_images(doc)
+        FileUtils.mkdir_p(File.dirname("#{@prefix}filename"))
+        prefix = File.directory?(@prefix) ? @prefix : "#{@prefix}-"
+
         done = Set.new
+        count = total = 0
         each_image(doc) do |image, index, _|
           next unless (@indices.include?(index) || @indices.include?(0)) && !done.include?(index)
+          total += 1
           info = image.info
           if info.writable
-            path = "#{@prefix}-#{index}.#{image.info.extension}"
+            count += 1
+            path = "#{prefix}#{index}.#{image.info.extension}"
             maybe_raise_on_existing_file(path)
-            puts "Extracting #{path}..." if command_parser.verbosity_info?
+            if command_parser.verbosity_info?
+              puts "Extracting image #{index} (#{image.width}x#{image.height}, " \
+                   "#{info.color_space}, #{info.type}) to #{path}..."
+            end
             image.write(path)
             done << index
+            if info.color_space == :cmyk && info.type == :jpeg
+              $stderr.puts "Note (image #{path}): JPEG uses CMYK colorspace and may " \
+                           "need color post-processing"
+            end
           elsif command_parser.verbosity_warning?
             $stderr.puts "Warning (image #{index}): PDF image format not supported for writing"
           end
         end
+        puts "Created #{count} image files (out of #{total} selected)" if command_parser.verbosity_info?
       end
 
       # Iterates over all images.

data/lib/hexapdf/cli/info.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/cli/inspect.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
@@ -188,12 +188,20 @@ module HexaPDF
                   end
             serialize(obj.value, recursive: true) if obj
 
-          when 's', 'stream', 'raw', 'raw-stream'
+          when 's', 'stream', 'raw', 'raw-stream', 'sd'
             if (obj = pdf_object_from_string_reference(data.shift) rescue $stderr.puts($!.message)) &&
                 obj.kind_of?(HexaPDF::Stream)
-              source = (command.start_with?('raw') ? obj.stream_source : obj.stream_decoder)
-              while source.alive? && (stream_data = source.resume)
-                $stdout.write(stream_data)
+              if command == 'sd'
+                if obj.respond_to?(:process_contents)
+                  obj.process_contents(ContentProcessor.new)
+                else
+                  $stderr.puts("Error: The object is not a Form XObject or page")
+                end
+              else
+                source = (command.start_with?('raw') ? obj.stream_source : obj.stream_decoder)
+                while source.alive? && (stream_data = source.resume)
+                  $stdout.write(stream_data)
+                end
               end
             elsif command_parser.verbosity_info?
               $stderr.puts("Note: Object has no stream data")
@@ -285,6 +293,10 @@ module HexaPDF
               IO.copy_stream(@doc.revisions.parser.io, $stdout, length, 0)
             else
               puts "Document has #{@doc.revisions.count} revision#{@doc.revisions.count == 1 ? '' : 's'}"
+              if @doc.revisions.parser.reconstructed? && @doc.revisions.count == 1 &&
+                 @doc.revisions.current == @doc.revisions.parser.reconstructed_revision
+                puts "Document cross-reference table has been reconstructed"
+              end
               revision_information do |rev, index, count, signature, end_offset|
                 type = if rev.trailer[:XRefStm]
                          "xref table + stream"
@@ -395,16 +407,19 @@ module HexaPDF
         end
         io = @doc.revisions.parser.io
 
-        startxrefs = @doc.revisions.map {|rev| rev.trailer[:Prev] }
         io.seek(0, IO::SEEK_END)
-        startxrefs.push(@doc.revisions.parser.startxref_offset, io.pos).shift
+        startxrefs = @doc.revisions.map {|rev| rev.trailer[:Prev].to_i } <<
+                     @doc.revisions.parser.startxref_offset <<
+                     io.pos
+        startxrefs.sort!
+        startxrefs.shift
 
         @doc.revisions.each_with_index.map do |rev, index|
           end_index = 0
           sig = signatures[rev]
           if sig
             end_index = sig[:ByteRange][-2] + sig[:ByteRange][-1]
-          else
+          elsif rev != @doc.revisions.parser.reconstructed_revision
             io.seek(startxrefs[index], IO::SEEK_SET)
             buffer = ''.b
             while io.pos < startxrefs[index + 1]
@@ -424,6 +439,7 @@ module HexaPDF
         ["OID[,GEN] | o[bject] OID[,GEN]", "Print object"],
         ["r[ecursive] OID[,GEN]", "Print object recursively"],
         ["s[tream] OID[,GEN]", "Print filtered stream"],
+        ["sd OID[,GEN]", "Print the decoded stream of a Form XObject or page"],
         ["raw[-stream] OID[,GEN]", "Print raw stream"],
         ["rev[ision] [NUMBER]", "Print or extract revision"],
         ["x[ref] OID[,GEN]", "Print the cross-reference entry"],

data/lib/hexapdf/cli/merge.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/cli/modify.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
@@ -34,7 +34,6 @@
 # commercial licenses are available at <https://gettalong.at/hexapdf/>.
 #++
 
-require 'ostruct'
 require 'hexapdf/cli/command'
 
 module HexaPDF

data/lib/hexapdf/cli/optimize.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
@@ -53,11 +53,11 @@ module HexaPDF
         EOF
 
         @password = nil
-        @out_options.compact = true
-        @out_options.xref_streams = :generate
-        @out_options.object_streams = :generate
-        @out_options.streams = :compress
-        @out_options.optimize_fonts = true
+        @out_options[:compact] = true
+        @out_options[:xref_streams] = :generate
+        @out_options[:object_streams] = :generate
+        @out_options[:streams] = :compress
+        @out_options[:optimize_fonts] = true
 
         options.on("--password PASSWORD", "-p", String,
                    "The password for decryption. Use - for reading from standard input.") do |pwd|

data/lib/hexapdf/cli/split.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/cli/usage.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/cli/watermark.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