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

From Jmol
Jump to navigation Jump to search
(for splitting the contents of File formats page)
 
(fill content brought and merged from File Formats and 3D Objects pages; some updates too)
Line 1: Line 1:
for splitting the contents of [[File formats]] page
+
{{File_Formats}}
--to be done
+
= File Formats for 3D Objects Exported from Jmol =
 +
 
 +
Recent versions of Jmol application and signed applet can export models to several formats that specify three-dimensional objects and can be read by specialized software, either raytracing or 3D-world.
 +
 
 +
== POV-Ray ==
 +
Jmol can export, with limited features, the current view of a model into POV-Ray format. This can be done from script or from the pop-up menu, but is better controled using the top menu in the Jmol application, which opens a dialog with options. See [[File_formats/Images#Saving_images_from_Jmol_application | File formats/Images]] for more details.
 +
 
 +
 
 +
== VRML ==
 +
Jmol can export, with limited features, the model into Virtual Reality Modeling Language, [http://en.wikipedia.org/wiki/VRML VRML].
 +
This can be done from script or from the pop-up menu.
 +
 
 +
''This feature is partially implemented and subject to further development.''
 +
* Jmol exports atoms (as spheres), bonds (as cylinders) and isosurfaces (as IndexedFaceSets, single color). Translucency is supported.
 +
* The atom size and color, bond thickness and color, are preserved. The orientation and zoom are not always kept.
 +
* Labels, 3D-positioned echo texts and measurement texts are partially supported:
 +
** text, color, font family and font style supported
 +
** font size and offset are fixed
 +
** multi-line not supported (only 1st line is displayed)
 +
** alignment not supported (always left)
 +
* Other features (dots, cartoons...) are not supported.
 +
 
 +
The {{file|vrml file}} can then be opened using several programs and browser plugins, and manipulated in 3D using the mouse.
 +
: Depending on your VRML viewer or plug-in, you may need to rename the file to a {{file|.wrl}} extension.
 +
 
 +
=== References ===
 +
* [http://accad.osu.edu/~pgerstma/class/vnv/resources/info/AnnotatedVrmlRef/Book.html The Annotated VRML 97 Reference], by Rikk Carey and Gavin Bell. Online documentation for the VRML format, including examples.
 +
 
 +
 
 +
== Maya ==
 +
Jmol can export, with limited features, the current view of a model into [http://usa.autodesk.com/adsk/servlet/index?id=7635018&siteID=123112 Maya] format. This can be done from script or from the pop-up menu.
 +
[http://en.wikipedia.org/wiki/Maya_(software) Wikipedia info on Maya]
 +
 
 +
 
 +
== OBJ ==
 +
Jmol (starting v. 11.7.28) can read files in the <code>obj</code> file format. This format is generated by [[wikipedia:Wavefront_Technologies|Wavefront]], [https://java3d.dev.java.net/ Java3D] and [http://pymol.sourceforge.net PyMOL]. The described objects are handled as isosurfaces in Jmol, so they can  be saved in more compact [[File_formats#JVXL_.28Jmol_Voxel.29 | JVXL format]], if desired, and also can be mapped with other data.
 +
 
 +
* Description of [http://www.eg-models.de/formats/Format_Obj.html <code>obj</code> file format] at ''EG-Models.de'', an archive of electronic geometry models.
 +
* Description of <code>obj</code> file format at ''FileFormat.info'': <nowiki>www.fileformat.info/format/wavefrontobj/egff.htm</nowiki>
 +
* Description of [http://www.martinreddy.net/gfx/3d/OBJ.spec <code>obj</code> file format] at ''The Graphics File Formats Page'' by Martin Reddy.
 +
* Export of [http://www.pymolwiki.org/index.php/Surface#Exporting_Surface.2FMesh_Coordinates_to_File <code>obj</code> file format] from PyMOL (molecular surfaces).
 +
 
 +
 
 +
== X3D ==
 +
Extensible 3D Graphics. This is the successor of VRML.
 +
 
 +
'''Not yet supported by Jmol'''.
 +
 
 +
=== References ===
 +
* [http://x3dgraphics.com/examples/X3dForWebAuthors/ X3D for Web Authors], by Don Brutzman and Leonard Daly. Examples.
 +
 
 +
 
 +
== U3D ==
 +
Universal 3D format. ECMA-363 Standard.
 +
 
 +
'''Not yet supported by Jmol'''.
 +
 
 +
The most interesting feature of this format is that it can be embedded in pdf files, providing a 3D experience inside this well established standard for publication.
 +
 
 +
=== References ===
 +
* [http://sourceforge.net/projects/u3d Universal 3D Sample Software] project at SourceForge.
 +
: A set of libraries to write, read, extend, render and interact with U3D-formatted data, as defined by standard ECMA-363. Intended as starting point for tools and applications to support U3D (exporters, importers, authoring packages and interactive viewers).
 +
* [http://meshlab.sourceforge.net/ MeshLab] project at SourceForge.
 +
: MeshLab is the first open source tool to provide direct conversion of 3D meshes into the U3D format. Now you can create pdf with 3D objects with just MeshLab and LaTeX.

Revision as of 12:48, 25 April 2009

File Formats

File Formats for 3D Objects Exported from Jmol

Recent versions of Jmol application and signed applet can export models to several formats that specify three-dimensional objects and can be read by specialized software, either raytracing or 3D-world.

POV-Ray

Jmol can export, with limited features, the current view of a model into POV-Ray format. This can be done from script or from the pop-up menu, but is better controled using the top menu in the Jmol application, which opens a dialog with options. See File formats/Images for more details.


VRML

Jmol can export, with limited features, the model into Virtual Reality Modeling Language, VRML. This can be done from script or from the pop-up menu.

This feature is partially implemented and subject to further development.

  • Jmol exports atoms (as spheres), bonds (as cylinders) and isosurfaces (as IndexedFaceSets, single color). Translucency is supported.
  • The atom size and color, bond thickness and color, are preserved. The orientation and zoom are not always kept.
  • Labels, 3D-positioned echo texts and measurement texts are partially supported:
    • text, color, font family and font style supported
    • font size and offset are fixed
    • multi-line not supported (only 1st line is displayed)
    • alignment not supported (always left)
  • Other features (dots, cartoons...) are not supported.

The File icon.gifvrml file can then be opened using several programs and browser plugins, and manipulated in 3D using the mouse.

Depending on your VRML viewer or plug-in, you may need to rename the file to a File icon.gif.wrl extension.

References


Maya

Jmol can export, with limited features, the current view of a model into Maya format. This can be done from script or from the pop-up menu. Wikipedia info on Maya


OBJ

Jmol (starting v. 11.7.28) can read files in the obj file format. This format is generated by Wavefront, Java3D and PyMOL. The described objects are handled as isosurfaces in Jmol, so they can be saved in more compact JVXL format, if desired, and also can be mapped with other data.

  • Description of obj file format at EG-Models.de, an archive of electronic geometry models.
  • Description of obj file format at FileFormat.info: www.fileformat.info/format/wavefrontobj/egff.htm
  • Description of obj file format at The Graphics File Formats Page by Martin Reddy.
  • Export of obj file format from PyMOL (molecular surfaces).


X3D

Extensible 3D Graphics. This is the successor of VRML.

Not yet supported by Jmol.

References


U3D

Universal 3D format. ECMA-363 Standard.

Not yet supported by Jmol.

The most interesting feature of this format is that it can be embedded in pdf files, providing a 3D experience inside this well established standard for publication.

References

A set of libraries to write, read, extend, render and interact with U3D-formatted data, as defined by standard ECMA-363. Intended as starting point for tools and applications to support U3D (exporters, importers, authoring packages and interactive viewers).
MeshLab is the first open source tool to provide direct conversion of 3D meshes into the U3D format. Now you can create pdf with 3D objects with just MeshLab and LaTeX.