| Name | Modified | Size | Downloads | Status |
|---|---|---|---|---|
| Totals: 6 Items | 2.5 MB | 11 | ||
| README.markdown | 2011-11-22 | 8.9 kB | 3 |  |
| HBView_demo_OSX_SL.bin | 2011-11-22 | 1.4 MB | 3 | |
| HBView_demo_win.exe | 2011-11-10 | 363.0 kB | 1 | |
| HyperBallDemo_V0.2.tgz | 2011-10-23 | 686.0 kB | 1 | |
| HyperBallDemo_V0.1_GLSL.tgz | 2011-09-11 | 26.3 kB | 2 | |
| HyperBallDemo_V0.1_Cg.tgz | 2011-06-21 | 24.5 kB | 1 | |
$Id: README.markdown 79 2011-11-22 20:46:24Z baaden $
HyperBallView is a demo program illustrating the HyperBalls representation (Chavent et al., 2011) designed to visualize molecular structures using GPU graphics card capabilities based on shaders (GLSL or Cg). It can read Protein Data Bank (PDB) files and a custom netCDF format.
The code is also intended as an example that can be re-used to implement the HyperBalls representation in other software. The performance of the code is not maximal, as this would require restructuring the program and it would become less readable.
More information on http://hyperballs.sourceforge.net
The demo uses CMake to facilitate cross-platform installations. Several graphics libraries are also needed.
First, install the following dependencies: CMake, Cg Toolkit, freeglut/glut and a standard development environment (compiler and header files).
To install from the very latest source code version (recommended) you need the subversion svn utility. If you want to use the netCDF input files, you will also need the netCDF library and header files. In order to be able to rebuild the html version of this documentation you will need perl and MarkDown. The MarkDown software tool, written in Perl by John Gruber, is provided as part of this demo package source code.
Download source code
We advise you to get the latest version from svn, and put it in the ${HBDEMO_SRC} directory of your liking. In the next parts, we will refer to the absolute path of this directory as HBDEMO_SRC. So please replace it by your own path: for example it could be defined as /home/martin/hyperballdemo via the following command
export HBDEMO_SRC=/home/martin/hyperballdemo (for bash)
or
setenv HBDEMO_SRC /home/martin/hyperballdemo (for csh)
Now you can check out the latest version from the subversion repository using
svn co https://hyperballs.svn.sourceforge.net/svnroot/hyperballs ${HBDEMO_SRC}
This creates the demo source directory. You can also browse the subversion repository online at SourceForge.
Compile and install the demo
mkdir HBDemoBuild
cd HBDemoBuild
cmake ${HBDEMO_SRC}
make install (you may have to be root)
This will install the demo in the default directory determined by the install prefix (/usr/local, be careful you might need to be root). You can also install the demo on your own install prefix (for example /home/martin) using this way :
mkdir HBDemoBuild
cd HBDemoBuild
cmake ${HBDEMO_SRC} -DCMAKE_INSTALL_PREFIX:PATH=/home/martin
make install
Let's call the install prefix ${HBDEMO_EXE}. The above commands should generate and install an executable shell script called HBView_demo in ${HBDEMO_EXE}/bin.
This program is under the CeCill licence, which is compatible with the GPL licence.
(To be completed soon for Windows and Linux.)
In general, to ease source code compilation, we will provide some binary dependencies in the contrib subdirectory. Of course, you can always compile these packages from source.
Debugging OpenGL-based shader implementations can be quite tricky, as there is no easy way to watch the value of variables or execute shader code step-by-step. We found the following tools very useful in our quest for bug-free shaders :)