hexapdf 1.1.1 → 1.2.0

data/lib/hexapdf/type/annotations/line.rb

@@ -0,0 +1,521 @@
+# -*- 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/type/annotation'
+
+module HexaPDF
+  module Type
+    module Annotations
+
+      # A line annotation is a markup annotation that displays a single straight line.
+      #
+      # The style of the line annotation, like adding leader lines, changing the colors and so on,
+      # can be customized using the provided convenience methods.
+      #
+      # Note that changing the line width and color is done using the included
+      # BorderStyling#border_style. While that method allows special styling of the line (like
+      # :beveled), only a simple line dash pattern is supported by the line annotation.
+      #
+      # Example:
+      #
+      #   #>pdf-small
+      #   doc.annotations.create_line(doc.pages[0], start_point: [30, 20], end_point: [90, 60]).
+      #     border_style(color: "hp-blue", width: 2, style: [3, 1]).
+      #     leader_line_length(15).
+      #     leader_line_extension_length(10).
+      #     leader_line_offset(5).
+      #     interior_color("hp-orange").
+      #     line_ending_style(start_style: :circle, end_style: :open_arrow).
+      #     captioned(true).
+      #     contents("Caption").
+      #     caption_position(:top).
+      #     caption_offset(0, 5).
+      #     regenerate_appearance
+      #   canvas.line(30, 20, 90, 60).stroke
+      #
+      # See: PDF2.0 s12.5.6.7, HexaPDF::Type::MarkupAnnotation
+      class Line < MarkupAnnotation
+
+        include BorderStyling
+
+        define_field :Subtype, type: Symbol, required: true, default: :Line
+        define_field :L,       type: PDFArray, required: true
+        define_field :BS,      type: :Border
+        define_field :LE,      type: PDFArray, default: [:None, :None], version: '1.4'
+        define_field :IC,      type: PDFArray, version: '1.4'
+        define_field :LL,      type: Numeric, default: 0, version: '1.6'
+        define_field :LLE,     type: Numeric, default: 0, version: '1.6'
+        define_field :Cap,     type: Boolean, default: false, version: '1.6'
+        define_field :IT,      type: Symbol, version: '1.6',
+          allowed_values: [:LineArrow, :LineDimension]
+        define_field :LLO,     type: Numeric, version: '1.7'
+        define_field :CP,      type: Symbol, default: :Inline, version: '1.7',
+          allowed_values: [:Inline, :Top]
+        define_field :Measure, type: Dictionary, version: '1.7'
+        define_field :CO,      type: PDFArray, default: [0, 0], version: '1.7'
+
+        # :call-seq:
+        #   line.line                   => [x0, y0, x1, y1]
+        #   line.line(x0, y0, x1, y1)   => line
+        #
+        # Returns the start point and end point of the line as an array of four numbers [x0, y0, x1,
+        # y1] when no argument is given. Otherwise sets the start and end point of the line and
+        # returns self.
+        #
+        # This is the only required setting for a line annotation. Note, however, that without
+        # setting an appropriate color through #border_style the line will be transparent.
+        #
+        # Example:
+        #
+        #   #>pdf-small
+        #   doc.annotations.
+        #     create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #     regenerate_appearance
+        def line(x0 = nil, y0 = nil, x1 = nil, y1 = nil)
+          if x0.nil? && y0.nil? && x1.nil? && y1.nil?
+            self[:L].to_ary
+          elsif !x0 || !y0 || !x1 || !y1
+            raise ArgumentError, "All four arguments x0, y0, x1, y1 must be provided"
+          else
+            self[:L] = [x0, y0, x1, y1]
+            self
+          end
+        end
+
+        # Maps HexaPDF names to PDF names.
+        LINE_ENDING_STYLE_MAP = { # :nodoc:
+          Square: :Square, square: :Square,
+          Circle: :Circle, circle: :Circle,
+          Diamond: :Diamond, diamond: :Diamond,
+          OpenArrow: :OpenArrow, open_arrow: :OpenArrow,
+          ClosedArrow: :ClosedArrow, closed_arrow: :ClosedArrow,
+          None: :None, none: :None,
+          Butt: :Butt, butt: :Butt,
+          ROpenArrow: :ROpenArrow, ropen_arrow: :ROpenArrow,
+          RClosedArrow: :RClosedArrow, rclosed_arrow: :RClosedArrow,
+          Slash: :Slash, slash: :Slash,
+        }.freeze
+        LINE_ENDING_STYLE_REVERSE_MAP = LINE_ENDING_STYLE_MAP.invert # :nodoc:
+
+
+        # Describes the line ending style for a line annotation, i.e. the +start_style+ and the
+        # +end_style+.
+        #
+        # See Line#line_ending_style for more information.
+        LineEndingStyle = Struct.new(:start_style, :end_style)
+
+        # :call-seq:
+        #   line.line_ending_style                                         => style
+        #   line.line_ending_style(start_style: :none, end_style: :none)   => line
+        #
+        # Returns a LineEndingStyle instance holding the current line ending styles when no argument
+        # is given. Otherwise sets the line ending style of the line and returns self.
+        #
+        # When returning the styles, unknown line ending styles are mapped to :none.
+        #
+        # When setting the line ending style, arguments that are not provided will use the currently
+        # defined value or fall back to the default of +:none+.
+        #
+        # Possible line ending styles (the first one is the HexaPDF name, the second the PDF name):
+        #
+        # :square or :Square::
+        #     A square filled with the annotation's interior colour, if any.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :square).
+        #         regenerate_appearance
+        #
+        # :circle or :Circle::
+        #     A circle filled with the annotation’s interior colour, if any.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :circle).
+        #         regenerate_appearance
+        #
+        # :diamond or :Diamond::
+        #     A diamond shape filled with the annotation’s interior colour, if any.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :diamond).
+        #         regenerate_appearance
+        #
+        # :open_arrow or :OpenArrow::
+        #     Two short lines meeting in an acute angle to form an open arrowhead.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :open_arrow).
+        #         regenerate_appearance
+        #
+        # :closed_arrow or :ClosedArrow::
+        #     Two short lines meeting in an acute angle as in the +:open_arrow+ style and connected
+        #     by a third line to form a triangular closed arrowhead filled with the annotation’s
+        #     interior colour, if any.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :closed_arrow).
+        #         regenerate_appearance
+        #
+        # :none or :None::
+        #     No line ending.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :none).
+        #         regenerate_appearance
+        #
+        # :butt or :Butt::
+        #     A short line at the endpoint perpendicular to the line itself.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :butt).
+        #         regenerate_appearance
+        #
+        # :ropen_arrow or :ROpenArrow::
+        #     Two short lines in the reverse direction from +:open_arrow+.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :ropen_arrow).
+        #         regenerate_appearance
+        #
+        # :rclosed_arrow or :RClosedArrow::
+        #     A triangular closed arrowhead in the reverse direction from +:closed_arrow+.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :rclosed_arrow).
+        #         regenerate_appearance
+        #
+        # :slash or :Slash::
+        #      A short line at the endpoint approximately 30 degrees clockwise from perpendicular to
+        #      the line itself.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         interior_color("hp-orange").
+        #         line_ending_style(end_style: :slash).
+        #         regenerate_appearance
+        def line_ending_style(start_style: :UNSET, end_style: :UNSET)
+          if start_style == :UNSET && end_style == :UNSET
+            le = self[:LE]
+            LineEndingStyle.new(LINE_ENDING_STYLE_REVERSE_MAP.fetch(le[0], :none),
+                                LINE_ENDING_STYLE_REVERSE_MAP.fetch(le[1], :none))
+          else
+            start_style = self[:LE][0] if start_style == :UNSET
+            end_style = self[:LE][1] if end_style == :UNSET
+            start_style = LINE_ENDING_STYLE_MAP.fetch(start_style) do
+              raise ArgumentError, "Invalid line ending style: #{start_style.inspect}"
+            end
+            end_style = LINE_ENDING_STYLE_MAP.fetch(end_style) do
+              raise ArgumentError, "Invalid line ending style: #{end_style.inspect}"
+            end
+            self[:LE] = [start_style, end_style]
+            self
+          end
+        end
+
+        # :call-seq:
+        #   line.interior_color          => color or nil
+        #   line.interior_color(*color)   => line
+        #
+        # Returns the interior color or +nil+ (in case the interior color should be transparent)
+        # when no argument is given. Otherwise sets the interior color and returns self.
+        #
+        # The interior color is used to fill the line endings depending on the line ending styles.
+        #
+        # +color+:: The interior color. See
+        #           HexaPDF::Content::ColorSpace.device_color_from_specification for information on
+        #           the allowed arguments.
+        #
+        #           If the special value +:transparent+ is used when setting the color, no color is
+        #           used for filling the line endings.
+        #
+        # Also see: #line_ending_style
+        def interior_color(*color)
+          if color.empty?
+            color = self[:IC]
+            color && !color.empty? ?  Content::ColorSpace.prenormalized_device_color(color.value) : nil
+          else
+            color = if color.length == 1 && color.first == :transparent
+                      []
+                    else
+                      Content::ColorSpace.device_color_from_specification(color).components
+                    end
+            self[:IC] = color
+            self
+          end
+        end
+
+        # :call-seq:
+        #   line.leader_line_length          => leader_line_length
+        #   line.leader_line_length(length)  => line
+        #
+        # Returns the leader line length when no argument is given. Otherwise sets the leader line
+        # length and returns self.
+        #
+        # Leader lines extend from the line's end points perpendicular to the line. If the length
+        # value is positive, the leader lines appear in the clockwise direction, otherwise in the
+        # opposite direction.
+        #
+        # Note: The "line's end points" mean the actually drawn line and not the one specified with
+        # #line as those two are different when leader lines are involved.
+        #
+        # A value of zero means that no leader lines are used.
+        #
+        # Example:
+        #
+        #   #>pdf-small
+        #   doc.annotations.
+        #     create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #     leader_line_length(15).
+        #     regenerate_appearance
+        #   canvas.stroke_color("hp-orange").line(20, 20, 80, 60).stroke
+        #
+        # Also see: #leader_line_extension_length, #leader_line_offset
+        def leader_line_length(length = nil)
+          length ? (self[:LL] = length; self) : self[:LL]
+        end
+
+        # :call-seq:
+        #   line.leader_line_extension_length          => leader_line_extension_length
+        #   line.leader_line_extension_length(length)  => line
+        #
+        # Returns the leader line extension length when no argument is given. Otherwise sets the
+        # leader line extension length and returns self.
+        #
+        # Leader line extensions extend from the line into the opposite direction of the leader
+        # lines.
+        #
+        # The argument +length+ must be non-negative.
+        #
+        # If the leader line extension length is set to a positive value, the leader line length
+        # also needs to be specified.
+        #
+        # Example:
+        #
+        #   #>pdf-small
+        #   doc.annotations.
+        #     create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #     leader_line_length(15).
+        #     leader_line_extension_length(5).
+        #     regenerate_appearance
+        #   canvas.stroke_color("hp-orange").line(20, 20, 80, 60).stroke
+        #
+        # Also see: #leader_line_length, #leader_line_offset
+        def leader_line_extension_length(length = nil)
+          if length
+            raise ArgumentError, "length must be non-negative" if length < 0
+            self[:LLE] = length
+            self
+          else
+            self[:LLE]
+          end
+        end
+
+        # :call-seq:
+        #   line.leader_line_offset          => leader_line_offset
+        #   line.leader_line_offset(number)  => line
+        #
+        # Returns the leader line offset when no argument is given. Otherwise sets the leader line
+        # offset and returns self.
+        #
+        # The leader line offset is a non-negative number that describes the offset of the leader
+        # lines from the endpoints of the line.
+        #
+        # Example:
+        #
+        #   #>pdf-small
+        #   doc.annotations.
+        #     create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #     leader_line_length(15).
+        #     leader_line_offset(5).
+        #     regenerate_appearance
+        #   canvas.stroke_color("hp-orange").line(20, 20, 80, 60).stroke
+        #
+        # Also see: #leader_line_length, #leader_line_extension_length
+        def leader_line_offset(offset = nil)
+          offset ? (self[:LLO] = offset; self) : self[:LLO] || 0
+        end
+
+        # :call-seq:
+        #   line.captioned          => true or false
+        #   line.captioned(value)   => line
+        #
+        # Returns +true+ (if the line has a visible caption) or +false+ (no visible caption) when no
+        # argument is given. Otherwise sets whether a caption should be visible and returns self.
+        #
+        # If a caption should be shown, the text specified by the /Contents or /RC entries is shown
+        # in the appearance of the line.
+        #
+        # Example:
+        #
+        #   #>pdf-small-hide
+        #   doc.annotations.
+        #     create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #     contents("Inline text").
+        #     captioned(true).
+        #     regenerate_appearance
+        # Also see: #caption_position, #caption_offset
+        def captioned(value = nil)
+          value ? (self[:Cap] = value; self) : self[:Cap]
+        end
+
+        # Maps HexaPDF names to PDF names.
+        CAPTION_POSITION_MAP = { # :nodoc:
+          Inline: :Inline, inline: :Inline,
+          Top: :Top, top: :Top,
+        }.freeze
+        CAPTION_POSITION_REVERSE_MAP = CAPTION_POSITION_MAP.invert # :nodoc:
+
+        # :call-seq:
+        #   line.caption_position          => caption_position
+        #   line.caption_position(value)   => line
+        #
+        # Returns the caption position when no argument is given. Otherwise sets the caption
+        # position and returns self.
+        #
+        # Possible caption positions are (the first one is the HexaPDF name, the second the PDF
+        # name):
+        #
+        # :inline or :Inline::
+        #     The caption is centered inside the line (default).
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         contents("Inline text").
+        #         captioned(true).
+        #         caption_position(:inline).
+        #         regenerate_appearance
+        #
+        # :top or :Top::
+        #     The caption is on the top of the line.
+        #
+        #       #>pdf-small-hide
+        #       doc.annotations.
+        #         create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #         contents("Top text").
+        #         captioned(true).
+        #         caption_position(:top).
+        #         regenerate_appearance
+        #
+        # Also see: #captioned, #caption_offset
+        def caption_position(value = nil)
+          if value
+            value = CAPTION_POSITION_MAP.fetch(value) do
+              raise ArgumentError, "Invalid caption position: #{value.inspect}"
+            end
+            self[:CP] = value
+            self
+          else
+            CAPTION_POSITION_REVERSE_MAP[self[:CP]]
+          end
+        end
+
+        # :call-seq:
+        #   line.caption_offset        => caption_offset
+        #   line.caption_offset(x, y)  => line
+        #
+        # Returns the caption offset when no argument is given. Otherwise sets the caption offset
+        # and returns self.
+        #
+        # The caption offset is an array of two numbers that specify the horizontal and vertical
+        # offsets of the caption from its normal position. A positive horizontal offset means moving
+        # the caption to the right. A positive vertical offset means shifting the caption up.
+        #
+        # Example:
+        #
+        #   #>pdf-small-hide
+        #   doc.annotations.
+        #     create_line(doc.pages[0], start_point: [20, 20], end_point: [80, 60]).
+        #     contents("Top text").
+        #     captioned(true).
+        #     caption_position(:top).
+        #     caption_offset(20, 10).
+        #     regenerate_appearance
+        #
+        # Also see: #captioned, #caption_position
+        def caption_offset(x = nil, y = nil)
+          x || y ? (self[:CO] = [x || 0, y || 0]; self) : self[:CO].to_ary
+        end
+
+        private
+
+        def perform_validation #:nodoc:
+          super
+          if self[:LLE] < 0
+            yield('/LLE must be a non-negative number', true)
+            self[:LLE] = -self[:LLE]
+          end
+          if key?(:LLO) && self[:LLO] < 0
+            yield('/LLO must be a non-negative number', true)
+            self[:LLO] = -self[:LLO]
+          end
+          if self[:LLE] > 0 && self[:LL] == 0
+            yield("/LL required to be non-zero if /LLE is set")
+          end
+        end
+
+      end
+
+    end
+  end
+end

data/lib/hexapdf/type/annotations/widget.rb

@@ -48,6 +48,8 @@ module HexaPDF
       # See: PDF2.0 s12.5.6.19, HexaPDF::Type::Annotation
       class Widget < Annotation
 
+        include BorderStyling
+
         # The dictionary used by the /MK key of the widget annotation.
         class AppearanceCharacteristics < Dictionary
 
@@ -122,102 +124,6 @@ module HexaPDF
           end
         end
 
-        # Describes the border of an annotation.
-        #
-        # The +color+ property is either +nil+ if the border is transparent or else a device color
-        # object - see HexaPDF::Content::ColorSpace.
-        #
-        # The +style+ property can be one of the following:
-        #
-        # :solid::      Solid line.
-        # :beveled::    Embossed rectangle seemingly raised above the surface of the page.
-        # :inset::      Engraved rectangle receeding into the page.
-        # :underlined:: Underlined, i.e. only the bottom border is draw.
-        # Array:        Dash array describing how to dash the line.
-        BorderStyle = Struct.new(:width, :color, :style, :horizontal_corner_radius,
-                                 :vertical_corner_radius)
-
-        # :call-seq:
-        #   widget.border_style                                      => border_style
-        #   widget.border_style(color: 0, width: 1, style: :solid)   => widget
-        #
-        # Returns a BorderStyle instance representing the border style of the widget when no
-        # argument is given. Otherwise sets the border style of the widget and returns self.
-        #
-        # When setting a border style, arguments that are not provided will use the default: a
-        # border with a solid, black, 1pt wide line. This also means that multiple invocations will
-        # reset *all* prior values.
-        #
-        # +color+:: The color of the border. See
-        #           HexaPDF::Content::ColorSpace.device_color_from_specification for information on
-        #           the allowed arguments.
-        #
-        #           If the special value +:transparent+ is used when setting the color, a
-        #           transparent is used. A transparent border will return a +nil+ value when getting
-        #           the border color.
-        #
-        # +width+:: The width of the border. If set to 0, no border is shown.
-        #
-        # +style+:: Defines how the border is drawn. can be one of the following:
-        #
-        #           +:solid+::      Draws a solid border.
-        #           +:beveled+::    Draws a beveled border.
-        #           +:inset+::      Draws an inset border.
-        #           +:underlined+:: Draws only the bottom border.
-        #           Array::         An array specifying a line dash pattern (see
-        #                           HexaPDF::Content::LineDashPattern)
-        def border_style(color: nil, width: nil, style: nil)
-          if color || width || style
-            color = if color == :transparent
-                      []
-                    else
-                      Content::ColorSpace.device_color_from_specification(color || 0).components
-                    end
-            width ||= 1
-            style ||= :solid
-
-            (self[:MK] ||= {})[:BC] = color
-            bs = self[:BS] = {W: width}
-            case style
-            when :solid then bs[:S] = :S
-            when :beveled then bs[:S] = :B
-            when :inset then bs[:S] = :I
-            when :underlined then bs[:S] = :U
-            when Array
-              bs[:S] = :D
-              bs[:D] = style
-            else
-              raise ArgumentError, "Unknown value #{style} for style argument"
-            end
-            self
-          else
-            result = BorderStyle.new(1, nil, :solid, 0, 0)
-            if (ac = self[:MK]) && (bc = ac[:BC]) && !bc.empty?
-              result.color = Content::ColorSpace.prenormalized_device_color(bc.value)
-            end
-
-            if (bs = self[:BS])
-              result.width = bs[:W] if bs.key?(:W)
-              result.style = case bs[:S]
-                             when :S then :solid
-                             when :B then :beveled
-                             when :I then :inset
-                             when :U then :underlined
-                             when :D then bs[:D].value
-                             else :solid
-                             end
-            elsif key?(:Border)
-              border = self[:Border]
-              result.horizontal_corner_radius = border[0]
-              result.vertical_corner_radius = border[1]
-              result.width = border[2]
-              result.style = border[3] if border[3]
-            end
-
-            result
-          end
-        end
-
         # Describes the marker style of a check box or radio button widget.
         class MarkerStyle
 

data/lib/hexapdf/type/annotations.rb

@@ -48,6 +48,9 @@ module HexaPDF
       autoload(:Text, 'hexapdf/type/annotations/text')
       autoload(:Link, 'hexapdf/type/annotations/link')
       autoload(:Widget, 'hexapdf/type/annotations/widget')
+      autoload(:BorderStyling, 'hexapdf/type/annotations/border_styling')
+      autoload(:Line, 'hexapdf/type/annotations/line')
+      autoload(:AppearanceGenerator, 'hexapdf/type/annotations/appearance_generator')
 
     end
 

data/lib/hexapdf/type/form.rb

@@ -167,14 +167,14 @@ module HexaPDF
       # bounding box.
       #
       # *Note* that a canvas can only be retrieved for initially empty form XObjects!
-      def canvas
+      def canvas(translate: true)
         cache(:canvas) do
           unless stream.empty?
             raise HexaPDF::Error, "Cannot create a canvas for a form XObjects with contents"
           end
 
           canvas = Content::Canvas.new(self)
-          if box.left != 0 || box.bottom != 0
+          if translate && (box.left != 0 || box.bottom != 0)
             canvas.save_graphics_state.translate(box.left, box.bottom)
           end
           self.stream = canvas.stream_data

data/lib/hexapdf/version.rb

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

data/lib/hexapdf/writer.rb

@@ -150,7 +150,6 @@ module HexaPDF
 
       xref_section = XRefSection.new
       xref_section.mark_as_initial_section! unless previous_xref_pos
-      xref_section.add_free_entry(0, 65535) if previous_xref_pos.nil?
       rev.each do |obj|
         if obj.null?
           xref_section.add_free_entry(obj.oid, obj.gen)