GLmol - Molecular Viewer on WebGL/Javascript

== About GLmol ==

GLmol is a 3D molecular viewer based on WebGL and Javascript. You can
embed molecular models in Web pages without using Java or
plugins. GLmol is open-source software licensed under LGPL3.

== Features ==

Currently GLmol has following features. More is coming...

* Read PDB file
* Rotate/Translate/Zoom model with mouse
* Representations
    - Line
    - Stick
    - Sphere(van der Waals radius or fixed radius)
    - Alpha carbon trace
    - Ribbon
    - Combination of above
* Coloring
    - By chain
    - By secondary structure (when defined in SHEET/HELIX records)
    - By Elements
    - Gradation (a.k.a chainbow)
    - Custom
* Crystallography
    - Display unit cell
    - Show crystal packing (when defined in REMARK section)
    - Display biological assembly (when defined in REMARK section)

== System requirements ==

GLmol runs on newer versions of Firefox, Chrome, Safari or
Opera. Internet Explorer is not supported because IE doesn't implement
WebGL.

== Troubleshooting ==

If you see only black screen and you are using

 Internet Explorer: sorry. IE doesn't support WebGL.
 Firefox (version 4 or later): try force enable WebGL. 
   https://wiki.mozilla.org/Blocklisting/Blocked_Graphics_Drivers#How_to_force-enable_blocked_graphics_features
 Chrome: try force enable WebGL.
   http://www.google.com/support/forum/p/Chrome/thread?tid=4b9244822aa2f2e0&hl=en
 Safari: enable WebGL.
   https://discussions.apple.com/thread/3300585?start=0&tstart=0

== How to embed ==

Currently, documentation is not ready.
Please examine "embedding-examplesEN.html"

As XmlHttpRequest doesn't work for local URIs (file://...),
you have to put the program on a Web server to test.
If web servers are not available, you can still embed whole PDB file in a HTML file.
 (see triiodotyrosine example)

== Contact ==

Comments and suggestions are welcome at http://sourceforge.jp/projects/webglmol/forums/ or 
biochem_fan@users.sourceforge.jp 
