Difference between revisions of "JSmol"

From Jmol
Jump to navigation Jump to search
(more details and link to download)
(link to PlatformSpeed)
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''JSmol''' is the tentative name for an alternative to Jmol applet that does not require Java but instead renders the molecular models in a webpage using just JavaScript and HTML5 features. This opens up the use of Jmol not only in PC's, Mac's and Linux's systems without Java installed, but also in tablets and phones (iOS, Android) that do not allow Java or applets. No hardware-based graphics acceleration is used either, and hence it should run in any system that supports HTML5 standards in the web browser. JSmol runs entirely in the client, does not use any server technologies.
+
JSmol is a JavaScript framework that allows web developers to create pages that utilize either Java or HTML5 (no Java), at will. This enables Jmol to display interactive 3D molecular structures on devices that do not have Java installed, or for which Java is not available (such as smart phones and some tablet computers, e.g. iPad) or has not been installed because of concerns for Java being a [http://proteopedia.org/w/Java#Java_is_a_security_threat security threat].
  
JSmol allows rendering, scripting and interaction with the models just as Jmol does, since the source code is shared by both. Note that JSmol is not a different program than Jmol: it is Jmol, just compiled into JavaScript instead of Java (thanks to the [http://java2script.sourceforge.net/ Java2Script] software).  
+
JSmol/HTML5 (no Java) is virtually identical to JSmol/Java in terms of rendering. The Java mode gives faster performance and smoother rotation than the HTML5 mode by a factor of 6 to 10, typically. In many cases this is not noticeable. Where it is noticed is with rending structures involving 20,000+ atoms or with surface creation. Rendering in the HTML5 mode can be sped up substantially with judicial use of [[PlatformSpeed]].  
  
Current limitations:
+
More information about JSmol:
* Binary files cannot be opened into JSmol (e.g Spartan files, gzipped files).
 
  
When used together with [[Jmol JavaScript Object]] (Jmol-JSO), the same webpage may be authored to run in all devices using in each case a Jmol variety or surrogate that is adjusted to capabilities of each device.
+
*[[Jmol JavaScript Object]]: A full discussion of what JSmol is and how it can be implemented on a web page. Technical information about the libraries used to implement both the Java and HTML5 modes and to interact with them via scripts and user interface controls such as buttons, links, and menus.
 +
: Maybe you want to go straight to
 +
:* [[Jmol_JavaScript_Object/Functions|Functions for Jmol JavaScript Object]]
 +
:* [[Jmol_JavaScript_Object/Info|Detailed explanation of the parameters included in the Info variable]]
  
 +
*[[JSmol pros and cons]] describes the problems JSmol has with large models and certain web browsers.
  
JSmol is still in the development stage (Oct. 2012). You can see it in action at the [http://chemapps.stolaf.edu/jmol/jsmol/test2.htm test page]. The current set of files (development version, subject to changes) may be downloaded [http://chemapps.stolaf.edu/jmol/JSmol.zip here].
+
*[http://proteopedia.org/w/Java Proteopedia page on using Java in relation to Jmol].
 +
 
 +
 
 +
<table style="width:100%;">
 +
<tr>
 +
<td style="width:25%; vertical-align:top;">
 +
{{Installing_Jmol}}
 +
</td>
 +
<td style="width:50%; vertical-align:top;">
 +
{{Running_Jmol}}
 +
<div style="margin-top:0.7em;"></div>
 +
{{Tutorials}}
 +
</td>
 +
<td style="width:25%; vertical-align:top;">
 +
{{Jmol_Documentation}}
 +
</td>
 +
</tr>
 +
</table>

Latest revision as of 23:43, 20 November 2015

JSmol is a JavaScript framework that allows web developers to create pages that utilize either Java or HTML5 (no Java), at will. This enables Jmol to display interactive 3D molecular structures on devices that do not have Java installed, or for which Java is not available (such as smart phones and some tablet computers, e.g. iPad) or has not been installed because of concerns for Java being a security threat.

JSmol/HTML5 (no Java) is virtually identical to JSmol/Java in terms of rendering. The Java mode gives faster performance and smoother rotation than the HTML5 mode by a factor of 6 to 10, typically. In many cases this is not noticeable. Where it is noticed is with rending structures involving 20,000+ atoms or with surface creation. Rendering in the HTML5 mode can be sped up substantially with judicial use of PlatformSpeed.

More information about JSmol:

  • Jmol JavaScript Object: A full discussion of what JSmol is and how it can be implemented on a web page. Technical information about the libraries used to implement both the Java and HTML5 modes and to interact with them via scripts and user interface controls such as buttons, links, and menus.
Maybe you want to go straight to
  • JSmol pros and cons describes the problems JSmol has with large models and certain web browsers.


Installing Jmol / JSmol
Running Jmol / JSmol
Jmol / JSmol Tutorials
Jmol + JSmol Documentation