hexapdf 0.32.2 → 0.34.0

data/lib/hexapdf/tokenizer.rb

@@ -42,7 +42,7 @@ module HexaPDF
 
   # Tokenizes the content of an IO object following the PDF rules.
   #
-  # See: PDF1.7 s7.2
+  # See: PDF2.0 s7.2
   class Tokenizer
 
     # Represents a keyword in a PDF file.
@@ -61,12 +61,12 @@ module HexaPDF
 
     # Characters defined as whitespace.
     #
-    # See: PDF1.7 s7.2.2
+    # See: PDF2.0 s7.2.2
     WHITESPACE = " \n\r\0\t\f"
 
     # Characters defined as delimiters.
     #
-    # See: PDF1.7 s7.2.2
+    # See: PDF2.0 s7.2.2
     DELIMITER = "()<>{}/[]%"
 
     WHITESPACE_MULTI_RE = /[#{WHITESPACE}]+/ # :nodoc:
@@ -171,7 +171,7 @@ module HexaPDF
     # If the +allow_end_array_token+ argument is +true+, the ']' token is permitted to facilitate
     # the use of this method during array parsing.
     #
-    # See: PDF1.7 s7.3
+    # See: PDF2.0 s7.3
     def next_object(allow_end_array_token: false, allow_keyword: false)
       token = next_token
 
@@ -231,7 +231,7 @@ module HexaPDF
     # If a problem is detected, yields to caller where the argument +recoverable+ is truthy if the
     # problem is recoverable.
     #
-    # See: PDF1.7 7.5.4
+    # See: PDF2.0 7.5.4
     def next_xref_entry #:yield: recoverable
       prepare_string_scanner(20)
       if !@ss.skip(/(\d{10}) (\d{5}) ([nf])(?: \r| \n|\r\n|(\r\r|\r|\n))/) || @ss[4]
@@ -242,7 +242,7 @@ module HexaPDF
 
     # Skips all whitespace at the current position.
     #
-    # See: PDF1.7 s7.2.2
+    # See: PDF2.0 s7.2.2
     def skip_whitespace
       prepare_string_scanner
       prepare_string_scanner while @ss.skip(WHITESPACE_MULTI_RE)
@@ -268,7 +268,7 @@ module HexaPDF
 
     # Parses the keyword at the current position.
     #
-    # See: PDF1.7 s7.2
+    # See: PDF2.0 s7.2
     def parse_keyword
       str = scan_until(WHITESPACE_OR_DELIMITER_RE) || @ss.scan(/.*/)
       TOKEN_CACHE[str]
@@ -278,12 +278,12 @@ module HexaPDF
 
     # Parses the number (integer or real) at the current position.
     #
-    # See: PDF1.7 s7.3.3
+    # See: PDF2.0 s7.3.3
     def parse_number
       val = scan_until(WHITESPACE_OR_DELIMITER_RE) || @ss.scan(/.*/)
       if val.match?(/\A[+-]?\d++(?!\.)\z/)
         tmp = val.to_i
-        # Handle object references, see PDF1.7 s7.3.10
+        # Handle object references, see PDF2.0 s7.3.10
         prepare_string_scanner(10)
         if @ss.scan(REFERENCE_RE)
           tmp = if tmp > 0
@@ -315,7 +315,7 @@ module HexaPDF
 
     # Parses the literal string at the current position.
     #
-    # See: PDF1.7 s7.3.4.2
+    # See: PDF2.0 s7.3.4.2
     def parse_literal_string
       @ss.pos += 1
       str = "".b
@@ -358,7 +358,7 @@ module HexaPDF
 
     # Parses the hex string at the current position.
     #
-    # See: PDF1.7 s7.3.4.3
+    # See: PDF2.0 s7.3.4.3
     def parse_hex_string
       @ss.pos += 1
       data = scan_until(/(?=>)/)
@@ -373,7 +373,7 @@ module HexaPDF
 
     # Parses the name at the current position.
     #
-    # See: PDF1.7 s7.3.5
+    # See: PDF2.0 s7.3.5
     def parse_name
       @ss.pos += 1
       str = scan_until(WHITESPACE_OR_DELIMITER_RE) || @ss.scan(/.*/)
@@ -389,7 +389,7 @@ module HexaPDF
     #
     # It is assumed that the initial '[' has already been scanned.
     #
-    # See: PDF1.7 s7.3.6
+    # See: PDF2.0 s7.3.6
     def parse_array
       result = []
       while true
@@ -408,7 +408,7 @@ module HexaPDF
     #
     # It is assumed that the initial '<<' has already been scanned.
     #
-    # See: PDF1.7 s7.3.7
+    # See: PDF2.0 s7.3.7
     def parse_dictionary
       result = {}
       while true

data/lib/hexapdf/type/acro_form/appearance_generator.rb

@@ -61,7 +61,7 @@ module HexaPDF
       # By subclassing and overriding the necessary methods it is possible to define custom
       # appearances.
       #
-      # See: PDF1.7 s12.5.5, s12.7
+      # See: PDF2.0 s12.5.5, s12.7
       class AppearanceGenerator
 
         # Creates a new instance for the given +widget+.
@@ -200,7 +200,7 @@ module HexaPDF
         def create_text_appearances
           default_resources = @document.acro_form.default_resources
           font, font_size, font_color = retrieve_font_information(default_resources)
-          style = HexaPDF::Layout::Style.new(font: font, fill_color: font_color)
+          style = HexaPDF::Layout::Style.new(font: font, font_size: font_size, fill_color: font_color)
           border_style = @widget.border_style
           padding = [1, border_style.width].max
 
@@ -226,8 +226,6 @@ module HexaPDF
 
           canvas = form.canvas
           apply_background_and_border(border_style, canvas)
-          style.font_size = calculate_font_size(font, font_size, height, border_style)
-          style.clear_cache
 
           canvas.marked_content_sequence(:Tx) do
             if @field.field_value || @field.concrete_field_type == :list_box
@@ -362,6 +360,7 @@ module HexaPDF
         def draw_single_line_text(canvas, width, height, style, padding)
           value, text_color = apply_javascript_formatting(@field.field_value)
           style.fill_color = text_color if text_color
+          calculate_and_apply_font_size(value, style, width, height, padding)
           fragment = HexaPDF::Layout::TextFragment.create(value, style)
 
           if @field.concrete_field_type == :comb_text_field
@@ -431,6 +430,11 @@ module HexaPDF
 
         # Draws the visible option items of the list box in the widget's rectangle.
         def draw_list_box(canvas, width, height, style, padding)
+          if style.font_size == 0
+            style.font_size = 12 # Seems to be Adobe's default
+            style.clear_cache
+          end
+
           option_items = @field.option_items
           top_index = @field.list_box_top_index
           items = [Layout::TextFragment.create(option_items[top_index..-1].join("\n"), style)]
@@ -475,24 +479,20 @@ module HexaPDF
           [font, font_size, font_color]
         end
 
-        # Calculates the font size for text fields based on the font and font size of the default
-        # appearance string, the annotation rectangle's height and the border style.
-        def calculate_font_size(font, font_size, height, border_style)
-          if font_size == 0
-            case @field.concrete_field_type
-            when :multiline_text_field
-              0 # Handled by multiline drawing code
-            when :list_box
-              12 # Seems to be Adobe's default
-            else
-              unit_font_size = (font.wrapped_font.bounding_box[3] - font.wrapped_font.bounding_box[1]) *
-                font.scaling_factor / 1000.0
-              # The constant factor was found empirically by checking what Adobe Reader etc. do
-              (height - 2 * border_style.width) / unit_font_size * 0.83
-            end
-          else
-            font_size
-          end
+        # Calculates the font size for single line text fields using auto-sizing, based on the font
+        # and font size of the default appearance string, the annotation rectangle's height and
+        # width and the given padding. The font size is then applied to the provided style object.
+        def calculate_and_apply_font_size(value, style, width, height, padding)
+          return if style.font_size != 0
+
+          font = style.font
+          unit_font_size = (font.wrapped_font.bounding_box[3] - font.wrapped_font.bounding_box[1]) *
+            font.scaling_factor / 1000.0
+          # The constant factor was found empirically by checking what Adobe Reader etc. do
+          style.font_size = (height - 2 * padding) / unit_font_size * 0.85
+          fragment = HexaPDF::Layout::TextFragment.create(value, style)
+          style.font_size = [style.font_size, style.font_size * (width - 4 * padding) / fragment.width].min
+          style.clear_cache
         end
 
         # Handles Javascript formatting routines for single-line text fields.

data/lib/hexapdf/type/acro_form/button_field.rb

@@ -81,7 +81,7 @@ module HexaPDF
       # :radios_in_unison:: A group of radio buttons with the same value for the on state will turn
       #                     on or off in unison.
       #
-      # See: PDF1.7 s12.7.4.2
+      # See: PDF2.0 s12.7.4.2
       class ButtonField < Field
 
         define_type :XXAcroFormField

data/lib/hexapdf/type/acro_form/choice_field.rb

@@ -66,7 +66,7 @@ module HexaPDF
       # :commit_on_sel_change:: If set, a new value should be commited as soon as a selection is
       #                         made.
       #
-      # See: PDF1.7 s12.7.4.4
+      # See: PDF2.0 s12.7.5.4
       class ChoiceField < VariableTextField
 
         define_type :XXAcroFormField

data/lib/hexapdf/type/acro_form/field.rb

@@ -86,7 +86,7 @@ module HexaPDF
       # to combination of the superclass value of the constant and the mapping of flag names to bit
       # indices.
       #
-      # See: PDF1.7 s12.7.3.1
+      # See: PDF2.0 s12.7.4.1
       class Field < Dictionary
 
         # Provides a #value method for hash that returns self so that a Hash can be used
@@ -367,7 +367,7 @@ module HexaPDF
           document.pages.each do |page|
             if page.key?(:Annots) && (index = page[:Annots].index(self))
               page[:Annots][index] = widget
-              break # Each annotation dictionary may only appear on one page, see PDF1.7 12.5.2
+              break # Each annotation dictionary may only appear on one page, see PDF2.0 12.5.2
             end
           end
           widget

data/lib/hexapdf/type/acro_form/form.rb

@@ -68,7 +68,7 @@ module HexaPDF
       # HexaPDF uses the configuration option +acro_form.create_appearance_streams+ to determine
       # whether appearances should automatically be generated.
       #
-      # See: PDF1.7 s12.7.2, Field, HexaPDF::Type::Annotations::Widget
+      # See: PDF2.0 s12.7.3, Field, HexaPDF::Type::Annotations::Widget
       class Form < Dictionary
 
         extend Utils::BitField

data/lib/hexapdf/type/acro_form/signature_field.rb

@@ -49,13 +49,13 @@ module HexaPDF
       # If the signature should not be visible, the associated widget annotation should have zero
       # width and height; and/or the 'hidden' or 'no_view' flags of the annotation should be set.
       #
-      # See: PDF1.7 s12.7.4.5
+      # See: PDF2.0 s12.7.5.5
       class SignatureField < Field
 
         # A signature field lock dictionary specifies a set of form fields that should be locked
         # once the associated signature field is signed.
         #
-        # See: PDF1.7 s12.7.4.5
+        # See: PDF2.0 s12.7.5.5
         class LockDictionary < Dictionary
 
           define_type :SigFieldLock
@@ -86,7 +86,7 @@ module HexaPDF
         # The available flags are: filter, sub_filter, v, reasons, legal_attestation, add_rev_info
         # and digest_method.
         #
-        # See: PDF1.7 s12.7.4.5
+        # See: PDF2.0 s12.7.5.5
         class SeedValueDictionary < Dictionary
 
           extend Utils::BitField
@@ -145,7 +145,7 @@ module HexaPDF
         #
         # The available flags are: subject, issuer, oid, subject_dn, reserved,  key_usage and url.
         #
-        # See: PDF1.7 s12.7.4.5
+        # See: PDF2.0 s12.7.5.5
         class CertificateSeedValueDictionary < Dictionary
 
           extend Utils::BitField

data/lib/hexapdf/type/acro_form/text_field.rb

@@ -70,7 +70,7 @@ module HexaPDF
       #
       # :rich_text:: The field is a rich text field.
       #
-      # See: PDF1.7 s12.7.4.3
+      # See: PDF2.0 s12.7.5.3
       class TextField < VariableTextField
 
         define_type :XXAcroFormField

data/lib/hexapdf/type/acro_form/variable_text_field.rb

@@ -48,7 +48,7 @@ module HexaPDF
       # value; the value is entered by the user and needs to be rendered correctly by the PDF
       # reader.
       #
-      # See: PDF1.7 s12.7.3.3
+      # See: PDF2.0 s12.7.4.3
       class VariableTextField < Field
 
         define_field :DA, type: String

data/lib/hexapdf/type/acro_form.rb

@@ -39,7 +39,7 @@ module HexaPDF
 
     # Namespace module for all AcroForm related dictionary types.
     #
-    # See: PDF1.7 s12.7
+    # See: PDF2.0 s12.7
     module AcroForm
 
       autoload(:Form, 'hexapdf/type/acro_form/form')

data/lib/hexapdf/type/action.rb

@@ -44,7 +44,7 @@ module HexaPDF
     # Action dictionaries are used, for example, by annotations or outline items to specify the
     # action that should be performed. Each action class should be defined under the Actions module.
     #
-    # See: PDF1.7 s12.6
+    # See: PDF2.0 s12.6
     class Action < Dictionary
 
       define_type :Action

data/lib/hexapdf/type/actions/go_to.rb

@@ -42,7 +42,7 @@ module HexaPDF
 
       # A Go-To action changes the view to a specific destination.
       #
-      # See: PDF1.7 s12.6.4.2
+      # See: PDF2.0 s12.6.4.2
       class GoTo < Action
 
         define_field :S, type: Symbol, required: true, default: :GoTo

data/lib/hexapdf/type/actions/go_to_r.rb

@@ -42,7 +42,7 @@ module HexaPDF
 
       # A remote Go-To action dictionary jumps to a destination in a different PDF file.
       #
-      # See: PDF1.7 s12.6.4.3
+      # See: PDF2.0 s12.6.4.3
       class GoToR < Action
 
         define_field :S,         type: Symbol, required: true, default: :GoToR

data/lib/hexapdf/type/actions/launch.rb

@@ -42,7 +42,7 @@ module HexaPDF
 
       # A Launch action dictionary launches an application, opens a document or prints a document.
       #
-      # See: PDF1.7 s12.6.4.5
+      # See: PDF2.0 s12.6.4.6
       class Launch < Action
 
         # The type used for the /Win field of a Launch action dictionary.

data/lib/hexapdf/type/actions/set_ocg_state.rb

@@ -0,0 +1,86 @@
+# -*- 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-2023 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/action'
+
+module HexaPDF
+  module Type
+    module Actions
+
+      # A Set-OCG-state action changes the state of one or more optional content groups.
+      #
+      # See: PDF2.0 s12.6.4.13, HexaPDF::Type::OptionalContentGroup
+      class SetOCGState < Action
+
+        define_field :S, type: Symbol, required: true, default: :SetOCGState
+        define_field :State, type: PDFArray, required: true, default: []
+        define_field :PreserveRB, type: Boolean, default: true
+
+        STATE_TYPE_MAPPING = {on: :ON, ON: :ON, off: :OFF, OFF: :OFF, # :nodoc:
+                              toggle: :Toggle, Toggle: :Toggle}
+
+        # Adds a state changing sequence to the /State array.
+        #
+        # The +type+ argument specifies how the state of the given optional content groups should be
+        # changed.
+        #
+        # +type+:: The type of sequence to add, either :on/:ON (for turning the OCGs on) , :off/:OFF
+        #          (for turning the OCGs off), or :toggle/:Toggle (for toggling the state of the
+        #          OCGs).
+        #
+        # +ocgs+:: A single optional content group or an array of optional content groups to which
+        #          the state change defined with +type+ should be applied. The OCGs can be specified
+        #          via their dictionary or by name which uses the first found OCG with that name.
+        def add_state_change(type, ocgs)
+          type = STATE_TYPE_MAPPING.fetch(type) do
+            raise ArgumentError, "Invalid type #{type} specified, should be one of :on, :off or :toggle"
+          end
+          state = self[:State]
+          state << type
+          Array(ocgs).each do |ocg|
+            if (ocg_name = ocg).kind_of?(String)
+              ocg = document.optional_content.ocg(ocg_name, create: false)
+              raise HexaPDF::Error, "Invalid OCG named '#{ocg_name}' specified" unless ocg
+            end
+            state << ocg
+          end
+        end
+
+      end
+
+    end
+  end
+end

data/lib/hexapdf/type/actions/uri.rb

@@ -42,7 +42,7 @@ module HexaPDF
 
       # Represents an URI action dictionary, mostly used for opening Internet pages.
       #
-      # See: PDF1.7 s12.6.4.7
+      # See: PDF2.0 s12.6.4.8
       class URI < Action
 
         define_field :S,     type: Symbol, required: true, default: :URI

data/lib/hexapdf/type/actions.rb

@@ -41,13 +41,14 @@ module HexaPDF
 
     # Namespace module for all PDF action dictionary types.
     #
-    # See: PDF1.7 s12.6.4, Action
+    # See: PDF2.0 s12.6.4, Action
     module Actions
 
       autoload(:GoTo, 'hexapdf/type/actions/go_to')
       autoload(:GoToR, 'hexapdf/type/actions/go_to_r')
       autoload(:Launch, 'hexapdf/type/actions/launch')
       autoload(:URI, 'hexapdf/type/actions/uri')
+      autoload(:SetOCGState, 'hexapdf/type/actions/set_ocg_state')
 
     end
 

data/lib/hexapdf/type/annotation.rb

@@ -43,7 +43,7 @@ module HexaPDF
     # Annotations are used to associate objects like notes, sounds or movies with a location on a
     # PDF page or allow the user to interact with a PDF document using a keyboard or mouse.
     #
-    # See: PDF1.7 s12.5
+    # See: PDF2.0 s12.5
     class Annotation < Dictionary
 
       # The appearance dictionary references appearance streams for various use cases.
@@ -52,7 +52,7 @@ module HexaPDF
       # latter is used when the appearance depends on the state of the annotation, e.g. a check box
       # widget that can be checked or unchecked.
       #
-      # See: PDF1.7 s12.5.5
+      # See: PDF2.0 s12.5.5
       class AppearanceDictionary < Dictionary
 
         define_type :XXAppearanceDictionary
@@ -101,7 +101,7 @@ module HexaPDF
 
       # Border style dictionary used by various annotation types.
       #
-      # See: PDF1.7 s12.5.4
+      # See: PDF2.0 s12.5.4
       class Border < Dictionary
 
         define_type :Border

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

@@ -43,7 +43,7 @@ module HexaPDF
       # Link annotations represent a link to a destination elsewhere in the PDF document or an
       # action to be performed.
       #
-      # See: PDF1.7 s12.5.6.5, HexaPDF::Type::Annotation
+      # See: PDF2.0 s12.5.6.5, HexaPDF::Type::Annotation
       class Link < Annotation
 
         define_field :Subtype,    type: Symbol, required: true, default: :Link

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

@@ -43,7 +43,7 @@ module HexaPDF
       # Markup annotations are used to "mark up" a PDF document, most of the available PDF
       # annotations are actually markup annotations.
       #
-      # See: PDF1.7 s12.5.6.2, HexaPDF::Type::Annotation
+      # See: PDF2.0 s12.5.6.2, HexaPDF::Type::Annotation
       class MarkupAnnotation < Annotation
 
         define_field :T,            type: String, version: '1.1'

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

@@ -43,7 +43,7 @@ module HexaPDF
       # Text annotations are "sticky notes" attached to a point in a PDF document. They act as if
       # the NoZoom and NoRotate flags were always set.
       #
-      # See: PDF1.7 s12.5.6.4, HexaPDF::Type::MarkupAnnotation
+      # See: PDF2.0 s12.5.6.4, HexaPDF::Type::MarkupAnnotation
       class Text < MarkupAnnotation
 
         define_field :Subtype,    type: Symbol, required: true, default: :Text
@@ -55,8 +55,7 @@ module HexaPDF
 
         private
 
-        # :nodoc:
-        STATE_TO_STATE_MODEL = {
+        STATE_TO_STATE_MODEL = { # :nodoc:
           "Marked" => "Marked", "Unmarked" => "Marked",
           "Accepted" => "Review", "Rejected" => "Review", "Cancelled" => "Review",
           "Completed" => "Review", "None" => "Review"

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

@@ -45,7 +45,7 @@ module HexaPDF
       # Widget annotations are used by interactive forms to represent the appearance of fields and
       # to manage user interactions.
       #
-      # See: PDF1.7 s12.5.6.19, HexaPDF::Type::Annotation
+      # See: PDF2.0 s12.5.6.19, HexaPDF::Type::Annotation
       class Widget < Annotation
 
         # The dictionary used by the /MK key of the widget annotation.
@@ -264,7 +264,7 @@ module HexaPDF
         # the /DA key on the widget (although /DA is not defined for widget, this is how Acrobat
         # does it).
         #
-        # See: PDF1.7 s12.5.6.19 and s17.7.3.3
+        # See: PDF2.0 s12.5.6.19 and s12.7.4.3
         def marker_style(style: nil, size: nil, color: nil)
           field = form_field
           if style || size || color

data/lib/hexapdf/type/annotations.rb

@@ -41,7 +41,7 @@ module HexaPDF
 
     # Namespace module for all PDF annotation dictionary types.
     #
-    # See: PDF1.7 s12.5.6, Annotation
+    # See: PDF2.0 s12.5.6, Annotation
     module Annotations
 
       autoload(:MarkupAnnotation, 'hexapdf/type/annotations/markup_annotation')

data/lib/hexapdf/type/catalog.rb

@@ -46,7 +46,7 @@ module HexaPDF
     #
     # The catalog dictionary is linked via the /Root entry from the Trailer.
     #
-    # See: PDF1.7 s7.7.2, Trailer
+    # See: PDF2.0 s7.7.2, Trailer
     class Catalog < Dictionary
 
       define_type :Catalog
@@ -78,7 +78,7 @@ module HexaPDF
       define_field :SpiderInfo,        type: Dictionary, version: '1.3'
       define_field :OutputIntents,     type: PDFArray,   version: '1.4'
       define_field :PieceInfo,         type: Dictionary, version: '1.4'
-      define_field :OCProperties,      type: Dictionary, version: '1.5'
+      define_field :OCProperties,      type: :XXOCProperties, version: '1.5'
       define_field :Perms,             type: Dictionary, version: '1.5'
       define_field :Legal,             type: Dictionary, version: '1.5'
       define_field :Requirements,      type: PDFArray,   version: '1.7'
@@ -112,6 +112,15 @@ module HexaPDF
         self[:Outlines] ||= document.add({}, type: :Outlines)
       end
 
+      # Returns the optional content properties dictionary, creating it if needed.
+      #
+      # This is the main entry point for working with optional content, a.k.a. layers.
+      #
+      # See: OptionalContentProperties
+      def optional_content
+        self[:OCProperties] ||= document.add({OCGs: [], D: {Creator: 'HexaPDF'}}, type: :XXOCProperties)
+      end
+
       # Returns the main AcroForm object.
       #
       # * If an AcroForm object exists, the +create+ argument is not used.

data/lib/hexapdf/type/cid_font.rb

@@ -42,13 +42,27 @@ module HexaPDF
     # Represents a generic CIDFont which can only be used as a descendant font of a composite PDF
     # font.
     #
-    # See: PDF1.7 s9.7.4
+    # See: PDF2.0 s9.7.4
     class CIDFont < Font
 
+      # Describes the CIDSystemInfo dictionary specifying the character collection assumed by the
+      # CIDFont.
+      #
+      # See: PDF2.0 s9.7.3
+      class CIDSystemInfo < Dictionary
+
+        define_type :XXCIDSystemInfo
+
+        define_field :Registry, type: String, required: true
+        define_field :Ordering, type: String, required: true
+        define_field :Supplement, type: Integer, required: true
+
+      end
+
       DEFAULT_WIDTH = 1000 # :nodoc:
 
       define_field :BaseFont,        type: Symbol, required: true
-      define_field :CIDSystemInfo,   type: Dictionary, required: true
+      define_field :CIDSystemInfo,   type: :XXCIDSystemInfo, required: true
       define_field :FontDescriptor,  type: :FontDescriptor, indirect: true, required: true
       define_field :DW,              type: Integer, default: DEFAULT_WIDTH
       define_field :W,               type: PDFArray
@@ -66,7 +80,7 @@ module HexaPDF
       # Sets the /W and /DW keys using the given array of [CID, width] pairs and an optional default
       # width.
       #
-      # See: PDF1.7 s9.7.4.3
+      # See: PDF2.0 s9.7.4.3
       def set_widths(widths, default_width: DEFAULT_WIDTH)
         if widths.empty?
           (default_width == DEFAULT_WIDTH ? delete(:DW) : self[:DW] = default_width)
@@ -93,7 +107,7 @@ module HexaPDF
       #
       # Note that the hash is cached internally when accessed the first time.
       #
-      # See: PDF1.7 s9.7.4.3
+      # See: PDF2.0 s9.7.4.3
       def widths
         cache(:widths) do
           result = {}

data/lib/hexapdf/type/embedded_file.rb

@@ -46,7 +46,7 @@ module HexaPDF
     # Type::FileSpecification dictionary or with the document as a whole through the /EmbeddedFiles
     # entry in the document catalog's /Names dictionary.
     #
-    # See: PDF1.7 s7.11.4, FileSpecification
+    # See: PDF2.0 s7.11.4, FileSpecification
     class EmbeddedFile < Stream
 
       # The type used for the /Mac field of an EmbeddedFile::Parameters dictionary.