Difference between revisions of "File formats/3D PDF"

From Jmol
Jump to navigation Jump to search
(more content)
Line 1: Line 1:
 
= PDF documents with integrated 3D interactive models =
 
= PDF documents with integrated 3D interactive models =
 
''(This is a draft)''
 
  
 
== Installations ==
 
== Installations ==
=== LaTeX to PDF ===
+
=== Jmol ===
There are several '''pdfLatex''' software, like teTex, MiKTeX...
+
You need at least version 12.0.RC26 to do this.
* Installation of MiKTeX (Windows)
 
# Download and install Miktex "basic" from http://miktex.org/
 
# Do an update (<code>Start > Programs > MiKTeX > Maintenance</code>)
 
# Open the download manager and download the movie15 package (<code>Start > Programs > MikTex > Maintenance</code>)
 
  
 
=== IDTF to U3D ===
 
=== IDTF to U3D ===
Line 22: Line 16:
 
# See [[File_formats/3D_Objects#IDTF|IDTF]] for instructions on getting the converter.
 
# See [[File_formats/3D_Objects#IDTF|IDTF]] for instructions on getting the converter.
 
# Create a command file similarly to the one described for Windows.
 
# Create a command file similarly to the one described for Windows.
 +
 +
=== LaTeX to PDF ===
 +
There are several '''pdfLatex''' software, like teTex, MiKTeX...
 +
* Installation of MiKTeX (Windows)
 +
# Download and install '''Miktex "basic"''' from http://miktex.org/
 +
# Do an update (<code>Start > Programs > MiKTeX > Maintenance > Update</code>)
 +
# Download the '''movie15''' package (<code>Start > Programs > MikTex > Maintenance > Package Manager</code>)
  
 
== Creating the document ==
 
== Creating the document ==
1. Within Jmol script console:
+
1. Within Jmol script console: <code>write c:/temp/xxx.idtf</code>
: <code>write c:/temp/xxx.idtf</code>
+
: or from the application's pop-up menu: <code>File > Export IDTF 3D model</code> (a dialog prompts for detination folder and filename).
: That will create two files: {{file|xxx.idtf}} and {{file|xxx.idtf.tex}}
+
: Either of those will create two files: {{file|xxx.idtf}} and {{file|xxx.idtf.tex}}
  
 
2. At the system command line or terminal, call the {{file|u3d.bat}} file (Windows), or equivalent MacOS or Linux command file, to convert the {{file|.idtf}} to {{file|.u3d}} format:
 
2. At the system command line or terminal, call the {{file|u3d.bat}} file (Windows), or equivalent MacOS or Linux command file, to convert the {{file|.idtf}} to {{file|.u3d}} format:
 
: <code>u3d c:\temp\xxx</code>
 
: <code>u3d c:\temp\xxx</code>
  
3. Run the MikTeX program TeXworks and open your {{file|xxx.idtf.tex}}
+
3. Run the '''TeXworks''' program included in MiKTeX and open your {{file|xxx.idtf.tex}} into TeXworks.
  
4. Click menu item Typeset
+
4. Click menu item <code>Typeset > Typeset</code>
: You will see a blank document, because MikTex can't display the model, but {{file|doc.pdf}} should have been created.
+
: When processing ends, you will see a blank document, because MiKTeX can't display the model, but {{file|xxx.idtf.pdf}} should have been created.
  
5. Open {{file|doc.pdf}} using Adobe Reader v. 7 or later.
+
5. Open the {{file|.pdf}} file using Adobe Reader v. 7 or later.
 +
: If you don't see the model in the panel inside the document, right-click on it and choose <code>Partial options > Fit visible</code>

Revision as of 16:00, 16 July 2010

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 IDTF and U3D formats regarding Jmol.)

  • Windows installation of IDTFConverter
  1. Download and unzip http://www.iaas.msu.ru/tmp/u3d/u3dIntelWin.zip into, perhaps, File icon.gifc:\idtf\
  2. Create a simple command file File icon.gifu3d.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 File icon.gifu3d.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, MiKTeX...

  • Installation of MiKTeX (Windows)
  1. Download and install Miktex "basic" from http://miktex.org/
  2. Do an update (Start > Programs > MiKTeX > Maintenance > Update)
  3. Download the movie15 package (Start > 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 detination folder and filename).
Either of those will create two files: File icon.gifxxx.idtf and File icon.gifxxx.idtf.tex

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

u3d c:\temp\xxx

3. Run the TeXworks program included in MiKTeX and open your File icon.gifxxx.idtf.tex into TeXworks.

4. Click menu item Typeset > Typeset

When processing ends, you will see a blank document, because MiKTeX can't display the model, but File icon.gifxxx.idtf.pdf should have been created.

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

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

Contributors

AngelHerraez, Vdlee