1============================================================================== 2=== Jmol === 3============================================================================== 4 5 6Jmol is an open-source molecule viewer and editor written in Java. 7 8Full information is available at http://www.jmol.org/ 9 10Usage questions and comments should be posted to jmol-users@lists.sourceforge.net 11 12Development questions, suggestions and comments should be posted 13to jmol-developers@lists.sf.net 14 15 16List of files included: 17------------------- 18 19- README.txt 20 This file. 21 22- COPYRIGHT.txt 23 Copyright informations. 24 25- LICENSE.txt 26 GNU LGPL (terms of license for use and distribution of Jmol). 27 28- Jmol.jar 29 Executable file for the Jmol application (a program written in Java). 30 This works as any other program: opens in its own window, can be 31 resized or minimized, admits drag-and-drop, has a top menu bar, 32 can open and save files, etc. It can be run from the command line 33 (particulary, using the shell or batch files described below), 34 but if Java is properly configured in your system, it's usually 35 enough to double-click on this file. 36 37- jmol 38 (Some kind of batch file to start Jmol application) 39 40- jmol.bat 41 A batch file to start Jmol application under Windows. 42 43- jmol.mac 44 (Some kind of batch file to start Jmol application) 45 46- jmol.sh 47 A shell script to start Jmol application under Unix-like systems, 48 like Linux, BSD, Solaris and Cygwin for Windows. 49 50- JmolApplet.jar 51 The applet, i.e. a version of the program that will only run 52 when embedded in a web page. 53 This is an all-in-one (or monolithic) file, kept mainly for 54 compatibility with old pages that call it explicitly. Current 55 recommended procedure is to use the split version (JmolApplet0.jar etc., 56 described below). In particular, Jmol.js uses the split version. 57 You may wish to use this if you want to keep your website simple or you 58 just want to upload a single jar file whenever new versions are released. 59 However, this will load Jmol somewhat slower than the split versions, 60 as all the program components must get loaded onto a user's machine 61 before any structure is displayed. 62 To invoke JmolApplet.jar from Jmol.js, either: 63 a) put it in the folder containing the HTML page requiring it and 64 do not use jmolInitialize() 65 or 66 b) identify it explicitly in jmolInitialize(), for example: 67 jmolInitialize("folder-containing-jar-files", "JmolApplet.jar") 68 69- JmolAppletSigned.jar 70 An equivalent version of the applet, but this is a "signed" or 71 "trusted" applet (a term in Java security language). This means it 72 must be authorized by the web page visitor for it to run, but then 73 it will have less security restrictions for file access. For example, 74 it can access files on any part of the user's computer or from any 75 other web server. 76 Typically users get a message asking if they want to accept the 77 "certificate" or if they "trust" the applet, but this security feature 78 is not always enabled. If you decide to use JmolAppletSigned.jar 79 you should keep this in mind. 80 Other than reading files, Jmol does not currently utilize other capabilities 81 of signed applets, such as accessing the System clipboard or writing files. 82 Use only if you know what you are doing and have considered the security issues. 83 To invoke JmolAppletSigned.jar from Jmol.js, use: 84 jmolInitialize("folder-containing-jar-files", "JmolAppletSigned.jar") 85 86- Jmol.js 87 The utilities library, written in JavaScript language, that assists in 88 the preparation of web pages that use Jmol applet, without the need to 89 know and write detailed JmolApplet code. 90 This library uses by default the split version of the applet (either 91 unsigned or signed). 92 Fully documented at http://jmol.org/jslibrary/ 93 94- JmolApplet0.jar and 95 JmolApplet0(severalSuffixes).jar 96 The applet is divided up into several pieces according to their function, 97 so that if a page does not require a component, that component is 98 not downloaded from the server. It is still recommended that you put 99 all JmolApplet0*.jar files on your server, even if your page does not use 100 the capabilities provided by some of the files, because the pop-up menu 101 and Jmol console both allow users to access parts of Jmol you might 102 not have considered. 103 The set of these files is equivalent to the single JmolApplet.jar. 104 This split version is the one that will be used by default if you use 105 Jmol.js. For that, use the simplest form of jmolInitialize(), just 106 indicating the folder containing the set of jar files: 107 jmolInitialize("folder-containing-jar-files") 108 for example, 109 jmolInitialize(".") 110 (if jar files are in the same folder as the web page) 111 jmolInitialize("../jmol") 112 (if jar files are in a parallel folder, named 'jmol') 113 114- JmolAppletSigned0.jar and 115 JmolAppletSigned0(severalSuffixes).jar 116 The signed version of the split applet. This version allows the user 117 to access files anywhere on the computer and from any location on the web. 118 Typically, users get a message asking if they want to accept the certificate 119 for **each** of the (currently 16) loadable jar files. For this reason, this 120 version may not be of general use. 121 The set of these files is equivalent to the single JmolAppletSigned.jar. 122 To use this with Jmol.js, use either: 123 a) jmolInitialize("folder-containing-jar-files", true) 124 or 125 b) jmolInitialize("folder-containing-jar-files", "JmolAppletSigned0.jar") 126 127--------------------------- 128Given the descriptions, you will realize that the distribution package contains 1294 full copies of the applet (signed or unsigned, split or not). 130--------------------------- 131