Difference between revisions of "Jmol JavaScript Object"
AngelHerraez (talk | contribs) (first tips - which files are needed) |
(→Installation) |
||
| Line 3: | Line 3: | ||
==Installation== | ==Installation== | ||
| − | These files must be | + | These files must be accessible to the html page. Note that [[Troubleshooting/Applet#Java_security_errors|Java scurity policy]] imposes limitations on the folder location of files. The JavaScript files should be in the following order: |
| − | * {{file|JmolApplet0*.jar}} or {{file|JmolAppletSigned0*.jar}} | + | * {{file|JmolApplet.jar}} or {{file|JmolAppletSigned.jar}} or {{file|JmolApplet0*.jar}} or {{file|JmolAppletSigned0*.jar}} |
: (That is a set of files, where the * stands for several suffixes. You may need to read about [[Jmol_Applet#Unsigned_vs._Signed_Applet_.26_Data_Access|signed vs. unsigned applet]].) | : (That is a set of files, where the * stands for several suffixes. You may need to read about [[Jmol_Applet#Unsigned_vs._Signed_Applet_.26_Data_Access|signed vs. unsigned applet]].) | ||
| − | * {{file|JmolCore.js}} | + | * {{file|JmolCore.js}} (required) |
| − | * {{file|JmolApplet.js}} | + | * {{file|JmolApplet.js}} (required) |
| − | * {{file| | + | * {{file|JmolControls.js}} (optional -- required if any buttons or links or other input methods will be used) |
| − | * {{file| | + | * {{file|JmolApi.js}} (required) |
| − | |||
==Initialization== | ==Initialization== | ||
Revision as of 21:25, 12 August 2012
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.
Contents
Installation
These files must be accessible to the html page. Note that Java scurity policy imposes limitations on the folder location of files. The JavaScript files should be in the following order:
JmolApplet.jar or JmolAppletSigned.jar or JmolApplet0*.jar or JmolAppletSigned0*.jar
- (That is a set of files, where the * stands for several suffixes. You may need to read about signed vs. unsigned applet.)
- JmolCore.js (required)
- JmolApplet.js (required)
- JmolControls.js (optional -- required if any buttons or links or other input methods will be used)
- JmolApi.js (required)
Initialization
Basic
The html page must reference (usually with a script tag in the head section) the javascript libraries:
- JmolCore.js essential
- JmolApplet.js essential, must go after JmolCore
- JmolApi.js essential, must go after JmolCore
- JmolControls.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:
- jQuery.min.js required; unrelated to Jmol and not included in Jmol distribution. The jQuery JavaScript Library.
- gl-matrix-min.js required; not included in Jmol distribution. Javascript Matrix and Vector library for High Performance WebGL apps.
- mousewheel.js required; not included in Jmol distribution. jQuery Mouse Wheel Plugin.
- ChemDoodleWeb.js required; from ChemDoodle Web Components; must go after the above three.
- JmolCD.js required; must go after JmolApplet and all those above.
Using the GLmol alternative
The html page must reference these additional javascript libraries:
- jQuery.min.js required; unrelated to Jmol and not included in Jmol distribution. The jQuery JavaScript Library.
- Three49custom.js required; not included in Jmol distribution; available with GLmol, below.
- GLmol.js required; from GLmol - Molecular Viewer on WebGL/Javascript; must go after the above two.
- JmolGlmol.js required; must go after JmolApplet and all those above.
Initialization parameters
API
Contributors
AngelHerraez, Hansonr, Hansonrstolaf, Cudo29, Ceroni, Ppillot
