Stephen Hillier wrote:

>Hi,
>
>could someone tell me what the all the different applet files are?
>
>And why a signed and an unsigned set?
>
>  
>
What a timely question! I was just drafting a message to users....

Jmol users:

We were all a bit confused with the new file naming, so we've decided to
rename the applet files again -- just to thoroughly confuse you.
Actually, this is much better. What follows refers to Jmol 11.1.36.

There are four distinct options that you can use when using the Jmol
applet. The typical user would only use one of these; we recommend the
first.

JmolApplet0*.jar
JmolApplet.jar
JmolAppletSigned.jar
JmolAppletSigned0*.jar

(Note: * here is a wildcard character meaning "all files starting with".)

While we release all files associated with all of these options, you
only need the files associated with one of them. Most people will use
the first of these options.

Executive Summary
--------------------
If you are a typical Jmol user, just transfer the JmolApplet0*.jar files
to your server along with Jmol.js and include the simple form of
jmolInitialize on your page:

jmolInitialize("directory-containing-jar-files")


JmolApplet0*.jar
------------------
A set of 16 files (currently) that together comprise all of Jmol but
arranged so that if your page does not require a component, that
component is not downloaded from the server. If you never use molecular
orbitals, that part won't be downloaded; if you only use PDB or CIF
files, only the PDB and CIF file readers will be downloaded. (They are
together in one of the files.) We still recommend putting all 16
JmolApplet0*.jar files on your server even if your page does not use the
capabilities provided by some of the files, because the pop-up menu and
Jmol console both allow users to access parts of Jmol you might not have
considered.

To use JmolApplet0*.jar use the simplest form of jmolInitialize(), just
indicating the directory containing the set of jar files:

jmolInitialize("directory-containing-jar-files")

for example,

jmolInitialize(".")  // jar files are in the same directory as the web page
jmolInitialize("../jmol") // jar files are in a parallel subdirectory

JmolApplet.jar
---------------
A single jar file containing all Jmol applet components.  Use this if
you want to keep your website simple or you just want to upload a single
JAR file whenever new versions are released. Loads Jmol somewhat slower
than the previous option, as JmolApplet.jar is all of Jmol, and all of
it must get loaded onto a user's machine before any structure is displayed.

To use JmolApplet.jar either:

a) just put it in the directory containing the HTML page requiring it
and do not use jmolInitialize(), or
b) identify it explicitly in jmolInitialize(), for example:

jmolInitialize("directory-containing-jar-files", "JmolApplet.jar")



JmolAppletSigned.jar
----------------------
The signed version of JmolApplet.jar. This version allows the user to
access files anywhere on a hard drive and from any location on the web.
Typically the user gets a message asking if they want to accept the
"certificate", but this is security feature is not always enabled.
JmolAppletSigned.jar should be used with this in mind. Other than
reading files, Jmol does not currently utilize other capabilities of
signed applets, such as accessing the System clipboard or writing files.
Use only if you know what you are doing and have considered the security
issues.

To use JmolAppletSigned.jar use:

jmolInitialize("directory-containing-jar-files", "JmolAppletSigned.jar")



JmolAppletSigned0*.jar
------------------------
The signed version of JmolApplet0*.jar. This version allows the user to
access files anywhere on a hard drive and from any location on the web.
Typically the user gets a message asking if they want to accept the
certificate for EACH of the 16 loadable files. For this reason,
JmolAppletSigned0*.jar may not be of general use.

To use JmolAppletSigned0*.jar, use the form:

jmolInitialize("directory-containing-jar-files", true)

or

jmolInitialize("directory-containing-jar-files", "JmolAppletSigned0.jar")







-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users

Reply via email to