"How to delay the appearance of Jmol panel until the user requests it"

-- A template for building webpages that include Jmol panels --

Available from  http://biomodel.uah.es/Jmol/  and  http://wiki.jmol.org/ 

Method A: pop-up / pop-in, using iframes
Compatible with: JSmol 14 or later

Author: Angel Herráez.  Version 2019.11.28

This template is offered freely for anyone to use or adapt it, according to Creative Commons Attribution-ShareAlike 4.0 License,
http://creativecommons.org/licenses/by-sa/4.0/

------------
FILES NEEDED:

- "pop_Jmol.htm": the webpage seen by users; you can change the filename freely, and have several pages based on it.

- "pop_Jmol.js" -filename unchanged, common to all possible pages-

- "Jmol_caption.htm" -filename unchanged, common to all possible pages and models-

- "Jmol_container.htm" -filename unchanged, common to all possible pages and models-

------------
DESCRIPTION:

- This layout permits to show one or more molecular models in a page, in a fixed size JSmol panel, using a limited set of predefined renderings. The 3D model only appears upon user's request.

- For each instance (molecule), it automatically inserts in the page an image of the molecule and instructions for the user. Upon user's click, a Jmol model will be shown, either in a new window ("pop-up") or in place of the image ("pop-in").

- Uses inline frames (<IFRAME>) for the image-caption and for the popped-in JSmol Object.

------------
WHAT YOU NEED TO PREPARE AND SETUP:

- For each molecule, a molecular coordinates file that will be read by Jmol.

- For each molecule, an image (can be a drawing, e.g. its formula, or a screenshot of the 3D model in Jmol). Filename must be the same as for the molecular coordinates file, but with extension .jpg.

- You web page(s) will be based on "pop_Jmol.htm". You may want to change CSS and, of course, textual content. Each model will be handled by inserting a call to "putJmolPanel()", where you must specify the identifier that will be shown for the molecule and the filename of the molecular coordinates file (including extension).

- Edit "pop_Jmol.js" file and adjust to your needs:
	- value of "var JmolPath", to point to where you have the JSmol library files **essential**
	- value of "var JmolSize", to choose a different size for JSmol panels (set at 300 pixels)
	- you shouldn't need to change "var JmolWinWidth"
	- you shouldn't need to change "var JmolWinHeight" unless you change the set of rendering controls that are shown below the JSmol object.

- On "Jmol_caption.htm", you may want to edit the caption text.

- On "Jmol_container.htm", you may want to change the title, the CSS parameters, and the set of controls for predefined rendering options.