A3D for windows

aart.heijboer@nikhef.nl
 
 


introduction
A3D is an event display for the ANTARES experiment. It was designed to run on unix-flavours, but it has now been compiled on the windows platform.



how I did it (in case you're wondering)

A3D was compiled on windows using the cygwin tools, which make it possible to compile Unix programs on windows. For the X11 libraries I went to  X11R6.4 Libraries for CYGWIN , where they can be downloaded in compiled form.

I then compiled the other libraries that are used:
antcc : Antares detector-classes  (I mutilated the Phototube class to get it going without CERNLIB)
io : the io-library
EZWGL : the GUI and 3d graphics library I use for A3D. (I had to hack the makefile a little for this one).

With these in place, a3d could be compiled without a single modification to the code!  (so hooray for me and...)



download

In accordance with windows tradition, I make the binaries available here:
a3d.zip contains
- windows (95/98 nt(not tested))  executable a3dv1r4.exe.
- a a3d.ini file with some decent user preferences
- an event file for testing
- two X libraries that are dynamically linked (libXext.dll and libX11.dll). These must be copied to the
windows system directory.

antlibs.zip contains
- compiled versions of the 'standard' antares libraries iogcc.o  (the i/o library) and antcc.a (containing stuff like
the detector class) - not needed to run a3d

ezlib.zip contains
- the static version of EZWGL V1.43 library - not needed to run a3d



how to run
There are a few points that you need to take care of before a3d will run:

X-server. A3D is a program for the X-windows system (because it uses the EZWGL library). This means that, on whatever
platform it is run, there must be a program takes care of a3ds request to draw windows and graphics on the screen and take
care of what happens when the mouse is moved (stuf like that). Such a program is called an X-server (and a3d, xclock and emacs are
X-clients). On unix machines this is the standard, but on the windows platform it is not and we need a special program to do this.
There are a few programs available
- xwin32 (see www.starnet.com) - there is a trial version that can be used for 2 hours at a time (this is the one I use)
- exceed  - As far as I know there is no trial version of this, but I believe this is installed in saclay and cppm
- mix (http://tnt.microimages.com/www/html/freestuf/mix/) - don't know anything about this one

Display variable. Like on unix, there must be a variable called DISPLAY that tells X where to draw the program.
It can be set using the dos-command 'set'. So in a dos-box  type e.g.
set DISPLAY=127.0.0.1:0.0         (127.0.0.1 means localhost... the computer that runs the program. )
then - in the same dos box - type the name of the executable a3dv1r4.exe.
(you can also put the set display in the autoexec.bat - then it will allways be set)
NB: since X-communication allways runs via tcp/ip, there must be a tcp/ip protocal installed - even if
there is no network.

AFS. Normally the detector is loaded via afs from Lyon. If there is no afs (as is the case with me at home), then the only
workaround is to ftp the detector file to a local disk and manually change the event file so that it refers to that detector.
(a future version of a3d may have some more advanced support for this problem).
 



That's it. Please let me know if you have trouble (I won't be surprised) or succes.