hexapdf 0.45.0 → 0.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd31e769d2a906198da2a4194085cb2a884fa3879442b75add168d7f81d67d8b
-  data.tar.gz: 43c2b4ba4df2f997d470835995f2581aa306c639c63ddc892e648d94605f3b22
+  metadata.gz: f9c1a35d4ad93b48faa1f728bcddc91778da584c8d673e2f15557bd22050a438
+  data.tar.gz: 2ef8ca70891723643080a402f0808882f66f01a816c422477cc03fad34774859
 SHA512:
-  metadata.gz: f17a303dba8104974564a213c72c0f0862c520964a3255b575544489ccb5a17a468d093d3970817903c4eb798e888592410db18447d3264d535f3a01a4a94c82
-  data.tar.gz: d5727e2f2bfb5ed827ac92eecc8cd9e0ba73044150ba07d03623dccde43dc29db1cddc2fbce24bfd63268522e7965519e188271c2bc9c00162b1a660fc468b74
+  metadata.gz: 87c109bd8a6711b4df27a40c689a025d816075d6c68c21a1cc22924b5ae827cd44d98e45bff8f43c85403dd82d6a6e54b66c99bfe135298cba33292e9511a1fc
+  data.tar.gz: e0529e3e244be8366e722ea29ab06a8b922f18698526c79a28d5d11f02da5ee103cba71ecbc6882fefe3de27f02d38f8ce8b505fefbb45839069c74aefaed9ae

data/CHANGELOG.md

@@ -1,3 +1,43 @@
+## 0.46.0 - 2024-08-11
+
+### Added
+
+* [HexaPDF::DigitalSignature::CMSHandler#embedded_tsa_signature] to return the
+  embedded timestamp authority signature if any
+* [HexaPDF::DigitalSignature::Signing::DefaultHandler#signing_time] for setting
+  a custom signing time
+* [HexaPDF::Document#duplicate] for making an in-memory copy of a PDF document
+* Configuration option 'font.default' for setting the default font for the
+  document layout engine
+
+### Changed
+
+* [HexaPDF::Document::Layout::CellArgumentCollector#[]=] to allow stepped ranges
+* [HexaPDF::Document::Layout::ChildrenCollector] to also return the box when
+  creating and adding one to the list
+* [HexaPDF::Layout::InlineBox] to allow usage without predefined width
+* [HexaPDF::DigitalSignature::CMSHandler#verify] to recognize non-repudiation
+  signatures
+* [HexaPDF::DigitalSignature::CMSHandler#signing_time] to use time from an
+  embedded timestamp authority signature if possible
+* [HexaPDF::Layout::Box#fit] to return success for boxes with content
+  width/height of zero
+* [HexaPDF::Importer::copy] to optionally allow copying the catalog and page
+  tree nodes
+
+### Fixed
+
+* Setting of correct x-position in fit result for boxes with flow positioning
+* [HexaPDF::Layout::ListBox#fit] to respect the set height
+* CLI command `hexapdf inspect` to work in case of missing Unicde mappings
+* [HexaPDF::Type::AcroForm::Form#delete_field] to correctly work for fields with
+  an embedded widget
+* Parsing of "linearized" PDF files where the first cross-reference section
+  isn't actually used
+* [HexaPDF::Layout::PageStyle#create_page] to return new frame objects on each
+  invocation
+
+
 ## 0.45.0 - 2024-06-18
 
 ### Added
@@ -375,8 +415,8 @@
 
 ### Fixed
 
-* [HexaPDF::Document::Pages#add_labelling_range] to add a correct entry for
-  the default range starting at page 1
+* [HexaPDF::Document::Pages#add_labelling_range] to add a correct entry for the
+  default range starting at page 1
 * [HexaPDF::Type::Page#flatten_annotations] to correctly handle scaled
   appearances
 * Using an unknown style name in [HexaPDF:Document::Layout] method by providing
@@ -387,6 +427,8 @@
   than the item content height
 * [HexaPDF::Dictionary] setting default values on wrong classes in certain
   situations
+* [HexaPDF::Importer#import] to correctly import stream objects backed by a
+  [HexaPDF::FiberDoubleForString]
 
 
 ## 0.33.0 - 2023-08-02
@@ -439,8 +481,8 @@
 * [HexaPDF::Content::Canvas#text] to set the leading only when multiple lines
   are drawn
 * [HexaPDF::Layout::TextBox#split] to use float comparison
-* Validation of standard encryption dictionary to auto-correct invalid /U and
-  /O fields in case they are padded with zeros
+* Validation of standard encryption dictionary to auto-correct invalid /U and /O
+  fields in case they are padded with zeros
 * [HexaPDF::Document#wrap] handling of sub-type mapping in case of missing type
 * [HexaPDF::Type::AcroForm::AppearanceGenerator] to also take a text field
   widget's width into account when auto-sizing
@@ -761,8 +803,8 @@
 * Support for the document outline
 * [HexaPDF::Layout::Style#line_height] for setting a custom line height
   independent of the font size
-* [HexaPDF::Document::Destinations#use_or_create] as unified interface for
-  using or creating destinations
+* [HexaPDF::Document::Destinations#use_or_create] as unified interface for using
+  or creating destinations
 * [HexaPDF::Document::Destinations::Destination#valid?] and class method for
   checking whether a destination array is valid
 
@@ -771,8 +813,8 @@
 * Calculation of text related [HexaPDF::Layout::Style] values for Type3 fonts
 * [HexaPDF::Encryption::SecurityHandler#encrypt_string] to either return a
   dupped or encrypted string
-* [HexaPDF::Layout::TextLayouter#fit] to avoid infinite loop when encountering
-  a non-zero width breakpoint penalty
+* [HexaPDF::Layout::TextLayouter#fit] to avoid infinite loop when encountering a
+  non-zero width breakpoint penalty
 * [HexaPDF::Type::ObjectStream] to parse the initial stream data right after
   initialization to avoid access errors
 * [HexaPDF::Revisions::from_io] to merge a completely empty revision with just a
@@ -854,8 +896,7 @@
   fragment if there would not be enough height left anyway
 * [HexaPDF::Layout::WidthFromPolygon] to work correctly in case of very small
   floating point errors
-* HexaPDF::Layout::TextFragment#inspect to work in case of interspersed
-  numbers
+* HexaPDF::Layout::TextFragment#inspect to work in case of interspersed numbers
 * [HexaPDF::Layout::TextBox#split] to work for position :flow when box is wider
   than the initial available width
 * [HexaPDF::Layout::Frame#fit] to create minimally sized mask rectangles
@@ -1137,8 +1178,8 @@
   dictionary are indirect objects
 * [HexaPDF::Content::GraphicObject::EndpointArc] to correctly determine the
   start and end points
-* HexaPDF::Dictionary#perform_validation to correctly handle objects that
-  should not be indirect objects
+* HexaPDF::Dictionary#perform_validation to correctly handle objects that should
+  not be indirect objects
 
 
 ## 0.17.3 - 2021-10-31
@@ -1260,8 +1301,8 @@
 
 ### Fixed
 
-* [HexaPDF::Type::Annotation#appearance] to handle cases where there is
-  no valid appearance stream
+* [HexaPDF::Type::Annotation#appearance] to handle cases where there is no valid
+  appearance stream
 
 
 ## 0.15.3 - 2021-05-01
@@ -1316,8 +1357,8 @@
   empty background color arrays
 * [HexaPDF::Type::AcroForm::Field#delete_widget] to update the wrapper object
   stored in the document in case the widget is embedded
-* Processing of invalid PDF files containing a space,CR,LF combination after
-  the 'stream' keyword
+* Processing of invalid PDF files containing a space,CR,LF combination after the
+  'stream' keyword
 * Cross-reference stream reconstruction with respect to detection of linearized
   files
 * Detection of existing appearances for AcroForm push button fields when
@@ -1412,8 +1453,8 @@
 
 * [HexaPDF::Utils::ObjectHash#oids] to be public instead of private
 * Cross-reference table parsing to handle invalidly numbered main sections
-* [HexaPDF::Document#cache] and [HexaPDF::Object#cache] to allow updating
-  values for existing keys
+* [HexaPDF::Document#cache] and [HexaPDF::Object#cache] to allow updating values
+  for existing keys
 * Appearance creation methods of AcroForm objects to allow forcing the creation
   of new appearances
 * [HexaPDF::Type::AcroForm::AppearanceGenerator#create_text_appearances] to
@@ -1451,8 +1492,8 @@
   new 'parser.try_xref_reconstruction' option
 * Two new `hexapdf inspect` commands for showing page objects and page content
   streams by page number
-* Flag `--check` to the CLI command `hexapdf info` for checking a file for
-  parse and validation errors
+* Flag `--check` to the CLI command `hexapdf info` for checking a file for parse
+  and validation errors
 * [HexaPDF::Type::AcroForm::Field#embedded_widget?] for checking if a widget is
   embedded in the field object
 * [HexaPDF::Type::AcroForm::Field#delete_widget] for deleting a widget
@@ -1509,8 +1550,8 @@
 
 ### Added
 
-* [HexaPDF::Font::Encoding::Base#code] for retrieving the code for a given
-  glyph name
+* [HexaPDF::Font::Encoding::Base#code] for retrieving the code for a given glyph
+  name
 
 ### Fixed
 
@@ -1526,11 +1567,11 @@
   [HexaPDF::Type::AcroForm::Field]
 * [HexaPDF::Type::AcroForm::TextField] and
   [HexaPDF::Type::AcroForm::VariableTextField] for basic text field support
-* [HexaPDF::Type::AcroForm::ButtonField] for push button, radio button and
-  check box support
+* [HexaPDF::Type::AcroForm::ButtonField] for push button, radio button and check
+  box support
 * [HexaPDF::Type::AcroForm::ChoiceField] for combo box and list box support
-* [HexaPDF::Type::AcroForm::AppearanceGenerator] as central class for
-  generating appearance streams for form fields
+* [HexaPDF::Type::AcroForm::AppearanceGenerator] as central class for generating
+  appearance streams for form fields
 * Various convenience methods for [HexaPDF::Type::AcroForm::Form]
 * Various convenience methods for [HexaPDF::Type::AcroForm::Field]
 * Various convenience methods for [HexaPDF::Type::Annotations::Widget]
@@ -1549,8 +1590,8 @@
 * [HexaPDF::Type::Annotation::Border] class
 * [HexaPDF::Content::ColorSpace::device_color_from_specification] for easily
   getting a device color object
-* [HexaPDF::Content::ColorSpace::prenormalized_device_color] for getting a device
-  color object without normalizing values
+* [HexaPDF::Content::ColorSpace::prenormalized_device_color] for getting a
+  device color object without normalizing values
 * [HexaPDF::Type::Annotation#appearance] for returning the associated appearance
   dictionary
 * [HexaPDF::Type::Annotation#appearance?] for checking whether an appearance for
@@ -1669,8 +1710,8 @@
 
 ### Fixed
 
-* Conversion of [HexaPDF::Rectangle] type when the original is not a plain
-  Array but a [HexaPDF::PDFArray]
+* Conversion of [HexaPDF::Rectangle] type when the original is not a plain Array
+  but a [HexaPDF::PDFArray]
 
 
 ## 0.11.1 - 2019-11-19
@@ -1831,12 +1872,12 @@
 
 ### Added
 
-* [HexaPDF::Layout::Frame] for box positioning and easier text layouting
-  inside an arbitrary polygon
+* [HexaPDF::Layout::Frame] for box positioning and easier text layouting inside
+  an arbitrary polygon
 * [HexaPDF::Layout::TextBox] for displaying text in a rectangular and for
   flowing text inside a frame
-* [HexaPDF::Layout::WidthFromPolygon] for getting a width specification from
-  a polygon for use with the text layouting engine
+* [HexaPDF::Layout::WidthFromPolygon] for getting a width specification from a
+  polygon for use with the text layouting engine
 * [HexaPDF::Type::Image#width] and [HexaPDF::Type::Image#height] convenience
   methods
 * [HexaPDF::Type::FontType3] for Type 3 font support
@@ -1888,12 +1929,12 @@
   character in a text fragment is \r
 * [HexaPDF::Layout::TextLayouter] to work if an optional break point (think
   soft-hyphen) is followed by whitespace
-* [HexaPDF::Font::TrueType::Builder] to correctly order the entries in the
-  table directory
+* [HexaPDF::Font::TrueType::Builder] to correctly order the entries in the table
+  directory
 * [HexaPDF::Font::TrueType::Builder] to pad the table data to achieve the
   correct alignment
-* [HexaPDF::Filter::FlateDecode] by removing the Zlib pools since they were
-  not thread safe
+* [HexaPDF::Filter::FlateDecode] by removing the Zlib pools since they were not
+  thread safe
 * All color space classes to accept the color space definition as argument to
   `::new`
 
@@ -1925,9 +1966,8 @@
 * Cross-reference subsection parsing can handle missing whitespace
 * Renamed HexaPDF::Layout::LineFragment to [HexaPDF::Layout::Line]
 * Renamed HexaPDF::Layout::TextBox to [HexaPDF::Layout::TextLayouter]
-* [HexaPDF::Layout::TextFragment::new] and
-  [HexaPDF::Layout::TextLayouter::new] to either take a Style object or
-  style options
+* [HexaPDF::Layout::TextFragment::new] and [HexaPDF::Layout::TextLayouter::new]
+  to either take a Style object or style options
 * [HexaPDF::Layout::TextLayouter#fit] method signature
 * [HexaPDF::Layout::InlineBox] to wrap a generic box
 * HexaPDF::Document::Fonts#load to [HexaPDF::Document::Fonts#add] for
@@ -1989,8 +2029,8 @@
 
 * Handling of invalid glyphs is done using the special
   [HexaPDF::Font::InvalidGlyph] class
-* Configuration option 'font.on_missing_glyph'; returns an invalid glyph
-  instead of raising an error
+* Configuration option 'font.on_missing_glyph'; returns an invalid glyph instead
+  of raising an error
 * Bounding box of TrueType glyphs without contours is set to `[0, 0, 0, 0]`
 * Ligature pairs for AFM fonts are stored like kerning pairs
 * Use TrueType configuration option 'font.true_type.unknown_format' in all
@@ -2007,8 +2047,8 @@
 
 * [HexaPDF::Task::Dereference] to work correctly when encountering invalid
   references
-* [HexaPDF::Tokenizer] and HexaPDF::Content::Tokenizer to parse a solitary
-  plus sign
+* [HexaPDF::Tokenizer] and HexaPDF::Content::Tokenizer to parse a solitary plus
+  sign
 * Usage of Strings instead of Symbols for AFM font kerning and ligature pairs
 * Processing the contents of form XObjects in case they don't have a resources
   dictionary
@@ -2031,8 +2071,8 @@
 * CLI option `--verbose` for more verbose output; also changed the default
   verbosity level to only display warnings and not informational messages
 * CLI option `--quiet` for suppressing additional and diagnostic output
-* CLI option `--strict` for enabling strict parsing and validation; also
-  changed the default from strict to non-strict parsing/validation
+* CLI option `--strict` for enabling strict parsing and validation; also changed
+  the default from strict to non-strict parsing/validation
 * CLI optimization option `--optimize-fonts` for optimizing embedded fonts
 * Method `#word_spacing_applicable?` to font types
 * Support for marked-content points and sequences in [HexaPDF::Content::Canvas]

data/examples/019-acro_form.rb

@@ -6,6 +6,11 @@
 # This example show-cases how to create the various form field types and their
 # possible standard appearances.
 #
+# The [HexaPDF::Type::AcroForm::Form] and [HexaPDF::Type::AcroForm::Field]
+# classes provide a plethora of convenience methods for working with forms, like
+# for creating fields and their widgets, getting field properties like the full
+# hierarchical field name or for setting the field value.
+#
 # Usage:
 # : `ruby acro_form.rb`
 #

data/lib/hexapdf/cli/inspect.rb

@@ -117,6 +117,11 @@ module HexaPDF
 
       def execute(file, *commands) #:nodoc:
         with_document(file, password: @password) do |doc|
+          doc.config['font.on_missing_unicode_mapping'] = lambda do |code, font|
+            $stderr.puts("No Unicode mapping for code point #{code} in font #{font[:BaseFont]}, " \
+                         "using the Unicode replacement character")
+            "\u{FFFD}"
+          end
           @doc = doc
           if commands.empty?
             begin

data/lib/hexapdf/composer.rb

@@ -450,7 +450,7 @@ module HexaPDF
             (box = draw_box; break) unless box
           elsif !@frame.find_next_region
             unless drawn_on_page
-              raise HexaPDF::Error, "Box doesn't fit on empty page"
+              raise HexaPDF::Error, "Box didn't fit multiple times, even on empty page"
             end
             new_page
             drawn_on_page = false

data/lib/hexapdf/configuration.rb

@@ -277,6 +277,13 @@ module HexaPDF
   #
   #    See PDF2.0 s7.4.1, ADB sH.3 3.3
   #
+  # font.default::
+  #    This font is used by the layout engine when no font is specified but one is needed.
+  #
+  #    This is used, for example, for the font set on styles that don't have a font set.
+  #
+  #    The default value is 'Times'.
+  #
   # font.fallback::
   #    An array of fallback font names to be used when replacing invalid glyphs.
   #
@@ -518,6 +525,7 @@ module HexaPDF
                         Crypt: 'HexaPDF::Filter::Crypt',
                         Encryption: 'HexaPDF::Filter::Encryption',
                       },
+                      'font.default' => 'Times',
                       'font.fallback' => ['ZapfDingbats', 'Symbol'],
                       'font.map' => {},
                       'font.on_invalid_glyph' => method(:font_on_invalid_glyph),

data/lib/hexapdf/digital_signature/cms_handler.rb

@@ -59,7 +59,11 @@ module HexaPDF
 
       # Returns the time of signing.
       def signing_time
-        signer_info.signed_time rescue super
+        if embedded_tsa_signature
+          embedded_tsa_signature.signers.first.signed_time
+        else
+          signer_info.signed_time rescue super
+        end
       end
 
       # Returns the certificate chain.
@@ -78,6 +82,23 @@ module HexaPDF
         @pkcs7.signers.first
       end
 
+      # Returns the OpenSSL::PKCS7 object for the embedded TSA signature if there is one or +nil+
+      # otherwise.
+      def embedded_tsa_signature
+        return @embedded_tsa_signature if defined?(@embedded_tsa_signature)
+
+        @embedded_tsa_signature = nil
+        p7 = OpenSSL::ASN1.decode(signature_dict.contents.sub(/\x00*\z/, ''))
+        signed_data = p7.value[1].value[0]
+        signer_info = signed_data.value[-1].value[0] # first (and only) signer info
+        return unless signer_info.value[-1].tag == 1 # check for unsigned attributes
+        timestamp_token = signer_info.value[-1].value.find do |unsigned_attr|
+          unsigned_attr.value[0].value == "id-smime-aa-timeStampToken"
+        end
+        return unless timestamp_token
+        @embedded_tsa_signature = OpenSSL::PKCS7.new(timestamp_token.value[1].value[0])
+      end
+
       # Verifies the signature using the provided OpenSSL::X509::Store object.
       def verify(store, allow_self_signed: false)
         result = super
@@ -101,9 +122,16 @@ module HexaPDF
           return result
         end
 
+        if embedded_tsa_signature
+          result.log(:info, 'Signing time comes from timestamp authority')
+        end
+
         key_usage = signer_certificate.extensions.find {|ext| ext.oid == 'keyUsage' }
-        unless key_usage && key_usage.value.split(', ').include?("Digital Signature")
-          result.log(:error, "Certificate key usage is missing 'Digital Signature'")
+        key_usage = key_usage&.value&.split(', ')
+        if key_usage&.include?("Non Repudiation") && !key_usage.include?("Digital Signature")
+          result.log(:info, 'Certificate used for non-repudiation')
+        elsif !key_usage || !key_usage.include?("Digital Signature")
+          result.log(:error, "Certificate key usage is missing 'Digital Signature' or 'Non Repudiation'")
         end
 
         if signature_dict.signature_type == 'ETSI.RFC3161'

data/lib/hexapdf/digital_signature/signing/default_handler.rb

@@ -211,6 +211,13 @@ module HexaPDF
         # The contact information. If used, will be set on the signature dictionary.
         attr_accessor :contact_info
 
+        # The custom signing time.
+        #
+        # The signing time is usually the time when signing actually happens. This is also what
+        # HexaPDF uses. If it is known that signing happened at a different point in time, that time
+        # can be provided using this accessor.
+        attr_accessor :signing_time
+
         # The size of the serialized signature that should be reserved.
         #
         # If this attribute is not set, an empty string will be signed using #sign to determine the
@@ -277,7 +284,7 @@ module HexaPDF
         def finalize_objects(_signature_field, signature)
           signature[:Filter] = :'Adobe.PPKLite'
           signature[:SubFilter] = (signature_type == :pades ? :'ETSI.CAdES.detached' : :'adbe.pkcs7.detached')
-          signature[:M] = Time.now
+          signature[:M] = self.signing_time ||= Time.now
           signature[:Reason] = reason if reason
           signature[:Location] = location if location
           signature[:ContactInfo] = contact_info if contact_info
@@ -312,6 +319,7 @@ module HexaPDF
                                      type: signature_type,
                                      certificate: certificate, key: key,
                                      digest_algorithm: digest_algorithm,
+                                     signing_time: signing_time,
                                      timestamp_handler: timestamp_handler,
                                      certificates: certificate_chain, &external_signing).to_der
           else

data/lib/hexapdf/digital_signature/signing/signed_data_creator.rb

@@ -84,6 +84,9 @@ module HexaPDF
         # Allowed values: sha256, sha384, sha512.
         attr_accessor :digest_algorithm
 
+        # The signing time to use instead of Time.now.
+        attr_accessor :signing_time
+
         # The timestamp handler instance that should be used for timestamping.
         attr_accessor :timestamp_handler
 
@@ -119,9 +122,10 @@ module HexaPDF
 
         # Creates the set of signed attributes for the signer information structure.
         def create_signed_attrs(data, signing_time: true)
+          signing_time = (self.signing_time || Time.now).utc if signing_time
           set(
             attribute('content-type', oid('id-data')),
-            (attribute('id-signingTime', utc_time(Time.now.utc)) if signing_time),
+            (attribute('id-signingTime', utc_time(signing_time)) if signing_time),
             attribute(
               'message-digest',
               binary(OpenSSL::Digest.digest(@digest_algorithm, data))

data/lib/hexapdf/document/layout.rb

@@ -77,9 +77,9 @@ module HexaPDF
     #
     # One style property, Layout::Style#font, is handled specially:
     #
-    # * If no font is set on a style, the font "Times" is automatically set because otherwise there
-    #   would be problems with text drawing operations (font is the only style property that has no
-    #   valid default value).
+    # * If no font is set on a style, the default font specified via the configuration option
+    #   'font.default' is automatically set because otherwise there would be problems with text
+    #   drawing operations (font is the only style property that has no valid default value).
     #
     # * Standard style objects only allow font wrapper objects to be set via the Layout::Style#font
     #   method. This class makes usage easier by allowing strings or an array [name, options_hash]
@@ -151,7 +151,9 @@ module HexaPDF
         # :nodoc:
         def method_missing(name, *args, **kwargs, &block)
           if @layout.box_creation_method?(name)
-            @children << @layout.send(name, *args, **kwargs, &block)
+            box = @layout.send(name, *args, **kwargs, &block)
+            @children << box
+            box
           else
             super
           end
@@ -354,6 +356,7 @@ module HexaPDF
                                       width: width, height: height, properties: properties,
                                       style: box_style)
       end
+      alias text text_box
 
       # Creates a HexaPDF::Layout::TextBox like #text_box but allows parts of the text to be
       # formatted differently.
@@ -456,6 +459,7 @@ module HexaPDF
         box_class_for_name(:text).new(items: data, width: width, height: height,
                                       properties: properties, style: box_style)
       end
+      alias formatted_text formatted_text_box
 
       # Creates a HexaPDF::Layout::ImageBox for the given image.
       #
@@ -477,6 +481,7 @@ module HexaPDF
         box_class_for_name(:image).new(image: image, width: width, height: height,
                                        properties: properties, style: style)
       end
+      alias image image_box
 
       # This helper class is used by Layout#table_box to allow specifying the keyword arguments used
       # when converting cell data to box instances.
@@ -495,8 +500,25 @@ module HexaPDF
           @number_of_columns = number_of_columns
         end
 
-        # Stores the keyword arguments in +args+ for the given 0-based rows and columns which can
-        # either be a single number or a range of numbers.
+        # Stores the hash +args+ containing styling properties for the cells specified via the given
+        # 0-based rows and columns.
+        #
+        # Rows and columns can either be single numbers, ranges of numbers or stepped ranges (i.e.
+        # Enumerator::ArithmeticSequence instances).
+        #
+        # Examples:
+        #
+        #   # Gray background for all cells
+        #   args[] = {cell: {background_color: "gray"}}
+        #
+        #   # Cell at (2, 3) gets a bigger font size
+        #   args[2, 3] = {font_size: 50}
+        #
+        #   # First column of every row has bold font
+        #   args[0..-1, 0] = {font: 'Helvetica bold'}
+        #
+        #   # Every second row has a blue background
+        #   args[(0..-1).step(2)] = {cell: {background_color: "blue"}}
         def []=(rows = 0..-1, cols = 0..-1, args)
           rows = adjust_range(rows.kind_of?(Integer) ? rows..rows : rows, @number_of_rows)
           cols = adjust_range(cols.kind_of?(Integer) ? cols..cols : cols, @number_of_columns)
@@ -509,7 +531,7 @@ module HexaPDF
         # is merged.
         def retrieve_arguments_for(row, col)
           @argument_infos.each_with_object({}) do |arg_info, result|
-            next unless arg_info.rows.cover?(row) && arg_info.cols.cover?(col)
+            next unless arg_info.rows.include?(row) && arg_info.cols.include?(col)
             if arg_info.args[:cell]
               arg_info.args[:cell] = (result[:cell] || {}).merge(arg_info.args[:cell])
             end
@@ -522,7 +544,8 @@ module HexaPDF
         # Adjusts the +range+ so that both the begin and the end of the range are zero or positive
         # integers smaller than +max+.
         def adjust_range(range, max)
-          (range.begin % max)..(range.end % max)
+          r = (range.begin % max)..(range.end % max)
+          range.kind_of?(Range) ? r : r.step(range.step)
         end
 
       end
@@ -540,7 +563,8 @@ module HexaPDF
       # Additional arguments for the #text_box invocations can be specified using the optional block
       # that yields a CellArgumentCollector instance. This allows customization of the text boxes.
       # By specifying the special key +:cell+ it is also possible to assign style properties to the
-      # cells themselves.
+      # cells themselves, irrespective of the type of content of the cells. See
+      # CellArgumentCollector#[]= for details.
       #
       # See HexaPDF::Layout::TableBox::new for details on +column_widths+, +header+, +footer+, and
       # +cell_style+.
@@ -586,6 +610,7 @@ module HexaPDF
                                        footer: footer, cell_style: cell_style, width: width,
                                        height: height, properties: properties, style: style)
       end
+      alias table table_box
 
       LOREM_IPSUM = [ # :nodoc:
         "Lorem ipsum dolor sit amet, con\u{00AD}sectetur adipis\u{00AD}cing elit, sed " \
@@ -605,22 +630,13 @@ module HexaPDF
       def lorem_ipsum_box(sentences: 4, count: 1, **text_box_properties)
         text_box(([LOREM_IPSUM[0, sentences].join(" ")] * count).join("\n\n"), **text_box_properties)
       end
+      alias lorem_ipsum lorem_ipsum_box
 
-      BOX_METHOD_NAMES = [:text, :formatted_text, :image, :table, :lorem_ipsum] #:nodoc:
-
-      # Allows creating boxes using more convenient method names:
-      #
-      # * #text for #text_box
-      # * #formatted_text for #formatted_text_box
-      # * #image for #image_box
-      # * #lorem_ipsum for #lorem_ipsum_box
-      # * The name of a pre-defined box class like #column will invoke #box appropriately. Same if
-      #   used with a '_box' suffix.
+      # Allows creating boxes using more convenient method names: The name of a pre-defined box
+      # class like #column will invoke #box appropriately. Same if used with a '_box' suffix.
       def method_missing(name, *args, **kwargs, &block)
         name_without_box = name.to_s.sub(/_box$/, '').intern
-        if BOX_METHOD_NAMES.include?(name)
-          send("#{name}_box", *args, **kwargs, &block)
-        elsif @document.config['layout.boxes.map'].key?(name_without_box)
+        if @document.config['layout.boxes.map'].key?(name_without_box)
           box(name_without_box, *args, **kwargs, &block)
         else
           super
@@ -632,6 +648,8 @@ module HexaPDF
         box_creation_method?(name) || super
       end
 
+      BOX_METHOD_NAMES = [:text, :formatted_text, :image, :table, :lorem_ipsum] #:nodoc:
+
       # :nodoc:
       def box_creation_method?(name)
         name = name.to_s.sub(/_box$/, '').intern
@@ -648,8 +666,8 @@ module HexaPDF
         end
       end
 
-      # Retrieves the appropriate HexaPDF::Layout::Style object based on the +style+ and +properties+
-      # arguments.
+      # Retrieves the appropriate HexaPDF::Layout::Style object based on the +style+ and
+      # +properties+ arguments.
       #
       # The +style+ argument specifies the style to retrieve. It can either be a registered style
       # name (see #style), a hash with style properties or +nil+. In the latter case the registered
@@ -658,15 +676,18 @@ module HexaPDF
       # If the +properties+ hash is not empty, the retrieved style is duplicated and the properties
       # hash is applied to it.
       #
-      # Finally, a default font (the one from the :base style or otherwise 'Times') is set if
-      # necessary to ensure that the style object works in all cases.
+      # Finally, a default font (the one from the :base style or otherwise the one set using the
+      # configuration option 'font.default') is set if necessary to ensure that the style object
+      # works in all cases.
       def retrieve_style(style, properties = nil)
         if style.kind_of?(Symbol) && !@styles.key?(style)
           raise HexaPDF::Error, "Style #{style} not defined"
         end
         style = HexaPDF::Layout::Style.create(@styles[style] || style || @styles[:base])
         style = style.dup.update(**properties) unless properties.nil? || properties.empty?
-        style.font(@styles[:base].font? && @styles[:base].font || 'Times') unless style.font?
+        unless style.font?
+          style.font(@styles[:base].font? && @styles[:base].font || @document.config['font.default'])
+        end
         unless style.font.respond_to?(:pdf_object)
           name, options = *style.font
           style.font(@document.fonts.add(name, **(options || {})))