experimental wm3d web interface. use at your own risk.

0. Test Environments
1. Files
2. Notices

##########################################################################
0. Test Envirionments

0.1 Server

   apache-2.2.16@Debian squeeze
   python-2.6
   mod_python (libapache2-mod-python-3.3.1-9)

0.2 Clients

   Firefox10@Windows XP
   IE8@Windows XP (somewhat buggy)
   iceweasel-3.5.19@Debian squeeze

1. Files

   wm3d.html     : main file
   style.css     : stylesheet for wm3d.html
   frontpage.swf : flash movie

   cgi-bin/genswf.py : swf generator
   cgi-bin/genxml.py : xml generator; this calls builder.py
   cgi-bin/iframe.py

   imgs/headline.png
   imgs/logo.png

   (imgs/sampleview.png : sample image of this web interface webpage)

1.1 Modify Files

1.1.1 cgi-bin/genswf.py

  Line 28: haxe = "/usr/bin/haxe"
    Specify your haxe path.

  Line 46: os.environ['HOME'] = "/home/www-data"
    Set home directory of your apache user.
    This setting might be required by haxe and haxelib, which
    seem to use $HOME environmental variable.
    NOTE: you must setup haxe, haxelib, and wm3d for the apache user,
          since all the commands are performed by the apache user.
    
  Line 49: workdir = "/tmp/"
    Workdir. This directory should not be accessible from clients.

  Line 50: wm3dsrcdir = "/home/kamo/haXe/wm3d/src"
    Please specify your wm3d src dir.

1.1.2 cgi-bin/genxml.py

  Line 30: workdir = "/tmp/"
    Work directory. This directory should not be accessible from clients.

  Line 31: wm3dbuilder = "/home/kamo/haXe/wm3d/scripts/python/builder/builder.py"
    Path to the "builder.py" script

1.1.3 style.css

  Line 62: background-image: url("imgs/headline.png");
    Location of "headline.png".

1.1.4 wm3d.html

  Line 8:
    Location of the stylesheet "style.css"

  Line 9 and 10:
    Path to jQuery. (may not neccessary to modify)

  Line 49:
    Location of "genxml.py"

  Line 474:
    Location of "logo.png"

  Line 493: value="frontpage.swf"
  Line 498: src="frontpage.swf"
    Default flash file name for IE and the other browsers, respectively.

  Line 520:
    Location of "genswf.py"

  Line 543:
    Location of "iframe.py"

2. Notices

2.1 General Notices

  * Use at your own risk.
  * It works on IE8, but is buggy.
    IE8 users should remove non-ATOM/HETATM lines from pdb file.
    This will significantly reduce the risk of bugs,
  * Alternate location indicators in pdb file will cause unexpected
    behaviour. (This bug will be fixed soon.)
  * Tested only on IE8 and firefox.

2.2 Notices to Administrator

  * This interface could impose heavy load on your server.
  * There can be security holes.
  * This interface may not work on Windows and Mac servers.

2.3 Notices to Clients

  * Malicious administrators could steal your pdb, xml, swf files.
