Jmol enhanced figure toolkit (publCIF plugin beta2.1)

Please enter a caption for the figure



   

Enhanced figure

This tab provides a preview of your enhanced figure with standard buttons and any scripts that you have created. When you add scripts using the "button scripts", "checkbox scripts" or "radiobutton scripts" tabs, the contents of this tab will be automatically updated so that you can test your new scripts before saving.





These buttons will always appear on your enhanced figure. Your additional scripts will be listed below.

Advanced users

If you wish to make manual changes to the graphical state of the main figure, click on the button below to reveal its current stored value. If required, you may first update this to the view shown in the current display window. To save any changes you make, click on "Save current view as main figure" in the main window.

Up to four additional scripts activated by buttons may be provided here. In each case provide the script to run when the button is clicked. Please also supply a brief caption describing the result of clicking the button.

Button (a)

script to run
caption

Button (b)

script to run
caption

Button (c)

script to run
caption

Button (d)

script to run
caption

Up to four additional checkbox scripts may be provided here. Each will be associated with a selection box on the interactive page. In each case provide the script to run when the box is checked, and the script to run when it is unchecked. usually these will be inverse operations. Please also supply a brief caption for each checkbox.

Checkbox script 1

checked
unchecked
caption

Checkbox script 2

checked
unchecked
caption

Checkbox script 3

checked
unchecked
caption

Checkbox script 4

checked
unchecked
caption

One or two groups of radio-buttons may be provided here. Each will be associated with a set of mutually exclusive scripts on the interactive page. In each case provide the script to run when the button is selected, and a brief legend displayed for each button.

Group 1

title for group
option 1
legend
option 2
legend
option 3
legend
option 4
legend
option 5
legend
option 6
legend

Group 2

title for group
option 1
legend
option 2
legend
option 3
legend
option 4
legend
option 5
legend
option 6
legend

Scratch workspace

You may use this page to edit and test sample scripts, to store backup scripts etc. Anything you write here will not be written to the enhanced figure page.



Creating an enhanced figure

  1. Wait for the applet and CIF to load. The applet itself is over 1 MB in size (but may already by cached by your browser).
  2. Manipulate the image as required using the mouse and right-button menu in the applet window, as well as the utility options provided under various tabs in this panel.
  3. Return as required to perform further edits.
  4. Click on the button "Save current view as figure", after slecting the appropriate figure number from the adjacent menu, to create your enhanced figure and a static image of the initial view that will be printed in the PDF edition of the journal.
  5. You may supply additional scripts that a reader can activate through buttons, checkboxes or radio buttons. A tab is provided for each class of interactive script. It is possible to manipulate the main image and import the result as a complete script by selecting the "import view" buttons on these tabs.
  6. IMPORTANT: If you have changed the view of the model in the main applet window (e.g. to generate a new interactive script) but do not want to save this as the default figure, use the button "Save updates to scripts only".
  7. Note that changes to the graphics state within Jmol may not be communicated back to the toolkit interface, so that checkboxes, radio buttons etc. may become unsynchronised with the current view. You should bear in mind that this is an inherent difficulty with web applications of this type. You will need to take care to minimize such difficulties in creating your own scripts for your enhanced figure.
  8. The Jmol console (accessed from the right-button menu in the applet window) is a useful tool for advanced users to debug and enhance the model representation.
  9. The Jmol home page is at www.jmol.org and extensive online documentation of the Jmol scripting language is at http://chemapps.stolaf.edu/jmol/docs/?ver=11.6.

Documentation

A manual for authors is available in PDF format.

Feedback

This is a beta implementation of the toolkit. We welcome suggestions for improvements or enhancements, and reports of bugs or major shortcomings. We also welcome your general comments on how useful and usable you find this utility. Please write to us at jtkt@iucr.org with your comments. It will be helpful to us in assessing the performance of the toolkit if you can report the browser and operating system that you are using.

Thank you.


Delete: If you wish to delete this figure and all scripts associated with it, please click on the button.