hxBrowser - Technical Details & Troubleshooting

hxBrowser is written in C++ and uses Qt 3.2 (or higher) for the GUI and OpenGL for the 3D Graphics. It was successfully tested on Windows XP, Linux, and Mac OS X.

On all platform the application including the documentation requires only 1-2 MB of disk space (excluding shared libraries or DLLs). You need to have the Qt and OpenGL run time libraries installed.

Building hxBrowser from sources

You need the hxBrowser.pro project file, the *.ui files, all header and source files, and the doc directory with the html and gif files. Then do:

qmake -o Makefile hxBrowser.pro
make

In most cases that should do it. If you have trouble with paths you probably need to modify the Makefile to cope with the include and lib paths on your system.

Troubleshooting

On Mac OS X you might run into trouble with the GUI. Depending on the chosen font size some fields might be only partially visible. That appears to be a problem with Qt (3.3) on the Mac.

On Linux you might run into trouble with OpenGL. If you see GLX error messages at startup and experience dysfunctional graphics check if your graphics card can deal with OpenGL. Type glxinfo and read the output carefully. If you do not have the GLX extension enabled and cannot enable it, you need to use the Mesa distribution which offers a complete OpenGL API but is based on X11. All you need to do is to add the path to the MESA shared libraries as first item to the LD_LIBRARY_PATH environment variable. For example: export LD_LIBRARY_PATH=/usr/local/mesa/lib:$LD_LIBRARY_PATH
No need to recompile. If that still doesn't work send email to tu@bnl.gov and explain in detail your problem (platform, OS version etc.).

On Windows XP you will need the following libraries in addition to the standard libraries. You might have them on your system already. In any case the come with the hxBrowser installation package.

Visual C++: msvcp70d.dll, msvcr70.dll, msvcr70d.dll
Qt 3.2.1: qt-mtnc321.dll (or any higher version)