Jmol JavaScript Object

From Jmol
Revision as of 18:15, 22 July 2012 by AngelHerraez (talk | contribs) (first tips - which files are needed)
Jump to navigation Jump to search

Jmol Javascript Object is a set of javascript functions and utilities refactored and reorganized into a single javascript object. It supersedes the former Jmol.js javascript library as it allows for a cleaner, more efficient way to interact with the applet from javascript, and abstracts the view of a molecular model so that the applet could be seamlessly replaced by an image, or a third party visualization method depending on client's browser resources.

Installation

These files must be accesible to the html page (note that Java scurity policy imposes limitations on the folder location of files):

  • File icon.gifJmolApplet0*.jar or File icon.gifJmolAppletSigned0*.jar
(That is a set of files, where the * stands for several suffixes. You may need to read about signed vs. unsigned applet.)
  • File icon.gifJmolCore.js
  • File icon.gifJmolApplet.js
  • File icon.gifJmolApi.js
  • File icon.gifJmolControls.js


Initialization

Basic

The html page must reference (usually with a script tag in the head section) the javascript libraries:

  • File icon.gifJmolCore.js essential
  • File icon.gifJmolApplet.js essential, must go after JmolCore
  • File icon.gifJmolApi.js essential, must go after JmolCore
  • File icon.gifJmolControls.js optional, must go after JmolCore; only needed if you will insert user interface controls like buttons, links, menus, etc.

Using the ChemDoodle alternative

The html page must reference these additional javascript libraries:

Using the GLmol alternative

The html page must reference these additional javascript libraries:

  • File icon.gifjQuery.min.js required; unrelated to Jmol and not included in Jmol distribution. The jQuery JavaScript Library.
  • File icon.gifThree49custom.js required; not included in Jmol distribution; available with GLmol, below.
  • File icon.gifGLmol.js required; from GLmol - Molecular Viewer on WebGL/Javascript; must go after the above two.
  • File icon.gifJmolGlmol.js required; must go after JmolApplet and all those above.

Initialization parameters

API