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

From Jmol
Jump to navigation Jump to search
(compiling instructions for making a PDF with 3D model from Jmol)
 
(more content)
Line 8: Line 8:
 
* Installation of MiKTeX (Windows)
 
* Installation of MiKTeX (Windows)
 
# Download and install Miktex "basic" from http://miktex.org/
 
# Download and install Miktex "basic" from http://miktex.org/
# Do an update [Start...Programs...MikTex...Maintenance]
+
# Do an update (<code>Start > Programs > MiKTeX > Maintenance</code>)
# Open the download manager and download the movie15 package [Start...Programs...MikTex...Maintenance]
+
# Open the download manager and download the movie15 package (<code>Start > Programs > MikTex > Maintenance</code>)
  
 
=== IDTF to U3D ===
 
=== IDTF to U3D ===
 
(See also descriptions and comments for [[File_formats/3D_Objects#IDTF|IDTF]] and [[File_formats/3D_Objects#U3D|U3D]] formats regarding Jmol.)
 
(See also descriptions and comments for [[File_formats/3D_Objects#IDTF|IDTF]] and [[File_formats/3D_Objects#U3D|U3D]] formats regarding Jmol.)
  
* Installation of IDTFConverter (Windows)
+
* ''Windows'' installation of IDTFConverter
# Download and unzip http://www.iaas.msu.ru/tmp/u3d/u3dIntelWin.zip into, perhaps, {{file|c:\idtf}}
+
# Download and unzip http://www.iaas.msu.ru/tmp/u3d/u3dIntelWin.zip into, perhaps, {{file|c:\idtf\}}
# Create a simple command file {{file|u3d.bat}} and place it in a folder where it is easily accesible (e.g. the Windows directory or a folder included in the system's path). This {{file|u3d.bat}} file must contain this text:
+
# Create a simple command file {{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 {{file|u3d.bat}} file must contain this text:
 
:: <code>c:\idtf\idtfconverter.exe -input %1.idtf -output %1.u3d</code>
 
:: <code>c:\idtf\idtfconverter.exe -input %1.idtf -output %1.u3d</code>
 +
 +
* ''MacOS and Linux'' installation of IDTFConverter
 +
# See [[File_formats/3D_Objects#IDTF|IDTF]] for instructions on getting the converter.
 +
# Create a command file similarly to the one described for Windows.
  
 
== Creating the document ==
 
== Creating the document ==
1. Within Jmol:  
+
1. Within Jmol script console:  
 
: <code>write c:/temp/xxx.idtf</code>
 
: <code>write c:/temp/xxx.idtf</code>
: That will create two files: {{file|xxx.idtf} and {{file|xxx.idtf.tex}}
+
: That will create two files: {{file|xxx.idtf}} and {{file|xxx.idtf.tex}}
  
2. Within Windows, call the {{file|u3d.bat}} 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>
  

Revision as of 15:29, 16 July 2010

PDF documents with integrated 3D interactive models

(This is a draft)

Installations

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)
  3. Open the download manager and download the movie15 package (Start > Programs > MikTex > Maintenance)

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.

Creating the document

1. Within Jmol script console:

write c:/temp/xxx.idtf
That 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 MikTeX program TeXworks and open your File icon.gifxxx.idtf.tex

4. Click menu item Typeset

You will see a blank document, because MikTex can't display the model, but File icon.gifdoc.pdf should have been created.

5. Open File icon.gifdoc.pdf using Adobe Reader v. 7 or later.

Contributors

AngelHerraez, Vdlee