View source for Jmol JavaScript Object/Info

= Documentation of parameters of the Info variable =

Detailed explanation of the parameters of the <code>Info</code> variable, an essential part of the [[Jmol JavaScript Object]].

* '''Info.addSelectionOptions''' Set this value to <code>true</code> if you want to display, below the applet, a menu with options for loading structures from public databases.
* '''Info.color'''  The background color of the applet, in any JmolScript-supported format: color name, decimal triplet <code>[r,g,b]</code> or hexadecimal <code>[xRRGGBB]</code>. Note that default is white (it is black in the classic Jmol.js method).
* '''Info.debug'''  Set this value to <code>true</code> if you are having problems getting your page to show the applet or buttons.
* '''Info.defaultModel''' A model to be retrieved from a public database and displayed when the applet is loaded.
* '''Info.height'''  The size of the applet (or surrogate) in pixels or expressed as percent of its container height as a string in quotes: "100%". Note that for a percent to work, '''''all''''' surrounding HTML elements (including <code>body</code> and <code>html</code>) must explicitly implement the CSS attribute <code>style=height:...</code>.
* '''Info.isSigned'''  Make sure to change this to <code>true</code> if the file indicated for '''Info.jarFile''' is the signed applet.
* '''Info.jarFile'''  The file used, usually either <code>JmolApplet0.jar</code> (for faster incremental loading) or <code>JmolApplet.jar</code> (a single 2.5+ MB download), or the signed versions <code>JmolAppletSigned0.jar</code> and <code>JmolAppletSigned.jar</code>.
* '''Info.jarPath'''  The path to the applet files. Note that if the unsigned applet is used and the page is tested locally, then all model files must be in or under the folder indicated by this value, to satisfy Java security policy.
* '''Info.memoryLimit''' The maximum amount of memory allowed for the applet, in MB.
* '''Info.readyFunction''' The name of a JavaScript function to call when the applet has been created and is ready to receive commands (and also called when the applet is destroyed e.g. when the page is closed).
*: For example, with <code>Info.readyFunction: jmolIsReady</code> any of the following JavaScript function definitions could be used:
*: <code>jmolIsReady = function(theJmol) { document.title = theJmol._id + " is ready"; }</code>
*: <code>jmolIsReady = function() { alert('Welcome to Jmol!'); }</code>
*: <code>function jmolIsReady() { alert('Welcome to Jmol!'); }</code>
* '''Info.script''' A script to run when the applet has loaded. Note that indicating a script here is not necessary; with Jmol-JSO, unlike with Jmol.js, you can start making script calls to the applet as soon as the applet wrapper object has been created in JavaScript; there is no need to wait for Java applet initialization to have completed. 
* '''Info.serverURL''' The URL of the server to be used for getting file data into non-JmolApplet options. This can be left as "http://chemapps.stolaf.edu/jmol/jmolcd.php", since that is a public site accessible to cross-domain AJAX calls, but it can perhaps better be installed on the user's host for better performance.
* '''Info.src''' Same as '''Info.script''', only included because it is the syntax commonly used for images.
* '''Info.use''' This string determines the various options to be tried (applet and surrogates) and the order in which to try them.
** The default setting of <code> Java noWebGL noHTML5 noImage </code> is the same as just <code> Java </code> by itself and indicates to just use Java (and display a message if Java is not enabled).
** A value of <code> Java Image </code> would allow PNGJ files to be displayed as images or simple file loading to be delivered as an image from a server if Java is not available.
** The value <code> Java HTML5 </code> would test for Java and then, if that is not available, use GLmol or HTML5-only ChemDoodle or JSmol (whichever is made available). 
** The value <code> Java WebGL HTML5 Image </code> allows at least some model on all standard platforms. 
: Note that Jmol-JSO cannot detect if the user has intentionally disabled Java in Microsoft Internet Explorer. Thus, MSIE users intentionally disabling Java will only have the Java option, and a message will be displayed that Java is not available.
* '''Info.width'''  The width of the applet in pixels or expressed as percent of its container width as a string in quotes: "100%". Note that for a percent to work, '''''all''''' surrounding HTML elements must explicitly implement the CSS attribute <code>style=width:...</code>.

In addition to these keys are a set of parameters that using Jmol.js could be set using the <code>jmolSetParameter()</code> or <code>jmolSetCallback()</code> functions. These are discussed in sets:

* '''Info.animframecallback'''
* '''Info.appletreadycallback'''
* '''Info.atommovedcallback'''
* '''Info.echocallback'''
* '''Info.evalcallback'''
* '''Info.hovercallback'''
* '''Info.loadstructcallback'''
* '''Info.messagecallback'''
* '''Info.pickcallback'''
* '''Info.measurecallback'''
* '''Info.minimizationcallback'''
* '''Info.resizecallback'''
* '''Info.scriptcallback'''
* '''Info.synccallback'''

These callbacks allow the page designer to get information about what is happening within the applet. The name of a JavaScript function, in single- or double-quotes should be given here if desired. Do not use <code>function() {....}</code> syntax.

* '''Info.language''' 
This setting can be used to specify a language to be used in the JmolApplet interface (primarily for testing; the default language used in the applet is automatically detected from the system settings of the user's browser).

* '''Info.usecommandthread'''
The signed Jmol applet generally runs commands by passing them to a command thread that is established when the applet is created, while the unsigned applet does not. You can change this behavior if you are observing Java security issues. Otherwise, it should not be adjusted.

* '''Info.boxbgcolor'''
* '''Info.boxfgcolor'''
* '''Info.boxmessage'''
* '''Info.progressbar'''
* '''Info.progresscolor'''
These five values generally should not be adjusted.