hexapdf 0.15.9 → 0.17.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24d17dfd6c8dc9e3f7014e1ea769dede6f8cea81529bb201a8447f21873d3b25
-  data.tar.gz: 7165a2e11983731ba2597d2e4a824415abc96936d2b58f3fb737a4fed94dcf16
+  metadata.gz: 71e5d38f8a3d1a6b4371e5f8e2f991d36c0ea8c01ca5dc4ec1e132043fad00aa
+  data.tar.gz: cf78ef5b6fa915bac30fe75157fc414148c8bd2b8c5c7ee10fe4bb3cbf70076a
 SHA512:
-  metadata.gz: 244332a4f024c90cf6344b462ed422a5f73b32d3a4d04d0dcdadc6e7ede2cd0724f7a3329fa3aad68c99e47f49a9dff66806d9b8b152b9551eaecd7365c807d4
-  data.tar.gz: 06c4b9fd5ecd8f045a37e85ce4a6539f52b48bb16fb685290bcc2a0210b5f2e66bcfa9b7efb1115c45dd1618de9421c479d7a66d84556d1b9c37b19b1f8b6075
+  metadata.gz: 2153a1c0eadc0ca940480502b42780717e2777416f1e85e1c9506b879e01df0b2bc4e6d838ecd140af4a62e93bd16aa08ab42bbf522f6bbd234c0d9da82e4115
+  data.tar.gz: e91b860ece2751633350739852b392719d9d09cb1bdd9e1c1896ef76e5828db9d2d0f9204b93521efbd6e5dcefc84b0451984392c2a4de3703a6060def1f5c75

data/CHANGELOG.md

@@ -1,3 +1,65 @@
+## 0.17.2 - 2021-10-26
+
+### Fixed
+
+* Deployment of HexaPDF's Rubygem
+
+
+## 0.17.1 - 2021-10-21
+
+### Fixed
+
+* Handling of files containing invalid UTF-16 strings
+
+
+## 0.17.0 - 2021-10-21
+
+### Added
+
+* CLI command `hexapdf fonts` for listing fonts of a PDF file
+* [HexaPDF::Layout::Style#background_alpha] for defining the opacity of the
+  background
+* [HexaPDF::Type::Page#each_annotation] for iterating over all annotations of a
+  page
+
+### Changed
+
+* **Breaking change**: Handling of AcroForm check boxes to allow multiple
+  widgets with different values
+* CLI command `hexapdf form` to support new check box features
+* [HexaPDF::Content::Canvas#text] to use the font size as leading if no leading
+  has been set
+* [HexaPDF::Content::Canvas#line_with_rounded_corner] to be a public method
+* [HexaPDF::Layout::Style::LineSpacing] to allow using integers or floats as
+  type argument to mean proportional line spacing
+* [HexaPDF::Type::AcroForm::VariableTextField#set_default_appearance_string] to
+  allow specifying font options
+* AcroForm text field creation methods in [HexaPDF::Type::AcroForm::Form] to
+  allow specifying font options
+
+### Fixed
+
+* [HexaPDF::Type::AcroForm::Field#each_widget] to also return widgets of other
+  form fields that have the same name
+* `hexapdf form` to allow filling in multiline and comb text fields
+* `hexapdf form` to correctly work for PDF files containing null values in the
+  list of annotations
+* Handling of files that contain invalid default appearance strings
+* [HexaPDF::Type::AcroForm::TextField#field_value] to allow setting a `nil`
+  value for single line text fields
+* [HexaPDF::Content::GraphicObject::Arc] to respect the value set by the
+  `#max_curves` accessor
+
+
+## 0.16.0 - 2021-09-28
+
+## Added
+
+* Support for RGB color values of the form "RGB" in addition to "RRGGBB" and for
+  CSS color module level 3 color names
+* Conversion module for Integer fields to fix certain invalid PDF files
+
+
 ## 0.15.9 - 2021-09-04
 
 ### Fixed

data/LICENSE

@@ -1,5 +1,5 @@
 HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-Copyright (C) 2014-2020 Thomas Leitner
+Copyright (C) 2014-2021 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/README.md

@@ -37,6 +37,9 @@ doc.write("hello-world.pdf")
 For detailed information have a look at the [HexaPDF website][website] where you will the API
 documentation, example code and more.
 
+It is recommend to use the HTML API documentation provided by the HexaPDF website as it is enhanced
+with example graphics and PDF files and tightly integrated into the rest of the website.
+
 [website]: http://hexapdf.gettalong.org
 
 
@@ -46,8 +49,9 @@ Since HexaPDF is written in Ruby, a working Ruby installation is needed - see th
 [official installation documentation][rbinstall] for details. Note that you need Ruby version 2.4 or
 higher as prior versions are not supported!
 
-Apart from Ruby itself the HexaPDF library has no external dependencies. The `hexapdf` application
-has a dependency on `cmdparse`, a command line parsing library.
+Apart from Ruby itself the HexaPDF library has only one external dependency `geom2d` which is
+written and provided by the HexaPDF authors. The `hexapdf` application has an additional dependency
+on `cmdparse`, a command line parsing library.
 
 HexaPDF itself is distributed via Rubygems and therefore easily installable via `gem install
 hexapdf`.
@@ -90,6 +94,11 @@ So why use HexaPDF?
 [Prawn]: http://prawnpdf.org
 [page canvas API]: https://hexapdf.gettalong.org/api/HexaPDF/Content/Canvas.html
 
+## Development
+
+Clone the repository and then run `rake dev:setup`. This will install the needed Rubygem
+dependencies as well as make sure that all applications needed for the tests are available.
+
 
 ## License
 

data/Rakefile

@@ -34,7 +34,8 @@ namespace :dev do
   end
 
   ENV['REAL_GEM'] = "true"
-  Gem::PackageTask.new(eval(File.read('hexapdf.gemspec'), binding, 'hexapdf.gemspec')) do |pkg|
+  spec = eval(File.read('hexapdf.gemspec'), binding, 'hexapdf.gemspec')
+  Gem::PackageTask.new(spec) do |pkg|
     pkg.need_zip = true
     pkg.need_tar = true
   end

data/examples/002-graphics.rb

@@ -145,13 +145,13 @@ canvas.translate(0, 320) do
   canvas.fill_color(0.4, 0.3, 0.4)
   canvas.move_to(450, 50)
   canvas.line_to(*arc.start_point)
-  arc.curves.each {|c| canvas.curve_to(*c)}
+  arc.curves.each {|x, y, hash| canvas.curve_to(x, y, **hash)}
   canvas.fill
   arc.configure(start_angle: 105, end_angle: -30)
   canvas.fill_color(0.3, 0.7, 0.7)
   canvas.move_to(450, 50)
   canvas.line_to(*arc.start_point)
-  arc.curves.each {|c| canvas.curve_to(*c)}
+  arc.curves.each {|x, y, hash| canvas.curve_to(x, y, **hash)}
   canvas.fill
 
   arc = canvas.graphic_object(:arc, cx: 530, cy: 50, a: 40, b: 20,
@@ -159,13 +159,13 @@ canvas.translate(0, 320) do
   canvas.fill_color(0.4, 0.3, 0.4)
   canvas.move_to(530, 50)
   canvas.line_to(*arc.start_point)
-  arc.curves.each {|c| canvas.curve_to(*c)}
+  arc.curves.each {|x, y, hash| canvas.curve_to(x, y, **hash)}
   canvas.fill
   arc.configure(start_angle: 105, end_angle: -30)
   canvas.fill_color(0.7, 0.7, 0.3)
   canvas.move_to(530, 50)
   canvas.line_to(*arc.start_point)
-  arc.curves.each {|c| canvas.curve_to(*c)}
+  arc.curves.each {|x, y, hash| canvas.curve_to(x, y, **hash)}
   canvas.fill
 end
 

data/lib/hexapdf/cli/batch.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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/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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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
@@ -354,6 +354,15 @@ module HexaPDF
         end
       end
 
+      # Returns the human readable file size.
+      def human_readable_file_size(size)
+        case size
+        when 0..9999 then "#{size}B"
+        when 10_000..999_999 then "#{(size / 1024.to_f).round(1)}K"
+        else "#{(size.to_f / 1024 / 1024).round(1)}M"
+        end
+      end
+
       private
 
       # Displays the given prompt, reads from the console without echo and returns the read string.

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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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

@@ -0,0 +1,145 @@
+# -*- 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-2021 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 'set'
+require 'hexapdf/cli/command'
+
+module HexaPDF
+  module CLI
+
+    # Lists fonts from a PDF file.
+    #
+    # See: HexaPDF::Type::Font
+    class Fonts < Command
+
+      def initialize #:nodoc:
+        super('fonts', takes_commands: false)
+        short_desc("List fonts from a PDF file")
+        long_desc(<<~EOF)
+          Lists the fonts used in the PDF with additional information, sorted by page number.
+        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
+        options.on("-i", "--pages PAGES", "The subset of pages that should be looked at") do |pages|
+          @pages = pages
+        end
+
+        @password = nil
+        @pages = nil
+      end
+
+      def execute(pdf) #:nodoc:
+        with_document(pdf, password: @password) do |doc|
+          printf("%5s %-40s %-12s %-10s %-3s %-3s %8s %9s\n",
+                 "page", "name", "type", "encoding", "emb", "sub", "size", "oid")
+          puts("-" * 97)
+          each_font(doc) do |pindex, font|
+            font_type = case font[:Subtype]
+                        when :Type1
+                          if font.embedded? && font[:FontDescriptor][:FontFile3]
+                            "Type 1C"
+                          else
+                            "Type 1"
+                          end
+                        when :Type3 then "Type 3"
+                        when :TrueType then "TrueType"
+                        when :Type0
+                          if font.descendant_font[:Subtype] == :CIDFontType0
+                            "CID CFF"
+                          else
+                            "CID TrueType"
+                          end
+                        else
+                          "Unknown"
+                        end
+            encoding = font[:Encoding]
+            encoding = if encoding.kind_of?(Symbol)
+                         encoding.to_s.sub(/Encoding/, '')
+                       elsif encoding.kind_of?(Dictionary) &&
+                           [:Type1, :Type3, :TrueType].include?(font[:Subtype])
+                         "Custom"
+                       else
+                         "Built-in"
+                       end
+            size = human_readable_file_size(font.embedded? ? font.font_file[:Length] : 0)
+            embedded = (font.embedded? ? "yes" : "no")
+            subset = (font[:BaseFont].match?(/\A[A-Z]{6}\+/) ? "yes" : "no")
+            printf("%5s %-40s %-12s %-10s %-3s %-3s %8s %9s\n",
+                   pindex, font[:BaseFont], font_type, encoding,
+                   embedded, subset, size, "#{font.oid},#{font.gen}")
+          end
+        end
+      end
+
+      private
+
+      # Iterates over all fonts by page.
+      def each_font(doc) # :yields: obj, index, page_index
+        if @pages
+          pages = parse_pages_specification(@pages, doc.pages.count).each_with_object({}) do |(i, _), h|
+            h[i] = true
+          end
+        end
+        seen = {}
+
+        doc.pages.each_with_index do |page, pindex|
+          next if pages && !pages[pindex]
+          font_proc = lambda do |_, font|
+            next if seen[font]
+            yield(pindex + 1, font)
+            seen[font] = true
+          end
+          page.resources[:Font]&.each(&font_proc)
+          page.resources[:XObject]&.each do |_, xobj|
+            next unless xobj[:Subtype] == :Form
+            xobj.ressources[:Font]&.each(&font_proc)
+          end
+          page.each_annotation do |annotation|
+            appearance = annotation.appearance
+            next unless appearance
+            appearance.resources[:Font]&.each(&font_proc)
+          end
+
+          seen.clear if pages
+        end
+      end
+
+    end
+
+  end
+end

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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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
@@ -108,12 +108,10 @@ module HexaPDF
                 fill_form(doc)
               end
             end
-            if @flatten
-              unless doc.acro_form.flatten.empty?
-                $stderr.puts "Warning: Not all form fields could be flattened"
-                doc.catalog.delete(:AcroForm)
-                doc.delete(doc.acro_form)
-              end
+            if @flatten && !doc.acro_form.flatten.empty?
+              $stderr.puts "Warning: Not all form fields could be flattened"
+              doc.catalog.delete(:AcroForm)
+              doc.delete(doc.acro_form)
             end
           else
             list_form_fields(doc)
@@ -146,8 +144,8 @@ module HexaPDF
           if command_parser.verbosity_info?
             if field.field_type == :Ch
               puts "    └─ Options: #{field.option_items.map(&:inspect).join(', ')}"
-            elsif concrete_field_type == :radio_button
-              puts "    └─ Options: #{field.radio_button_values.map(&:inspect).join(', ')}"
+            elsif concrete_field_type == :radio_button || concrete_field_type == :check_box
+              puts "    └─ Options: #{([:Off] + field.allowed_values).map(&:to_s).join(', ')}"
             end
           end
         end
@@ -170,11 +168,13 @@ module HexaPDF
           puts "    └─ Current value: #{field.field_value.inspect}"
 
           if field.field_type == :Ch
-            puts "    └─ Possible values: #{field.option_items.map(&:inspect).join(', ')}"
+            puts "    └─ Possible values: #{field.option_items.map(&:to_s).join(', ')}"
           elsif concrete_field_type == :radio_button
-            puts "    └─ Possible values: #{field.radio_button_values.map(&:inspect).join(', ')}"
+            puts "    └─ Possible values: Off, #{field.allowed_values.map(&:to_s).join(', ')}"
           elsif concrete_field_type == :check_box
-            puts "    └─ Possible values: y(es), t(rue); n(o), f(alse)"
+            av = field.allowed_values
+            puts "    └─ Possible values: n(o), f(alse); #{av.size == 1 ? 'y(es), t(rue); ' : ''}" \
+              "#{av.map(&:to_s).join(', ')}"
           end
 
           begin
@@ -220,21 +220,22 @@ module HexaPDF
       # Applies the given value to the field.
       def apply_field_value(field, value)
         case field.concrete_field_type
-        when :single_line_text_field
-          field.field_value = value
-        when :combo_box, :list_box
-          field.field_value = value
-        when :editable_combo_box
+        when :single_line_text_field, :multiline_text_field, :comb_text_field, :combo_box,
+            :list_box, :editable_combo_box
           field.field_value = value
         when :check_box
-          unless value.match?(/y(es)?|t(rue)?|f(alse)?|n(o)/)
-            raise HexaPDF::Error, "Invalid input, use one of the possible values"
-          end
-          field.field_value = value.match?(/y(es)?|t(rue)?/)
+          field.field_value = case value
+                              when /y(es)?|t(rue)?/
+                                true
+                              when /n(o)?|f(alse)?/
+                                false
+                              else
+                                value
+                              end
         when :radio_button
-          field.field_value = value.intern
+          field.field_value = value.to_sym
         else
-          raise "Field type not yet supported"
+          raise "Field type #{field.concrete_field_type} not yet supported"
         end
       end
 
@@ -244,13 +245,13 @@ module HexaPDF
         seen = {}
 
         doc.pages.each_with_index do |page, page_index|
-          page[:Annots]&.each do |annotation|
+          page.each_annotation do |annotation|
             next unless annotation[:Subtype] == :Widget
             field = annotation.form_field
             next if field.concrete_field_type == :push_button
-            unless seen[field]
+            unless seen[field.full_field_name]
               yield(page, page_index, field, annotation)
-              seen[field] = true
+              seen[field.full_field_name] = true
             end
           end
         end

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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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
@@ -197,15 +197,6 @@ module HexaPDF
         end
       end
 
-      # Returns the human readable file size.
-      def human_readable_file_size(size)
-        case size
-        when 0..9999 then "#{size}B"
-        when 10_000..999_999 then "#{(size / 1024.to_f).round(1)}K"
-        else "#{(size.to_f / 1024 / 1024).round(1)}M"
-        end
-      end
-
     end
 
   end

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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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/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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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/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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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/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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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 @@ require 'hexapdf/cli/split'
 require 'hexapdf/cli/watermark'
 require 'hexapdf/cli/image2pdf'
 require 'hexapdf/cli/form'
+require 'hexapdf/cli/fonts'
 require 'hexapdf/version'
 require 'hexapdf/document'
 
@@ -101,6 +102,7 @@ module HexaPDF
         add_command(HexaPDF::CLI::Watermark.new)
         add_command(HexaPDF::CLI::Image2PDF.new)
         add_command(HexaPDF::CLI::Form.new)
+        add_command(HexaPDF::CLI::Fonts.new)
         add_command(CmdParse::HelpCommand.new)
         version_command = CmdParse::VersionCommand.new(add_switches: false)
         add_command(version_command)

data/lib/hexapdf/composer.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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/configuration.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2020 Thomas Leitner
+# Copyright (C) 2014-2021 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
@@ -203,6 +203,12 @@ module HexaPDF
   #
   #    In nearly all cases this option should not be changed from its default setting!
   #
+  # document.on_invalid_string::
+  #    A callable object that takes the invalid UTF-16BE encoded string and returns a valid UTF-8
+  #    encoded string.
+  #
+  #    The default is to remove all invalid characters.
+  #
   # encryption.aes::
   #    The class that should be used for AES encryption. If the value is a String, it should
   #    contain the name of a constant to such a class.
@@ -245,7 +251,7 @@ module HexaPDF
   #    Defines a mapping from font names and variants to font files.
   #
   #    The value needs to be a hash of the form:
-  #      {"font_name": {variant: file_name, variant2: file_name2, ...}, ...}
+  #      {"font_name" => {variant: file_name, variant2: file_name2, ...}, ...}
   #
   #    Once a font is registered in this way, the font name together with a variant name can be used
   #    with the HexaPDF::Document::Fonts#add method to load the font.
@@ -380,6 +386,9 @@ module HexaPDF
                       end,
                       'acro_form.text_field.default_width' => 100,
                       'document.auto_decrypt' => true,
+                      'document.on_invalid_string' => proc do |str|
+                        str.encode(Encoding::UTF_8, invalid: :replace, replace: '')
+                      end,
                       'encryption.aes' => 'HexaPDF::Encryption::FastAES',
                       'encryption.arc4' => 'HexaPDF::Encryption::FastARC4',
                       'encryption.filter_map' => {