File formats/3D PDF

PDF documents with integrated 3D interactive models

Installations

Jmol

You need at least version 12.0.RC26 to do this.

IDTF to U3D

(See also descriptions and comments for Jmol output to IDTF and U3D formats.)

• Windows installation of IDTFConverter

1. Download and unzip http://www.iaas.msu.ru/tmp/u3d/u3dIntelWin.zip into, perhaps, c:\idtf\
2. Create a simple command file u3d.bat and place it in a folder where it is easily accessible (e.g. the Windows directory or a folder included in the system's path). This u3d.bat file must contain this text:

c:\idtf\idtfconverter.exe -input %1.idtf -output %1.u3d

• MacOS and Linux installation of IDTFConverter

1. See IDTF for instructions on getting the converter.
2. Create a command file similarly to the one described for Windows.

LaTeX to PDF

There are several pdfLatex software, like teTeX (Unix; discontinued in 2006), MiKTeX (Windows), TeX Live (Unix, Linux, Windows)...

• Installation of MiKTeX (Windows)

1. Download and install MiKTeX "basic" from http://miktex.org/
2. Do an update (menu Programs > MiKTeX > Maintenance > Update)
3. Download the movie15 package (menu Programs > MikTex > Maintenance > Package Manager)

Creating the document

1. Within Jmol script console: write c:/temp/xxx.idtf

or from the application's pop-up menu: File > Export IDTF 3D model (a dialog prompts for destination folder and filename).

Either of those will create two files: xxx.idtf and xxx.idtf.tex

2. At the system command line or terminal, call the u3d.bat file (Windows), or equivalent MacOS or Linux command file, to convert the .idtf to .u3d format:

u3d c:\temp\xxx

3. Run the TeXworks program --included in MiKTeX-- and open in it your xxx.idtf.tex.

4. Click menu item Typeset > Typeset, or click on the green 'play'-like button (leftmost in the toolbar).

When processing ends, you will see a blank document in a new TeXworks window, because MiKTeX can't display the model, but xxx.idtf.pdf should have been created.

5. Open the .pdf file using Adobe Reader v. 7 or later.

If you don't see the model in its panel inside the document, right-click on it and choose Partial options > Fit visible

Contributors

AngelHerraez, Vdlee