From: Angel H. <ang...@ua...> - 2007-05-09 13:43:57
|
Very good, Bob I'm intercalating some suggestions: > Executive Summary > -------------------- > If you are a typical Jmol user, just transfer the JmolApplet0*.jar files ## add this to clarify the asterisk (either not understood by non- MSDOS people or plain unnoticed for its small size) ## (that is, all files whose name starts with "JmolApplet0") > to your server as well as the Jmol.js file. > 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("../jmol") ## this path may be confusing, as it has previously led some users to putting model files not below applet files; better repeat the more general path used above: ## jmolInitialize("directory-containing-jar-files") > 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("../jmol", "JmolApplet.jar") 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("../jmol", "JmolAppletSigned.jar") 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("../jmol", true) jmolInitialize("directory-containing-jar-files", true) > or > > jmolInitialize("../jmol", "JmolAppletSigned0.jar") jmolInitialize("directory-containing-jar-files", "JmolAppletSigned0.jar") ##end## Despite the funny filenames, I think this 0* convention will make explanations much easier. BTW, I support the previous suggeston of making 11.2 release closed soon. All these recent improvements and features are yelling for a stable release. Lets us know how can we help with the testing. Bob, this year has been terribly exciting, although we hardly can keep pace with you. I think we have enough for another year to go just discovering all we have available. Thanks a lot! |