hexapdf 0.32.2 → 0.34.0

data/lib/hexapdf/type/page.rb

@@ -54,7 +54,7 @@ module HexaPDF
     # Field inheritance means that if a field is not set on the page object itself, the value is
     # taken from the nearest page tree ancestor that has this value set.
     #
-    # See: PDF1.7 s7.7.3.3, s7.7.3.4, Pages
+    # See: PDF2.0 s7.7.3.3, s7.7.3.4, Pages
     class Page < Dictionary
 
       # The predefined paper sizes in points (1/72 inch):
@@ -223,7 +223,7 @@ module HexaPDF
       #     The art box defines the region of the page's meaningful content as intended by the
       #     author. The default is the crop box.
       #
-      # See: PDF1.7 s14.11.2
+      # See: PDF2.0 s14.11.2
       def box(type = :crop, rectangle = nil)
         if rectangle
           case type
@@ -261,12 +261,23 @@ module HexaPDF
       # Rotates the page +angle+ degrees counterclockwise where +angle+ has to be a multiple of 90.
       #
       # Positive values rotate the page to the left, negative values to the right. If +flatten+ is
-      # +true+, the rotation is not done via the page's meta data but by "rotating" the canvas
-      # itself.
+      # +true+, the rotation is not done via the page's meta (i.e. the /Rotate key) data but by
+      # rotating the canvas itself and all other necessary objects like the various page boxes and
+      # annotations.
       #
-      # Note that the :Rotate key of a page object describes the angle in a clockwise orientation
-      # but this method uses counterclockwise rotation to be consistent with other rotation methods
-      # (e.g. HexaPDF::Content::Canvas#rotate).
+      # Notes:
+      #
+      # * The given +angle+ is applied in addition to a possibly already existing rotation
+      #   (specified via the /Rotate key) and does not replace it.
+      #
+      # * Specifying 0 for +angle+ is valid and means that no additional rotation should be applied.
+      #   The only meaningful usage of 0 for +angle+ is when +flatten+ is set to +true+ (so that the
+      #   /Rotate key is removed and the existing rotation information incorporated into the canvas,
+      #   page boxes and annotations).
+      #
+      # * The /Rotate key of a page object describes the angle in a clockwise orientation but this
+      #   method uses counterclockwise rotation to be consistent with other rotation methods (e.g.
+      #   HexaPDF::Content::Canvas#rotate).
       def rotate(angle, flatten: false)
         if angle % 90 != 0
           raise ArgumentError, "Page rotation has to be multiple of 90 degrees"
@@ -423,7 +434,7 @@ module HexaPDF
       #
       #    To check whether the origin has been translated or not, use
       #
-      #      canvas.graphics_state.ctm.evaluate(0, 0)
+      #      canvas.pos(0, 0)
       #
       #    and check whether the result is [0, 0]. If it is, then the origin has not been
       #    translated.
@@ -522,8 +533,8 @@ module HexaPDF
       # Yields each annotation of this page.
       def each_annotation
         return to_enum(__method__) unless block_given?
-        self[:Annots]&.each do |annotation|
-          next unless annotation
+        Array(self[:Annots]).each do |annotation|
+          next unless annotation&.key?(:Subtype) && annotation&.key?(:Rect)
           yield(document.wrap(annotation, type: :Annot))
         end
         self
@@ -539,14 +550,18 @@ module HexaPDF
       # If an annotation is a form field widget, only the widget will be deleted but not the form
       # field itself.
       def flatten_annotations(annotations = self[:Annots])
-        not_flattened = (annotations || []).to_ary
+        not_flattened = Array(annotations) || []
         return not_flattened unless key?(:Annots)
 
-        annotations = not_flattened & self[:Annots] if annotations != self[:Annots]
+        annotations = if annotations == self[:Annots]
+                        not_flattened
+                      else
+                        not_flattened & Array(self[:Annots])
+                      end
         return not_flattened if annotations.empty?
 
         canvas = self.canvas(type: :overlay)
-        if (pos = canvas.graphics_state.ctm.evaluate(0, 0)) != [0, 0]
+        if (pos = canvas.pos(0, 0)) != [0, 0]
           canvas.save_graphics_state
           canvas.translate(-pos[0], -pos[1])
         end
@@ -554,6 +569,11 @@ module HexaPDF
         to_delete = []
         not_flattened -= annotations
         annotations.each do |annotation|
+          unless annotation&.key?(:Subtype) && annotation&.key?(:Rect)
+            to_delete << annotation if annotation
+            next
+          end
+
           annotation = document.wrap(annotation, type: :Annot)
           appearance = annotation.appearance
           if annotation.flagged?(:hidden) || annotation.flagged?(:invisible)
@@ -567,8 +587,8 @@ module HexaPDF
           rect = annotation[:Rect]
           box = appearance.box
 
-          # PDF1.7 12.5.5 algorithm
-          # Step a) Calculate smallest rectangle containing transformed bounding box
+          # PDF2.0 12.5.5 algorithm
+          # Step 1) Calculate smallest rectangle containing transformed bounding box
           matrix = HexaPDF::Content::TransformationMatrix.new(*appearance[:Matrix].value)
           llx, lly = matrix.evaluate(box.left, box.bottom)
           ulx, uly = matrix.evaluate(box.left, box.top)
@@ -582,14 +602,19 @@ module HexaPDF
             next
           end
 
-          # Step b) Fit calculated rectangle to annotation rectangle by translating/scaling
-          a = HexaPDF::Content::TransformationMatrix.new
-          a.translate(rect.left - left, rect.bottom - bottom)
-          a.scale(rect.width.fdiv(right - left), rect.height.fdiv(top - bottom))
+          # Step 2) Fit calculated rectangle to annotation rectangle by translating/scaling
+
+          # The final matrix is composed by translating the bottom-left corner of the transformed
+          # bounding box to the bottom-left corner of the annotation rectangle and scaling from the
+          # bottom-left corner of the transformed bounding box.
+          sx = rect.width.fdiv(right - left)
+          sy = rect.height.fdiv(top - bottom)
+          tx = rect.left - left + left - left * sx
+          ty = rect.bottom - bottom + bottom - bottom * sy
 
-          # Step c) Premultiply form matrix - done implicitly when drawing the XObject
+          # Step 3) Premultiply form matrix - done implicitly when drawing the XObject
 
-          canvas.transform(*a) do
+          canvas.transform(sx, 0, 0, sy, tx, ty) do
             # Use [box.left, box.bottom] to counter default translation in #xobject since that
             # is already taken care of in matrix a
             canvas.xobject(appearance, at: [box.left, box.bottom])

data/lib/hexapdf/type/page_label.rb

@@ -70,7 +70,7 @@ module HexaPDF
     #
     #   "", "", "", ... (i.e. always the empty string)
     #
-    # See: PDF1.7 s12.4.2, HexaPDF::Document::Pages, HexaPDF::Type::Catalog
+    # See: PDF2.0 s12.4.2, HexaPDF::Document::Pages, HexaPDF::Type::Catalog
     class PageLabel < Dictionary
 
       define_type :PageLabel
@@ -103,8 +103,7 @@ module HexaPDF
         end
       end
 
-      # :nodoc:
-      NUMBERING_STYLE_MAPPING = {
+      NUMBERING_STYLE_MAPPING = { # :nodoc:
         decimal: :D, D: :D,
         uppercase_roman: :R, R: :R,
         lowercase_roman: :r, r: :r,
@@ -113,8 +112,7 @@ module HexaPDF
         none: nil
       }
 
-      # :nodoc:
-      REVERSE_NUMBERING_STYLE_MAPPING = Hash[*NUMBERING_STYLE_MAPPING.flatten.reverse]
+      REVERSE_NUMBERING_STYLE_MAPPING = Hash[*NUMBERING_STYLE_MAPPING.flatten.reverse] # :nodoc:
 
       # :call-seq:
       #   page_label.numbering_style             -> numbering_style
@@ -174,8 +172,7 @@ module HexaPDF
 
       private
 
-      # :nodoc:
-      ALPHABET = ('A'..'Z').to_a
+      ALPHABET = ('A'..'Z').to_a # :nodoc:
 
       # Maps the given number to uppercase (or, if +lowercase+ is +true+, lowercase) letters (e.g. 1
       # -> A, 27 -> AA, 28 -> AB, ...).
@@ -188,8 +185,7 @@ module HexaPDF
         lowercase ? result.downcase : result
       end
 
-      # :nodoc:
-      ROMAN_NUMERAL_MAPPING = {
+      ROMAN_NUMERAL_MAPPING = { # :nodoc:
         1000 => "M",
         900 => "CM",
         500 => "D",

data/lib/hexapdf/type/page_tree_node.rb

@@ -60,7 +60,7 @@ module HexaPDF
     # value. If an inherited /Resources dictionary does *not* exist, an empty one is created for
     # the page.
     #
-    # See: PDF1.7 s7.7.3.2, Page
+    # See: PDF2.0 s7.7.3.2, Page
     class PageTreeNode < Dictionary
 
       define_type :Pages

data/lib/hexapdf/type/resources.rb

@@ -44,7 +44,7 @@ module HexaPDF
 
     # Represents the resources needed by a content stream.
     #
-    # See: PDF1.7 s7.8.3
+    # See: PDF2.0 s7.8.3
     class Resources < Dictionary
 
       define_type :XXResources

data/lib/hexapdf/type/trailer.rb

@@ -54,7 +54,7 @@ module HexaPDF
     # HexaPDF::Revision object's trailer dictionary is always of this type. Only when a
     # cross-reference stream is written is the trailer integrated into the stream's dictionary.
     #
-    # See: PDF1.7 s7.5.5, s14.4; XRefStream
+    # See: PDF2.0 s7.5.5, s14.4; XRefStream
     class Trailer < Dictionary
 
       define_type :XXTrailer
@@ -79,7 +79,7 @@ module HexaPDF
 
       # Sets the /ID field to an array of two copies of a random string and returns this array.
       #
-      # See: PDF1.7 14.4
+      # See: PDF2.0 14.4
       def set_random_id
         value[:ID] = [Digest::MD5.digest(rand.to_s)] * 2
       end

data/lib/hexapdf/type/viewer_preferences.rb

@@ -44,7 +44,7 @@ module HexaPDF
     #
     # This dictionary is linked via the /ViewerPreferences entry from the Type::Catalog.
     #
-    # See: PDF1.7 s12.2, Catalog
+    # See: PDF2.0 s12.2, Catalog
     class ViewerPreferences < Dictionary
 
       define_type :XXViewerPreferences

data/lib/hexapdf/type/xref_stream.rb

@@ -65,7 +65,7 @@ module HexaPDF
     # cross-reference section and trailer information and then written. Otherwise a normal
     # cross-reference section plus trailer are written.
     #
-    # See: PDF1.7 s7.5.8
+    # See: PDF2.0 s7.5.8
     class XRefStream < HexaPDF::Stream
 
       define_type :XRef
@@ -161,7 +161,7 @@ module HexaPDF
             when TYPE_COMPRESSED
               xref.add_compressed_entry(oid, field2, field3)
             else
-              nil # Ignore entry as per PDF1.7 s7.5.8.3
+              nil # Ignore entry as per PDF2.0 s7.5.8.3
             end
             start_pos = end_pos
           end

data/lib/hexapdf/type.rb

@@ -76,6 +76,10 @@ module HexaPDF
     autoload(:OutlineItem, 'hexapdf/type/outline_item')
     autoload(:PageLabel, 'hexapdf/type/page_label')
     autoload(:MarkInformation, 'hexapdf/type/mark_information')
+    autoload(:OptionalContentGroup, 'hexapdf/type/optional_content_group')
+    autoload(:OptionalContentMembership, 'hexapdf/type/optional_content_membership')
+    autoload(:OptionalContentProperties, 'hexapdf/type/optional_content_properties')
+    autoload(:OptionalContentConfiguration, 'hexapdf/type/optional_content_configuration')
 
   end
 

data/lib/hexapdf/utils/pdf_doc_encoding.rb

@@ -49,10 +49,9 @@ module HexaPDF
     # When a PDF file is written, text strings are automatically encoded in either PDFDocEncoding
     # or UTF-16BE depending on the characters in the text string.
     #
-    # See: PDF1.7 s7.9.2, D.1, D.3
+    # See: PDF2.0 s7.9.2, D.1, D.3
     module PDFDocEncoding
 
-      # :nodoc:
       CHARACTER_MAP = %W[\uFFFD \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD
                          \uFFFD \u0009 \u000A \uFFFD \uFFFD \u000D \uFFFD \uFFFD
                          \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD \uFFFD

data/lib/hexapdf/version.rb

@@ -37,6 +37,6 @@
 module HexaPDF
 
   # The version of HexaPDF.
-  VERSION = '0.32.2'
+  VERSION = '0.34.0'
 
 end

data/lib/hexapdf/writer.rb

@@ -124,7 +124,7 @@ module HexaPDF
 
     # Writes the PDF file header.
     #
-    # See: PDF1.7 s7.5.2
+    # See: PDF2.0 s7.5.2
     def write_file_header
       @io << "%PDF-#{@document.version}\n%\xCF\xEC\xFF\xE8\xD7\xCB\xCD\n"
     end
@@ -225,7 +225,7 @@ module HexaPDF
 
     # Writes the cross-reference section.
     #
-    # See: PDF1.7 s7.5.4
+    # See: PDF2.0 s7.5.4
     def write_xref_section(xref_section)
       @io << "xref\n"
       xref_section.each_subsection do |entries|
@@ -245,14 +245,14 @@ module HexaPDF
 
     # Writes the trailer dictionary.
     #
-    # See: PDF1.7 s7.5.5
+    # See: PDF2.0 s7.5.5
     def write_trailer(trailer)
       @io << "trailer\n#{@serializer.serialize(trailer)}\n"
     end
 
     # Writes the startxref line needed for cross-reference sections and cross-reference streams.
     #
-    # See: PDF1.7 s7.5.5, s7.5.8
+    # See: PDF2.0 s7.5.5, s7.5.8
     def write_startxref(startxref)
       @io << "startxref\n#{startxref}\n%%EOF\n"
     end

data/lib/hexapdf/xref_section.rb

@@ -46,7 +46,7 @@ module HexaPDF
   #
   # Note that a cross-reference section may contain a single object number only once.
   #
-  # See: HexaPDF::Revision, PDF1.7 s7.5.4, s7.5.8
+  # See: HexaPDF::Revision, PDF2.0 s7.5.4, s7.5.8
   class XRefSection < Utils::ObjectHash
 
     # One entry of a cross-reference section or stream.
@@ -69,7 +69,7 @@ module HexaPDF
     #
     #               Objects in an object stream always have a generation number of 0!
     #
-    # See: PDF1.7 s7.5.4, s7.5.8
+    # See: PDF2.0 s7.5.4, s7.5.8
     Entry = Struct.new(:type, :oid, :gen, :pos, :objstm) do
       def free?
         type == :free

data/test/hexapdf/content/graphic_object/test_endpoint_arc.rb

@@ -16,13 +16,15 @@ describe HexaPDF::Content::GraphicObject::EndpointArc do
       assert_equal(0, arc.inclination)
       assert(arc.large_arc)
       refute(arc.clockwise)
+      assert_nil(arc.max_curves)
     end
   end
 
   describe "configure" do
     it "changes the values" do
       arc = HexaPDF::Content::GraphicObject::EndpointArc.new
-      arc.configure(x: 1, y: 2, a: 3, b: 4, inclination: 5, large_arc: false, clockwise: true)
+      arc.configure(x: 1, y: 2, a: 3, b: 4, inclination: 5, large_arc: false, clockwise: true,
+                    max_curves: 8)
       assert_equal(1, arc.x)
       assert_equal(2, arc.y)
       assert_equal(3, arc.a)
@@ -30,6 +32,7 @@ describe HexaPDF::Content::GraphicObject::EndpointArc do
       assert_equal(5, arc.inclination)
       refute(arc.large_arc)
       assert(arc.clockwise)
+      assert_equal(8, arc.max_curves)
     end
   end
 
@@ -94,5 +97,12 @@ describe HexaPDF::Content::GraphicObject::EndpointArc do
                   clockwise: false)
       assert_equal(arc_data, @page.contents)
     end
+
+    it "assigns the max curves to the generated arc" do
+      arc = HexaPDF::Content::GraphicObject::EndpointArc.new
+      arc.configure(a: 1, b: 1, x: -1, y: 0, max_curves: 10)
+      hash = arc.send(:compute_arc_values, 1, 0)
+      assert_equal(10, hash[:max_curves])
+    end
   end
 end

data/test/hexapdf/content/graphic_object/test_geom2d.rb

@@ -51,6 +51,13 @@ describe HexaPDF::Content::GraphicObject::Geom2D do
                        [[:move_to, [5, 6]], [:line_to, [10, 11]], [:stroke_path]])
     end
 
+    it "draws a Geom2D::Rectangle onto the canvas" do
+      @obj.object = Geom2D::Rectangle(5, 6, 20, 50)
+      @obj.draw(@canvas)
+      assert_operators(@canvas.contents,
+                       [[:append_rectangle, [5, 6, 20, 50]], [:stroke_path]])
+    end
+
     it "draws a Geom2D::Polygon onto the canvas" do
       @obj.object = Geom2D::Polygon([5, 6], [10, 11], [7, 9])
       @obj.draw(@canvas)

data/test/hexapdf/content/test_canvas.rb

@@ -71,6 +71,13 @@ describe HexaPDF::Content::Canvas do
     end
   end
 
+  describe "pos" do
+    it "returns the transformed position" do
+      @canvas.translate(9, 4)
+      assert_equal([10, 5], @canvas.pos(1, 1))
+    end
+  end
+
   describe "save_graphics_state" do
     it "invokes the operator implementation" do
       assert_operator_invoked(:q) { @canvas.save_graphics_state }
@@ -1193,7 +1200,6 @@ describe HexaPDF::Content::Canvas do
       assert_operators(@canvas.contents, [[:set_font_and_size, [:F1, 10]],
                                           [:begin_text],
                                           [:set_text_matrix, [1, 0, 0, 1, 100, 100]],
-                                          [:set_leading, [10]],
                                           [:show_text_with_positioning, [["Hallo"]]]])
     end
 
@@ -1281,6 +1287,48 @@ describe HexaPDF::Content::Canvas do
     end
   end
 
+  describe "optional_content" do
+    it "invokes the marked-sequence operator implementation" do
+      assert_operator_invoked(:BDC, :OC, :P1) { @canvas.optional_content('Test') }
+    end
+
+    it "is serialized correctly when no block is used" do
+      @canvas.optional_content('Test')
+      assert_operators(@canvas.contents, [[:begin_marked_content_with_property_list, [:OC, :P1]]])
+    end
+
+    it "is serialized correctly when a block is used" do
+      @canvas.optional_content('Test') {}
+      assert_operators(@canvas.contents, [[:begin_marked_content_with_property_list, [:OC, :P1]],
+                                          [:end_marked_content]])
+    end
+
+    it "uses the provided OCG dictionary" do
+      ocg = @doc.optional_content.add_ocg('Test')
+      @canvas.optional_content(ocg)
+      assert_equal(ocg, @page.resources.property_list(:P1))
+    end
+
+    it "uses an existing OCG specified by name" do
+      ocg = @doc.optional_content.add_ocg('Test')
+      @canvas.optional_content('Test')
+      assert_equal(ocg, @page.resources.property_list(:P1))
+    end
+
+    it "creates an OCG if the named one doesn't yet exist" do
+      @canvas.optional_content('Test')
+      assert_equal(@doc.optional_content.ocg('Test'), @page.resources.property_list(:P1))
+    end
+
+    it "always creates a new OCG if use_existing_ocg is false" do
+      ocg = @doc.optional_content.add_ocg('Test')
+      @canvas.optional_content('Test', use_existing_ocg: false)
+      pl_item = @page.resources.property_list(:P1)
+      refute_equal(ocg, pl_item)
+      assert_equal(@doc.optional_content.ocgs.last, pl_item)
+    end
+  end
+
   describe "color_from_specification "do
     it "accepts a color string" do
       assert_equal([1, 0, 0], @canvas.color_from_specification("red").components)

data/test/hexapdf/digital_signature/test_signatures.rb

@@ -107,6 +107,28 @@ describe HexaPDF::DigitalSignature::Signatures do
       assert_equal(1, field.each_widget.count)
     end
 
+    it "creates an empty widget on the first page for the signature field if necessary" do
+      @doc.pages.add
+      field = @doc.acro_form(create: true).create_signature_field('Signature2')
+      field.field_value = sig = @doc.add({Type: :Sig, key: :value})
+      @doc.signatures.add(@io, @handler, signature: sig)
+      widgets = field.each_widget.to_a
+      assert_equal(1, widgets.size)
+      assert_equal(@doc.pages[0], widgets[0][:P])
+      assert_equal([0, 0, 0, 0], widgets[0][:Rect])
+    end
+
+    it "handles a bug in Adobe Acrobat related to images not showing without a /Resources entry" do
+      field = @doc.acro_form(create: true).create_signature_field('Signature')
+      image = @doc.add({Type: :XObject, Subtype: :Image, Width: 1, Height: 1, ColorSpace: :DeviceGray,
+                        BitsPerComponent: 8}, stream: 'A')
+      field.create_widget(@doc.pages[0], Rect: [0, 0, 100, 100]).create_appearance.
+        canvas.xobject(image, at: [0, 0])
+      @doc.signatures.add(@io, @handler, signature: field)
+      assert(image.key?(:Resources))
+      assert_equal({}, image[:Resources])
+    end
+
     it "handles different xref section types correctly when determing the offsets" do
       @doc.delete(7)
       sig = @doc.signatures.add(@io, @handler, write_options: {update_fields: false})

data/test/hexapdf/document/test_files.rb

@@ -55,8 +55,8 @@ describe HexaPDF::Document::Files do
       spec2 = @doc.add({Type: :Filespec})
       @doc.pages.add # page without annot
       @doc.pages.add[:Annots] = [
-        {Subtype: :FileAttachment, FS: HexaPDF::Reference.new(spec1.oid, spec1.gen)},
-        {Subtype: :FileAttachment, FS: spec2},
+        {Subtype: :FileAttachment, Rect: [0, 0, 0, 0], FS: HexaPDF::Reference.new(spec1.oid, spec1.gen)},
+        {Subtype: :FileAttachment, Rect: [0, 0, 0, 0], FS: spec2},
         {},
       ]
       assert_equal([spec1, spec2], @doc.files.to_a)

data/test/hexapdf/document/test_layout.rb

@@ -59,6 +59,54 @@ describe HexaPDF::Document::Layout::ChildrenCollector do
   end
 end
 
+describe HexaPDF::Document::Layout::CellArgumentCollector do
+  before do
+    @args = HexaPDF::Document::Layout::CellArgumentCollector.new(20, 10)
+  end
+
+  describe "[]" do
+    def check_argument_info(info, rows, cols, args)
+      assert_equal(rows, info.rows)
+      assert_equal(cols, info.cols)
+      assert_equal(args, info.args)
+    end
+
+    it "allows assigning to all cells" do
+      @args[] = {key: :value}
+      check_argument_info(@args.argument_infos.first, 0..19, 0..9, {key: :value})
+    end
+
+    it "allows assigning to all columns of a range of rows" do
+      @args[1..4] = {key: :value}
+      check_argument_info(@args.argument_infos.first, 1..4, 0..9, {key: :value})
+    end
+
+    it "allows assigning to the intersection of a range of rows with a range of columns" do
+      @args[1..4, 3..5] = {key: :value}
+      check_argument_info(@args.argument_infos.first, 1..4, 3..5, {key: :value})
+    end
+
+    it "allows selecting a single row or column" do
+      @args[1, 3] = {key: :value}
+      check_argument_info(@args.argument_infos.first, 1..1, 3..3, {key: :value})
+    end
+
+    it "allows using negative indices" do
+      @args[-3..-1, -5..-2] = {key: :value}
+      check_argument_info(@args.argument_infos.first, 17..19, 5..8, {key: :value})
+    end
+  end
+
+  describe "retrieve_arguments_for" do
+    it "merges all argument hashes, with later defined ones overridding prior ones" do
+      @args[] = {key: :value, a: :b}
+      @args[3..7] = {a: :c}
+      @args[5, 6] = {e: :f}
+      assert_equal({key: :value, a: :c, e: :f}, @args.retrieve_arguments_for(5, 6))
+    end
+  end
+end
+
 describe HexaPDF::Document::Layout do
   before do
     @doc = HexaPDF::Document.new
@@ -171,6 +219,10 @@ describe HexaPDF::Document::Layout do
       box = @layout.text_box("Test", box_style: :named)
       assert_equal(20, box.style.font_size)
     end
+
+    it "raises an error if the to-be-used style doesn't exist" do
+      assert_raises(HexaPDF::Error) { @layout.text_box("Test", style: :unknown) }
+    end
   end
 
   describe "formatted_text" do
@@ -257,9 +309,10 @@ describe HexaPDF::Document::Layout do
 
     it "allows creating an inline box through a hash with a :box key" do
       block = lambda {|item| item.box(:base, width: 5, height: 15) }
-      box = @layout.formatted_text_box([{box: :list, width: 10, block: block}])
+      box = @layout.formatted_text_box([{box: :column, columns: 1, width: 100, block: block}])
       ibox = box.instance_variable_get(:@items).first
-      assert_equal(10, ibox.width)
+      ibox.fit_wrapped_box(nil)
+      assert_equal(100, ibox.width)
       assert_equal(15, ibox.height)
     end
 
@@ -290,6 +343,56 @@ describe HexaPDF::Document::Layout do
     end
   end
 
+  describe "table_box" do
+    it "creates a table box" do
+      box = @layout.table_box([['m']], column_widths: [100], header: proc { [['a']] },
+                              footer: proc { [['b']] }, cell_style: {background_color: "red"},
+                              width: 100, height: 300, style: {background_color: "blue"},
+                              properties: {key: :value}, border: {width: 1})
+      assert_equal(100, box.width)
+      assert_equal(300, box.height)
+      assert_equal("blue", box.style.background_color)
+      assert_equal(1, box.style.border.width.left)
+      assert_equal({key: :value}, box.properties)
+      assert_equal(HexaPDF::Layout::TextBox, box.cells[0, 0].children.class)
+      assert_equal([100], box.column_widths)
+      assert_equal('a', box.header_cells[0, 0].children)
+      assert_equal('b', box.footer_cells[0, 0].children)
+    end
+
+    it "doesn't modify the children of cells if they are already in the correct form" do
+      image_path = File.join(TEST_DATA_DIR, 'images', 'gray.jpg')
+      cell0 = @layout.text('a')
+      cell1 = [@layout.text('b'), @layout.image(image_path)]
+      box = @layout.table_box([[cell0, cell1]])
+      assert_same(cell0, box.cells[0, 0].children)
+      assert_same(cell1, box.cells[0, 1].children)
+    end
+
+    it "converts cells containing other than Box and Array instances" do
+      box = @layout.table_box([['a', 5]])
+      assert_kind_of(HexaPDF::Layout::TextBox, box.cells[0, 0].children)
+      assert_kind_of(HexaPDF::Layout::TextBox, box.cells[0, 1].children)
+    end
+
+    it "allows customizing the creation arguments" do
+      box = @layout.table_box([['a']]) do |args|
+        args[] = {font_size: 20}
+      end
+      assert_equal(20, box.cells[0, 0].children.style.font_size)
+      refute_equal(20, box.cells[0, 0].style.font_size)
+    end
+
+    it "allows styling table cells themselves" do
+      box = @layout.table_box([['a', @layout.text('b')]]) do |args|
+        args[] = {cell: {background_color: "green"}}
+      end
+      assert_equal('green', box.cells[0, 0].style.background_color)
+      assert_nil(box.cells[0, 0].children.style.background_color)
+      assert_equal('green', box.cells[0, 1].style.background_color)
+    end
+  end
+
   describe "lorem_ipsum_box" do
     it "creates a standard lorem ipsum box" do
       box = @layout.lorem_ipsum_box(width: 10, height: 15, font_size: 15)