Downloads:

Acrobat 7.x Version:

Attach3DResource.api (Windows only)

 
Acrobat 8.x Version:

Attach3DResource.api (Windows only)

 
Legal Disclaimer:

Use this software at your own risk. The author disavows any responsibility for any damage resulting from use of this software for any purpose whatsoever. This application is provided as-is for demonstrative purposes only. Moreover, if you agree to use this application to create content and offer for sale any device or system, you alone are responsible for ensuring that no patents, copyrights, or other applicable rights are being violated thereby. Download of this software constitutes acceptance of these terms.

 

---

 
Installation:

1. Download the appropriate plug-in for your version of Acrobat
2. Make sure Acrobat is not running
3. Copy "Attach3DResource.api" to the Acrobat "plug_ins" folder.
   

   Default location of plug-ins folder for Acrobat 7.x:

   C:\Program Files\Adobe\Acrobat 7.0\Acrobat\plug_ins\

   Default location of plug-ins folder for Acrobat 8.x:

   C:\Program Files\Adobe\Acrobat 8.0\Acrobat\plug_ins\

 

---

 
Usage:

1. Launch Acrobat
2. Open a file containing a 3D annotation
3. Select the "3D Tool" (Menu item: Tools > Advanced > 3D Tool)
4. Select the 3D annotation you want to attach a resource to by clicking it once
5. Select the menu item: Advanced > 3D > Attach Resource to 3D Annotation
6. Choose the 3D model file (.U3D format) or Image file (.PNG, .JPEG, .BMP, etc.) you want to add as a resource
7. Click OK

 

---

 
Known Issues:

• Images with ICC Profiles don't work, make sure if you are saving JPEGs in Photoshop, to uncheck the box.
   
  

 

---

 
Sample:

Download the sample files [here] and unzip the contents.
 

1. Open "blank.pdf".
    
   

   
    
   

2. Select the 3D Tool (Menu item: Tools > Advanced > 3D Tool).
    
   

   
    
   

3. Drag a rectangle on the page where you want the annotation to be.
    
   

   
    
   

4. Click the "Browse" button to select the 3D model.
    
   

   
    
   

5. Pick "blank.u3d" and click the "Open" button.
    
   

   
    
   

6. Click the "Browse" button to select the default script.
    
   

   
    
   

7. Pick "script.js" and click the "Open" button.
    
   

   
    
   

8. Click the "OK" button.
    
   

   
    
   

9. Note that the 3D annotation is selected (indicated by its red border). The 3D annotation must be selected like this to add resources.
    
   

   
    
   

10. Select the menu item: Advanced > 3D > Attach Resource to 3D Annotation.
     
    

    
     
    

11. (While holiding down the Ctrl key) multi-select the files "grid.jpg", "knurl.jpg", and "sphere.u3d" then click the "Open" button.
     
    

    
     
    

12. Select the Hand Tool from the toolbar or Tools > Select & Zoom > Hand Tool.
     
    

    
     
    

13. Click on the 3D annotation to activate it.
     
    

    
     
    

 

---

 
Script:

Here's the sample file "script.js" provided:

// Create a new Resource with the file's URI as the argument
modelResource = new Resource( "pdf://sphere.u3d" );

// use Scene method "addModel" with Resource as an argument,
// returns top level node from loaded 3D file
model = scene.addModel( modelResource );



// Create a new Resource with the file's URI as the argument
imageResource = new Resource( "pdf://grid.jpg" );

// use the Image constructor with the Resource as an argument,
image = new Image( imageResource );

// set the loaded 3D model's diffuse texture to the image
model.material.diffuseTexture.setImage( image );



// loading of resources can be inlined if they are only used once
bump = new Image( new Resource( "pdf://knurl.jpg" ) );

// set the loaded 3D model's bump texture to the image
model.material.bumpTexture.setImage( bump );