origami 1.2.7 → 2.0.0

data/examples/javascript/hello_world.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "/../../lib")
+    require 'origami'
+end
+include Origami
+
+#
+# Displays a message box when the document is opened.
+#
+
+OUTPUT_FILE = "#{File.basename(__FILE__, ".rb")}.pdf"
+
+# Creating a new file
+pdf = PDF.new
+         .onDocumentOpen(Action::JavaScript 'app.alert("Hello world");')
+         .save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/examples/javascript/js_emulation.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "/../../lib")
+    require 'origami'
+end
+include Origami
+
+#
+# Emulating JavaScript inside a PDF object.
+#
+
+if defined?(PDF::JavaScript::Engine)
+
+    # Creating a new file
+    pdf = PDF.new
+
+    # Embedding the file into the PDF.
+    pdf.attach_file(DATA,
+        name: "README.txt",
+        filter: :ASCIIHexDecode
+    )
+
+    # Example of JS payload
+    pdf.onDocumentOpen Action::JavaScript <<-JS
+        if ( app.viewerVersion == 8 )
+          eval("this.exportDataObject({cName:'README.txt', nLaunch:2});");
+        this.closeDoc();
+    JS
+
+    # Tweaking the engine options
+    pdf.js_engine.options[:log_method_calls] = true
+    pdf.js_engine.options[:viewerVersion] = 10
+
+    # Hooking eval()
+    pdf.js_engine.hook 'eval' do |eval, expr|
+        puts "Hook: eval(#{expr.inspect})"
+        eval.call(expr) # calling the real eval method
+    end
+
+    # Example of inline JS evaluation
+    pdf.eval_js 'console.println(util.stringFromStream(this.getDataObjectContents("README.txt")))'
+
+    # Executes the string as a JS script
+    pdf.Catalog.OpenAction[:JS].eval_js
+
+else
+    abort "JavaScript support not found. You need to install therubyracer gem."
+end
+
+__END__
+** THIS IS THE EMBEDDED FILE **

data/examples/loop/goto.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "../../lib")
+    require 'origami'
+end
+include Origami
+
+OUTPUT_FILE = "#{File.basename(__FILE__, '.rb')}.pdf"
+
+pdf = PDF.new
+
+50.times do |n|
+    pdf.append_page do |page|
+        contents = ContentStream.new
+        contents.write "page #{n+1}",
+            x: 250, y: 450, rendering: Text::Rendering::FILL, size: 30
+
+        page.Contents = contents
+    end
+end
+
+pages = pdf.pages
+pages.each_with_index do |page, index|
+    page.onOpen Action::GoTo Destination::GlobalFit[pages[(index + 1) % pages.size]]
+end
+
+pdf.save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/examples/loop/named.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "../../lib")
+    require 'origami'
+end
+include Origami
+
+OUTPUT_FILE = "#{File.basename(__FILE__, '.rb')}.pdf"
+
+pdf = PDF.new
+
+50.times do |n|
+    pdf.append_page do |page|
+        contents = ContentStream.new
+        contents.write "page #{n+1}",
+            x: 250, y: 450, rendering: Text::Rendering::FILL, size: 30
+
+        page.Contents = contents
+
+        if n != 49
+            page.onOpen Action::Named::NEXT_PAGE
+        else
+            page.onOpen Action::Named::FIRST_PAGE
+        end
+    end
+end
+
+pdf.save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/examples/signature/signature.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/ruby
+
+require 'openssl'
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "../../lib")
+    require 'origami'
+end
+include Origami
+
+OUTPUT_FILE = "#{File.basename(__FILE__, ".rb")}.pdf"
+
+puts "Generating a RSA key pair."
+key = OpenSSL::PKey::RSA.new 2048
+
+puts "Generating a self-signed certificate."
+name = OpenSSL::X509::Name.parse 'CN=origami/DC=example'
+
+cert = OpenSSL::X509::Certificate.new
+cert.version = 2
+cert.serial = 0
+cert.not_before = Time.now
+cert.not_after = Time.now + 3600
+
+cert.public_key = key.public_key
+cert.subject = name
+
+extension_factory = OpenSSL::X509::ExtensionFactory.new nil, cert
+
+cert.add_extension extension_factory.create_extension('basicConstraints', 'CA:TRUE', true)
+cert.add_extension extension_factory.create_extension('keyUsage', 'digitalSignature')
+cert.add_extension extension_factory.create_extension('subjectKeyIdentifier', 'hash')
+
+cert.issuer = name
+cert.sign key, OpenSSL::Digest::SHA256.new
+
+# Create the PDF contents
+contents = ContentStream.new.setFilter(:FlateDecode)
+contents.write OUTPUT_FILE,
+    x: 350, y: 750, rendering: Text::Rendering::STROKE, size: 30
+
+pdf = PDF.new
+page = Page.new.setContents(contents)
+pdf.append_page(page)
+
+sig_annot = Annotation::Widget::Signature.new
+sig_annot.Rect = Rectangle[llx: 89.0, lly: 386.0, urx: 190.0, ury: 353.0]
+
+page.add_annotation(sig_annot)
+
+# Sign the PDF with the specified keys
+pdf.sign(cert, key,
+    method: 'adbe.pkcs7.detached',
+    annotation: sig_annot,
+    location: "France",
+    contact: "gdelugre@localhost",
+    reason: "Signature sample"
+)
+
+# Save the resulting file
+pdf.save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/examples/uri/javascript.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "../../lib")
+    require 'origami'
+end
+include Origami
+
+OUTPUT_FILE = "#{File.basename(__FILE__, '.rb')}.pdf"
+URL = "http://google.fr"
+
+contents = ContentStream.new.setFilter(:FlateDecode)
+contents.write OUTPUT_FILE,
+  :x => 200, :y => 750, :rendering => Text::Rendering::FILL, :size => 30
+
+contents.write "The script first tries to run your browser using JavaScript.",
+  :x => 100, :y => 670, :size => 15
+
+# A JS script to execute at the opening of the document
+jscript = <<JS
+try {
+    app.launchURL("#{URL}");
+}
+catch(e) {}
+
+try {
+    this.submitForm(
+    {
+        cURL: "#{URL}",
+        bAnnotations: true,
+        bGet: true,
+        cSubmitAs: "XML"
+    });
+}
+catch(e) {}
+JS
+
+pdf = PDF.new
+
+pdf.append_page do |page|
+    page.Contents = contents
+end
+
+# Create a new action based on the script, compressed with zlib
+jsaction = Action::JavaScript Stream.new(jscript)#@ Filter: :FlateDecode)
+
+# Add the script into the document names dictionary.
+# Any scripts registered here will be executed at the document opening (with no OpenAction implied).
+pdf.register(Names::JAVASCRIPT, "Update", jsaction)
+
+# Save the resulting file
+pdf.save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/examples/uri/open-uri.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "../../lib")
+    require 'origami'
+end
+include Origami
+
+OUTPUT_FILE = "#{File.basename(__FILE__, '.rb')}.pdf"
+URL = "http://google.fr"
+
+pdf = PDF.new
+
+# Trigger an URI action when the document is opened.
+pdf.onDocumentOpen Action::URI[URL]
+
+pdf.save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/examples/uri/submitform.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/ruby
+
+begin
+    require 'origami'
+rescue LoadError
+    $: << File.join(__dir__, "../../lib")
+    require 'origami'
+end
+include Origami
+
+OUTPUT_FILE = "#{File.basename(__FILE__, '.rb')}.pdf"
+URL = "http://mydomain/calc.pdf"
+
+pdf = PDF.new
+
+contents = ContentStream.new
+contents.write OUTPUT_FILE,
+    x: 210, y: 750, rendering: Text::Rendering::FILL, size: 30
+
+contents.write "When opened, this PDF connects to \"home\"",
+    x: 156, y: 690, rendering: Text::Rendering::FILL, size: 15
+
+contents.write "Click \"Allow\" to connect to #{URL} through your current Reader.",
+    x: 106, y: 670, size: 12
+
+contents.write "Comments:",
+    x: 75, y: 600, rendering: Text::Rendering::FILL_AND_STROKE, size: 12
+
+comment = <<-EOS
+    Adobe Reader will render the PDF file returned by the remote server.
+EOS
+
+contents.write comment,
+    x: 75, y: 580, rendering: Text::Rendering::FILL, size: 12
+
+pdf.append_page Page.new.setContents(contents)
+
+# Submit flags.
+flags = Action::SubmitForm::Flags::EXPORTFORMAT|Action::SubmitForm::Flags::GETMETHOD
+
+# Sends the form at the document opening.
+pdf.onDocumentOpen Action::SubmitForm[URL, [], flags]
+
+# Save the resulting file.
+pdf.save(OUTPUT_FILE)
+
+puts "PDF file saved as #{OUTPUT_FILE}."

data/lib/origami.rb

@@ -1,55 +1,42 @@
 =begin
 
-= File
-	origami.rb
+    This file is part of Origami, PDF manipulation framework for Ruby
+    Copyright (C) 2016	Guillaume Delugré.
 
-= Info
-	Origami is free software: you can redistribute it and/or modify
-  it under the terms of the GNU Lesser General Public License as published by
-  the Free Software Foundation, either version 3 of the License, or
-  (at your option) any later version.
+    Origami is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
 
-  Origami 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 Lesser General Public License for more details.
+    Origami 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 Lesser General Public License for more details.
 
-  You should have received a copy of the GNU Lesser General Public License
-  along with Origami.  If not, see <http://www.gnu.org/licenses/>.
+    You should have received a copy of the GNU Lesser General Public License
+    along with Origami.  If not, see <http://www.gnu.org/licenses/>.
 
 =end
 
-
-if RUBY_VERSION < '1.9'
-  class Fixnum
-    def ord; self; end
-  end
-
-  class Hash
-    alias key index
-  end
-end
-
 module Origami
-  VERSION   = "1.2.6"
-  REVISION  = "$Revision$" #:nodoc:
   
-  #
-  # Global 
-  # options for Origami.
-  #
-  OPTIONS   = 
-  {
-    :enable_type_checking => true,      # set to false to disable type consistency checks during compilation.
-    :enable_type_guessing => true,      # set to false to prevent the parser to guess the type of special dictionary and streams (not recommended).
-    :enable_type_propagation => true,   # set to false to prevent the parser to propagate type from parents to children.
-    :use_openssl => true,               # set to false to use Origami crypto backend.
-    :ignore_bad_references => false,    # set to interpret invalid references as Null objects, instead of raising an exception.
-    :ignore_zlib_errors => false,       # set to true to ignore exceptions on invalid Flate streams.
-  }
+    #
+    # Global options for Origami.
+    #
+    OPTIONS = 
+    {
+        enable_type_checking: true,      # set to false to disable type consistency checks during compilation.
+        enable_type_guessing: true,      # set to false to prevent the parser to guess the type of special dictionary and streams (not recommended).
+        enable_type_propagation: true,   # set to false to prevent the parser to propagate type from parents to children.
+        use_openssl: true,               # set to false to use Origami crypto backend.
+        ignore_bad_references: false,    # set to interpret invalid references as Null objects, instead of raising an exception.
+        ignore_zlib_errors: false,       # set to true to ignore exceptions on invalid Flate streams.
+        ignore_png_errors: false,        # set to true to ignore exceptions on invalid PNG predictors.
+    }
+
+    autoload :FDF, 'origami/extensions/fdf'
+    autoload :PPKLite, 'origami/extensions/ppklite'
 end
 
+require 'origami/version'
 require 'origami/pdf'
-require 'origami/extensions/fdf'
-require 'origami/extensions/ppklite'
-

data/lib/origami/3d.rb

@@ -1,239 +1,364 @@
 =begin
 
-= File
-	3d.rb
-
-= Info
-	This file is part of Origami, PDF manipulation framework for Ruby
-	Copyright (C) 2010	Guillaume Delugré <guillaume AT security-labs DOT org>
-	All right reserved.
-	
-  Origami is free software: you can redistribute it and/or modify
-  it under the terms of the GNU Lesser General Public License as published by
-  the Free Software Foundation, either version 3 of the License, or
-  (at your option) any later version.
-
-  Origami 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 Lesser General Public License for more details.
-
-  You should have received a copy of the GNU Lesser General Public License
-  along with Origami.  If not, see <http://www.gnu.org/licenses/>.
+    This file is part of Origami, PDF manipulation framework for Ruby
+    Copyright (C) 2016	Guillaume Delugré.
+
+    Origami is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    Origami 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 Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with Origami.  If not, see <http://www.gnu.org/licenses/>.
 
 =end
 
 module Origami
 
-  class Annotation
-    
-    #
-    # 3D Artwork annotation.
-    #
-    class Artwork3D < Annotation
-      field   :Subtype,     :Type => Name, :Default => :"3D", :Version => "1.6", :Required => true
-      field   :"3DD",       :Type => [ Dictionary, Stream ], :Required => true
-      field   :"3DV",       :Type => Object
-      field   :"3DA",       :Type => Dictionary
-      field   :"3DI",       :Type => Boolean, :Default => true
-      field   :"3DB",       :Type => Array
-
-      class Activation < Dictionary
+    class Projection3D < Dictionary
         include StandardObject
 
-        module Events
-          PAGE_OPEN       = :PO
-          PAGE_CLOSE      = :PC
-          PAGE_VISIBLE    = :PV
-          PAGE_INVISIBLE  = :PI
-          USER_ACTIVATE   = :XA
-          USER_DEACTIVATE = :XD 
+        ORTHOGRAPHIC          = :O
+        PERSPECTIVE           = :P
+
+        module ClippingStyles
+            EXPLICIT_NEARFAR    = :XNF
+            AUTOMATIC_NEARFAR   = :ANF
         end
 
-        module State
-          UNINSTANCIATED  = :U
-          INSTANCIATED    = :I
-          LIVE            = :L
+        module Scaling
+            WIDTH               = :W
+            HEIGHT              = :H
+            MINIMUM             = :Min
+            MAXIMUM             = :Max
+            ABSOLUTE            = :Absolute
         end
 
-        field   :A,         :Type => Name, :Default => Events::USER_ACTIVATE
-        field   :AIS,       :Type => Name, :Default => State::LIVE
-        field   :D,         :Type => Name, :Default => Events::PAGE_INVISIBLE
-        field   :DIS,       :Type => Name, :Default => State::UNINSTANCIATED
-        field   :TB,        :Type => Boolean, :Version => "1.7", :Default => true
-        field   :NP,        :Type => Boolean, :Version => "1.7", :Default => false
-      end
-    end
-
-  end
-
-  class U3DStream < Stream
-    include StandardObject
-
-    field   :Type,          :Type => Name, :Default => :"3D"
-    field   :Subtype,       :Type => Name, :Default => :U3D, :Required => true
-    field   :VA,            :Type => Dictionary
-    field   :DV,            :Type => Object
-    field   :Resources,     :Type => Dictionary
-    field   :OnInstantiate, :Type => Stream
-    field   :AN,            :Type => Dictionary
-
-    def onInstantiate(action)
-      self[:OnInstantiate] = action
-    end
-  end
-
-  class AnimationStyle3D < Dictionary
-    include StandardObject
-
-    module Styles
-      NONE                = :None
-      LINEAR              = :Linear
-      OSCILLATING         = :Oscillating
-    end
-
-    field   :Type,          :Type => Name, :Default => "3DAnimationStyle"
-    field   :Subtype,       :Type => Name, :Default => Styles::NONE
-    field   :PC,            :Type => Integer, :Default => 0
-    field   :TM,            :Type => Number, :Default => 1
-  end
-
-  class Reference3D < Dictionary
-    include StandardObject
-
-    field   :Type,          :Type => Name, :Default => :"3DRef"
-    field   :"3DD",         :Type => Stream
-  end
-
-  class View3D < Dictionary
-    include StandardObject
-
-    field   :Type,          :Type => Name, :Default => :"3DView"
-    field   :XN,            :Type => ByteString, :Required => true
-    field   :IN,            :Type => ByteString
-    field   :MS,            :Type => Name
-    field   :C2W,           :Type => Array
-    field   :U3DPath,       :Type => [ ByteString, Array ]
-    field   :CO,            :Type => Number
-    field   :P,             :Type => Dictionary
-    field   :O,             :Type => Stream
-    field   :BG,            :Type => Dictionary
-    field   :RM,            :Type => Dictionary, :Version => "1.7"
-    field   :LS,            :Type => Dictionary, :Version => "1.7"
-    field   :SA,            :Type => Array, :Version => "1.7"
-    field   :NA,            :Type => Array, :Version => "1.7"
-    field   :NR,            :Type => Boolean, :Version => "1.7", :Default => false
-  end
-
-  class Projection3D < Dictionary
-    include StandardObject
-
-    ORTHOGRAPHIC          = :O
-    PERSPECTIVE           = :P
-
-    module ClippingStyles
-      EXPLICIT_NEARFAR    = :XNF
-      AUTOMATIC_NEARFAR   = :ANF
-    end
-
-    module Scaling
-      WIDTH               = :W
-      HEIGHT              = :H
-      MINIMUM             = :Min
-      MAXIMUM             = :Max
-      ABSOLUTE            = :Absolute
-    end
-
-    field   :Subtype,       :Type => Name, :Default => ORTHOGRAPHIC
-    field   :CS,            :Type => Name, :Default => ClippingStyles::AUTOMATIC_NEARFAR
-    field   :F,             :Type => Number
-    field   :N,             :Type => Number
-    field   :FOV,           :Type => Number
-    field   :PS,            :Type => [ Number, Name ], :Default => Scaling::WIDTH
-    field   :OS,            :Type => Number, :Default => 1
-    field   :OB,            :Type => Name, :Version => "1.7", :Default => Scaling::ABSOLUTE
-  end
-
-  class Background3D < Dictionary
-    include StandardObject
-
-    field   :Type,          :Type => Name, :Default => :"3DBG"
-    field   :Subtype,       :Type => Name, :Default => :SC
-    field   :CS,            :Type => [ Name, Array ], :Default => Graphics::Color::Space::DEVICE_RGB
-    field   :C,             :Type => Object, :Default => [ 1, 1, 1 ]
-    field   :EA,            :Type => Boolean, :Default => false
-  end
-
-  class RenderMode3D < Dictionary
-    include StandardObject
-
-    module Modes
-      SOLID                           = :Solid
-      SOLID_WIREFRAME                 = :SolidWireFrame
-      TRANSPARENT                     = :Transparent
-      TRANSPARENT_WIREFRAME           = :TransparentWireFrame
-      BOUNDINGBOX                     = :BoundingBox
-      TRANSPARENT_BOUNDINGBOX         = :TransparentBoundingBox
-      TRANSPARENT_BOUNDINGBOX_OUTLINE = :TransparentBoundingBoxOutline
-      WIREFRAME                       = :WireFrame
-      SHADED_WIREFRAME                = :ShadedWireFrame
-      HIDDEN_WIREFRAME                = :HiddenWireFrame
-      VERTICES                        = :Vertices
-      SHADED_VERTICES                 = :ShadedVertices
-      ILLUSTRATION                    = :Illustration
-      SOLID_OUTLINE                   = :SolidOutline
-      SHADED_ILLUSTRATION             = :ShadedIllustration
-    end
-
-    field   :Type,          :Type => Name, :Default => :"3DRenderMode"
-    field   :Subtype,       :Type => Name, :Required => true, :Version => "1.7"
-    field   :AC,            :Type => Array, :Default => [ Graphics::Color::Space::DEVICE_RGB, 0, 0, 0]
-    field   :BG,            :Type => [ Name, Array ], :Default => :BG
-    field   :O,             :Type => Number, :Default => 0.5
-    field   :CV,            :Type => Number, :Default => 45
-  end
-
-  class LightingScheme3D < Dictionary
-    include StandardObject
-
-    module Styles
-      ARTWORK                         = :Artwork
-      NONE                            = :None
-      WHITE                           = :White
-      DAY                             = :Day
-      NIGHT                           = :Night
-      HARD                            = :Hard
-      PRIMARY                         = :Primary
-      BLUE                            = :Blue
-      RED                             = :Red
-      CUBE                            = :Cube
-      CAD                             = :CAD
-      HEADLAMP                        = :HeadLamp
-    end
-
-    field   :Type,          :Type => Name, :Default => :"3DLightingScheme"
-    field   :Subtype,       :Type => Name, :Version => "1.7", :Required => true
-  end
-
-  class CrossSection3D < Dictionary
-    include StandardObject
-
-    field   :Type,          :Type => Name, :Default => :"3DCrossSection"
-    field   :C,             :Type => Array, :Default => [ 0, 0, 0 ]
-    field   :O,             :Type => Array, :Version => "1.7", :Default => [ Null.new, 0, 0 ], :Required => true
-    field   :PO,            :Type => Number, :Default => 0.5
-    field   :PC,            :Type => Array, :Default => [ Graphics::Color::Space::DEVICE_RGB, 1, 1, 1 ]
-    field   :IV,            :Type => Boolean, :Default => false
-    field   :IC,            :Type => Array, :Default => [ Graphics::Color::Space::DEVICE_RGB, 0, 1 ,0]
-  end
-
-  class Node3D < Dictionary
-    include StandardObject
-
-    field   :Type,          :Type => Name, :Default => :"3DNode"
-    field   :N,             :Type => ByteString, :Version => "1.7", :Required => true
-    field   :O,             :Type => Number
-    field   :V,             :Type => Boolean
-    field   :M,             :Type => Array
-  end
+        field   :Subtype,       :Type => Name, :Default => ORTHOGRAPHIC
+        field   :CS,            :Type => Name, :Default => ClippingStyles::AUTOMATIC_NEARFAR
+        field   :F,             :Type => Number
+        field   :N,             :Type => Number
+        field   :FOV,           :Type => Number
+        field   :PS,            :Type => [ Number, Name ], :Default => Scaling::WIDTH
+        field   :OS,            :Type => Number, :Default => 1
+        field   :OB,            :Type => Name, :Version => "1.7", :Default => Scaling::ABSOLUTE
+    end
+
+    class Background3D < Dictionary
+        include StandardObject
+
+        field   :Type,          :Type => Name, :Default => :"3DBG"
+        field   :Subtype,       :Type => Name, :Default => :SC
+        field   :CS,            :Type => [ Name, Array ], :Default => Graphics::Color::Space::DEVICE_RGB
+        field   :C,             :Type => Object, :Default => [ 1, 1, 1 ]
+        field   :EA,            :Type => Boolean, :Default => false
+    end
+
+    class RenderMode3D < Dictionary
+        include StandardObject
+
+        module Modes
+            SOLID                           = :Solid
+            SOLID_WIREFRAME                 = :SolidWireFrame
+            TRANSPARENT                     = :Transparent
+            TRANSPARENT_WIREFRAME           = :TransparentWireFrame
+            BOUNDINGBOX                     = :BoundingBox
+            TRANSPARENT_BOUNDINGBOX         = :TransparentBoundingBox
+            TRANSPARENT_BOUNDINGBOX_OUTLINE = :TransparentBoundingBoxOutline
+            WIREFRAME                       = :WireFrame
+            SHADED_WIREFRAME                = :ShadedWireFrame
+            HIDDEN_WIREFRAME                = :HiddenWireFrame
+            VERTICES                        = :Vertices
+            SHADED_VERTICES                 = :ShadedVertices
+            ILLUSTRATION                    = :Illustration
+            SOLID_OUTLINE                   = :SolidOutline
+            SHADED_ILLUSTRATION             = :ShadedIllustration
+        end
+
+        field   :Type,          :Type => Name, :Default => :"3DRenderMode"
+        field   :Subtype,       :Type => Name, :Required => true, :Version => "1.7"
+        field   :AC,            :Type => Array, :Default => [ Graphics::Color::Space::DEVICE_RGB, 0, 0, 0]
+        field   :BG,            :Type => [ Name, Array ], :Default => :BG
+        field   :O,             :Type => Number, :Default => 0.5
+        field   :CV,            :Type => Number, :Default => 45
+    end
+
+    class LightingScheme3D < Dictionary
+        include StandardObject
+
+        module Styles
+            ARTWORK                         = :Artwork
+            NONE                            = :None
+            WHITE                           = :White
+            DAY                             = :Day
+            NIGHT                           = :Night
+            HARD                            = :Hard
+            PRIMARY                         = :Primary
+            BLUE                            = :Blue
+            RED                             = :Red
+            CUBE                            = :Cube
+            CAD                             = :CAD
+            HEADLAMP                        = :HeadLamp
+        end
+
+        field   :Type,          :Type => Name, :Default => :"3DLightingScheme"
+        field   :Subtype,       :Type => Name, :Version => "1.7", :Required => true
+    end
+
+    class CrossSection3D < Dictionary
+        include StandardObject
+
+        field   :Type,          :Type => Name, :Default => :"3DCrossSection"
+        field   :C,             :Type => Array, :Default => [ 0, 0, 0 ]
+        field   :O,             :Type => Array, :Version => "1.7", :Default => [ Null.new, 0, 0 ], :Required => true
+        field   :PO,            :Type => Number, :Default => 0.5
+        field   :PC,            :Type => Array, :Default => [ Graphics::Color::Space::DEVICE_RGB, 1, 1, 1 ]
+        field   :IV,            :Type => Boolean, :Default => false
+        field   :IC,            :Type => Array, :Default => [ Graphics::Color::Space::DEVICE_RGB, 0, 1 ,0]
+    end
+
+    class Node3D < Dictionary
+        include StandardObject
+
+        field   :Type,          :Type => Name, :Default => :"3DNode"
+        field   :N,             :Type => String, :Version => "1.7", :Required => true
+        field   :O,             :Type => Number
+        field   :V,             :Type => Boolean
+        field   :M,             :Type => Array
+    end
+
+    class Measurement3D < Dictionary
+        include StandardObject
+
+        field   :Type,          :Type => Name, :Default => :"3DMeasure"
+        field   :Subtype,       :Type => Name, :Required => true
+        field   :TRL,           :Type => String
+    end
+
+    class LinearDimensionMeasurement3D < Measurement3D
+        field   :Subtype,       :Type => Name, :Default => :L3D, :Required => true
+        field   :AP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :A1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N1,            :Type => String
+        field   :A2,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N2,            :Type => String
+        field   :TP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TY,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TS,            :Type => Number
+        field   :C,             :Type => Array.of(Number, length: 3)
+        field   :V,             :Type => Number, :Required => true
+        field   :U,             :Type => String, :Required => true
+        field   :P,             :Type => Integer, :Default => 3
+        field   :UT,            :Type => String
+        field   :S,             :Type => Annotation::Projection
+    end
+
+    class PerpendicularDimensionMeasurement3D < Measurement3D
+        field   :Subtype,       :Type => Name, :Default => :PD3, :Required => true
+        field   :AP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :A1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N1,            :Type => String
+        field   :A2,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N2,            :Type => String
+        field   :D1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TY,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TS,            :Type => Number
+        field   :C,             :Type => Array.of(Number, length: 3)
+        field   :V,             :Type => Number, :Required => true
+        field   :U,             :Type => String, :Required => true
+        field   :P,             :Type => Integer, :Default => 3
+        field   :UT,            :Type => String
+        field   :S,             :Type => Annotation::Projection
+    end
+
+    class AngularDimensionMeasurement3D < Measurement3D
+        field   :Subtype,       :Type => Name, :Default => :AD3, :Required => true
+        field   :AP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :A1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :D1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N1,            :Type => String
+        field   :A2,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :D2,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N2,            :Type => String
+        field   :TP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TX,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TY,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TS,            :Type => Number
+        field   :C,             :Type => Array.of(Number, length: 3)
+        field   :V,             :Type => Number, :Required => true
+        field   :P,             :Type => Integer, :Default => 3
+        field   :UT,            :Type => String
+        field   :DR,            :Type => Boolean, :Default => true
+        field   :S,             :Type => Annotation::Projection
+    end
+
+    class RadialMeasurement3D < Measurement3D
+        field   :Subtype,       :Type => Name, :Default => :RD3, :Required => true
+        field   :AP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :A1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :A2,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N2,            :Type => String
+        field   :A3,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :A4,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TX,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TY,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :EL,            :Type => Number, :Default => 60 
+        field   :TS,            :Type => Number
+        field   :C,             :Type => Array.of(Number, length: 3)
+        field   :V,             :Type => Number, :Required => true
+        field   :U,             :Type => String, :Required => true
+        field   :P,             :Type => Integer, :Default => 3
+        field   :UT,            :Type => String
+        field   :SC,            :Type => Boolean, :Default => false
+        field   :R,             :Type => Boolean, :Default => true
+        field   :S,             :Type => Annotation::Projection
+    end
+
+    class CommentNote3D < Measurement3D
+        field   :Subtype,       :Type => Name, :Default => :"3DC", :Required => true
+        field   :A1,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :N1,            :Type => String
+        field   :TP,            :Type => Array.of(Number, length: 3), :Required => true
+        field   :TB,            :Type => Array.of(Integer, length: 2)
+        field   :TS,            :Type => Number
+        field   :C,             :Type => Array.of(Number, length: 3)
+        field   :UT,            :Type => String
+        field   :S,             :Type => Annotation::Projection
+    end
+
+    class View3D < Dictionary
+        include StandardObject
+
+        field   :Type,          :Type => Name, :Default => :"3DView"
+        field   :XN,            :Type => String, :Required => true
+        field   :IN,            :Type => String
+        field   :MS,            :Type => Name
+        field   :C2W,           :Type => Array
+        field   :U3DPath,       :Type => [ String, Array.of(String) ]
+        field   :CO,            :Type => Number
+        field   :P,             :Type => Projection3D
+        field   :O,             :Type => Graphics::FormXObject
+        field   :BG,            :Type => Background3D
+        field   :RM,            :Type => RenderMode3D, :Version => "1.7"
+        field   :LS,            :Type => LightingScheme3D, :Version => "1.7"
+        field   :SA,            :Type => Array.of(CrossSection3D), :Version => "1.7"
+        field   :NA,            :Type => Array.of(Node3D), :Version => "1.7"
+        field   :NR,            :Type => Boolean, :Version => "1.7", :Default => false
+    end
+
+    class AnimationStyle3D < Dictionary
+        include StandardObject
+
+        module Styles
+            NONE                = :None
+            LINEAR              = :Linear
+            OSCILLATING         = :Oscillating
+        end
+
+        field   :Type,          :Type => Name, :Default => :"3DAnimationStyle"
+        field   :Subtype,       :Type => Name, :Default => Styles::NONE
+        field   :PC,            :Type => Integer, :Default => 0
+        field   :TM,            :Type => Number, :Default => 1
+    end
+
+    class U3DStream < Stream
+        include StandardObject
+
+        module Type
+            U3D = :U3D
+            PRC = :PRC
+        end
+
+        field   :Type,          :Type => Name, :Default => :"3D"
+        field   :Subtype,       :Type => Name, :Default => Type::U3D, :Required => true, :Version => "1.7", :ExtensionLevel => 3
+        field   :VA,            :Type => Array.of(View3D)
+        field   :DV,            :Type => Object
+        field   :Resources,     :Type => Dictionary
+        field   :OnInstantiate, :Type => Stream
+        field   :AN,            :Type => AnimationStyle3D
+
+        def onInstantiate(action)
+            self[:OnInstantiate] = action
+        end
+    end
+
+    class Reference3D < Dictionary
+        include StandardObject
+
+        field   :Type,          :Type => Name, :Default => :"3DRef"
+        field   :"3DD",         :Type => U3DStream
+    end
+
+    class Units3D < Dictionary
+        include StandardObject
+
+        field   :TSm,           :Type => Number, :Default => 1.0
+        field   :TSn,           :Type => Number, :Default => 1.0
+        field   :TU,            :Type => String
+        field   :USm,           :Type => Number, :Default => 1.0
+        field   :USn,           :Type => Number, :Default => 1.0
+        field   :UU,            :Type => String
+        field   :DSm,           :Type => Number, :Default => 1.0
+        field   :DSn,           :Type => Number, :Default => 1.0
+        field   :DU,            :Type => String
+    end
+
+    class Annotation
+
+        #
+        # 3D Artwork annotation.
+        #
+        class Artwork3D < Annotation
+
+            class Activation < Dictionary
+                include StandardObject
+
+                module Events
+                    PAGE_OPEN       = :PO
+                    PAGE_CLOSE      = :PC
+                    PAGE_VISIBLE    = :PV
+                    PAGE_INVISIBLE  = :PI
+                    USER_ACTIVATE   = :XA
+                    USER_DEACTIVATE = :XD
+                end
+
+                module State
+                    UNINSTANCIATED  = :U
+                    INSTANCIATED    = :I
+                    LIVE            = :L
+                end
+                
+                module Style
+                    EMBEDDED        = :Embedded
+                    WINDOWED        = :Windowed
+                end
+
+                field   :A,             :Type => Name, :Default => Events::USER_ACTIVATE
+                field   :AIS,           :Type => Name, :Default => State::LIVE
+                field   :D,             :Type => Name, :Default => Events::PAGE_INVISIBLE
+                field   :DIS,           :Type => Name, :Default => State::UNINSTANCIATED
+                field   :TB,            :Type => Boolean, :Version => "1.7", :Default => true
+                field   :NP,            :Type => Boolean, :Version => "1.7", :Default => false
+                field   :Style,         :Type => Name, :Version => "1.7", :ExtensionLevel => 3, :Default => Style::EMBEDDED
+                field   :Window,        :Type => RichMedia::Window, :Version => "1.7", :ExtensionLevel => 3
+                field   :Transparent,   :Type => Boolean, :Version => "1.7", :ExtensionLevel => 3, :Default => false
+            end
+
+            field   :Subtype,     :Type => Name, :Default => :"3D", :Version => "1.6", :Required => true
+            field   :"3DD",       :Type => [ Reference3D, U3DStream ], :Required => true
+            field   :"3DV",       :Type => Object
+            field   :"3DA",       :Type => Activation
+            field   :"3DI",       :Type => Boolean, :Default => true
+            field   :"3DB",       :Type => Rectangle
+            field   :"3DU",       :Type => Units3D, :Version => "1.7", :ExtensionLevel => 3
+        end
+    end
+
 end