<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="date" content="2010-03-16T18:20:12+01:00">
<meta name="author" content="Manuel Moos">
<title>Armagetron Advanced: Documentation</title>
<meta name="description" content="Armagetron Advanced: Documentation">
</head><body>
<table width="90%" align=center>
<tr>
<td align=center width="15%">
<a href="index.html" target="_top">First Start</a>
</td>
<td align=center width="15%">
<a href="install_linux.html" target="_top"> Installation</a>
</td>
<td align=center width="15%">
<a href="network.html" target="_top">Network Play</a>
</td>
<td align=center width="15%">
<a href="config.html" target="_top">Configuration</a>
</td>
<td align=center width="10%">
<a href="faq.html" target="_top">FAQ</a>
</td>
<td align=center width="15%">
<a href="compile.html" target="_top">Redistribution</a>
</td>
</tr>
</table>
<a name=><h1 align=center> Installation</h1></a>
<a name=><h3 align=left>Installer</h3></a>
<p align=justify>
Run the executable, select a directory
to install armagetron into and enjoy. Start menu entries and a desktop shortcut will be created for you.
To uninstall, start the uninstaller from the start menu.
</p>
<a name=><h2 align=left>Result</h2></a>
<p align=justify>
The contents of the installation directory should be something like this:
</p>
<table >
<tr><td><strong>armagetronad.exe</strong></td><td> (the main executable)</td></tr>
<tr><td><strong>models</strong></td><td> (the directory for the cycle models)</td></tr>
<tr><td><strong>sound</strong></td><td> (the directory for sound files)</td></tr>
<tr><td><strong>textures</strong></td><td> (the directory for textures and the icon)</td></tr>
<tr><td><strong>resources</strong></td><td> (the directory for maps)</td></tr>
<tr><td><strong>doc</strong></td><td> (the documentation you are just reading)</td></tr>
<tr><td><strong>language</strong></td><td> (the game's text messages)</td></tr>
<tr><td><strong>config</strong></td><td> (static configuration files)</td></tr>
</table>
<p align=justify>
Additionally, if you installed the moviepack/moviesounds
from the <a href="http://armagetron.sourceforge.net/old/addons.html" target=_top><strong>addons page</strong></a>,
you'll see the two directories
</p>
<strong>moviepack</strong><br>
<strong>moviesounds</strong><br>
<p align=justify>
containing ONLY files and no subdirectories.
When you have run Armagetron Advanced, you'll see the additional files
</p>
<table>
<tr><td><strong>highscores.txt,ladder.txt,won_matches.txt and won_rounds.txt</strong></td><td> (score statistics files)</td></tr>
<tr><td><strong>user.cfg</strong></td><td> (Armagetron Advanced custom configuration file)</td></tr>
</table>
<p align=justify>
Inside the <strong>var</strong> subdirectory,
You may want to create your own
<a href="config.html#files">configuration files</a>
</p>
<table>
<tr><td><strong>autoexec.cfg</strong></td><td> (config file read at every start)</td></tr>
</table>
inside the <strong>var</strong> subdirectory or the
<strong>config</strong> subdirectory for your
custom modifications; that way, they don't get overwritten by the defaults the
next time you install an update.
<a name=cl><a name=><h3 align=left>Command line switches</h3></a></a>
<table>
<tr><td valign=top width=200><strong>-h, +h, --help </strong> </td><td> get help and other available command line options</td></tr>
<tr><td valign=top width=200><strong>-v, +v, --version </strong> </td><td> print version number </td></tr>
<tr><td valign=top width=200><strong></strong> </td><td></td></tr>
<tr><td valign=top width=200><strong>--datadir <Directory> </strong> </td><td> systemwide data directory; read game data (textures, sounds and text) from this directory. </td></tr>
<tr><td valign=top width=200><strong>--userdatadir <Directory> </strong> </td><td> user data dir; try to read all game data from this directory first. </td></tr>
<tr><td valign=top width=200><strong>--configdir <Directory> </strong> </td><td> read game configuration (.cfg-files) from this directory.</td></tr>
<tr><td valign=top width=200><strong>--userconfigdir <Directory> </strong> </td><td> user configuration directory; try to read the configuration from here first. </td></tr>
<tr><td valign=top width=200><strong>--vardir <Directory> </strong> </td><td> save game logs, highscores and user configuration in this directory. </td></tr>
<tr><td valign=top width=200><strong></strong> </td><td></td></tr>
<tr><td valign=top width=200><strong>-f, +f, --fullscreen </strong> </td><td> start in fullscreen mode</td></tr>
<tr><td valign=top width=200><strong>-w, +w, --window, --windowed</strong> </td><td> start in windowed mode </td></tr>
<tr><td valign=top width=200><strong></strong> </td><td></td></tr>
<tr><td valign=top width=200><strong>+directx, -directx </strong> </td><td> enable/disable usage of DirectX for screen initialisation</td></tr>
</table>
<p align=justify>
The various directories you can set have the following impact on how the game loads and saves files.
(Usually, you don't have to bother about it; there are reasonable defaults. But if you want to do
some meddling with the data, these options are your ticket.)
</p>
<a name=><h4 align=left>Data</h4></a>
<p align=justify>
Sounds, textures and models will be first looked for in the directory specified with <strong>--userdatadir</strong>. If they are not
found there or if <strong>--userdatadir</strong> was not used, they are looked for in the directory specified with <strong>--datadir</strong>.
This directory defaults to the current directory if not specified.
</p>
<a name=><h4 align=left>Configuration</h4></a>
<p align=justify>
(I'll leave out the bits about "if option xxx is not set" from now on )
Configuration files are first looked for in <strong>--userconfigdir</strong>, then <strong>--userdatadir/config</strong> ( the dir passed to <strong>--userdatadir</strong>, appended with <strong>/config</strong> ),
then <strong>--configdir</strong> and finally <strong>--datadir/config</strong>.
</p>
<a name=><h4 align=left>Logs and user configuration</h4></a>
<p align=justify>
Log files ( game results, the settings made in the in game menu ) are loaded from <strong>--vardir</strong>, then, if not found there, from <strong>--userdatadir/var</strong> and finally from <strong>--datadir/var</strong>.
They are only saved in the first of these directories that was specified.
</p>
</p>
<a name=><h2 align=left>OpenGL Driver</h2></a>
<p align=justify>
Armagetron Advanced uses OpenGL for the 3D graphics. A software implementation of OpenGL comes
with all Windows versions and Armagetron Advanced can use it. Of course, if you have a 3D accelerator card,
you want to use that; usually, when you installed the driver for your card, an accelerated implementation
of OpenGL was registered with Windows.
</p>
<p align=justify>
If you experience problems with the graphics or if Armagetron Advanced does not even start correctly, try
installing the most recent drivers for your graphics card you can find.</p>
<a name=><h4 align=left>Special notes for VooDoo addon cards (i.e. VooDoo 1,VooDoo 2):</h4></a>
<p align=justify>
A small problem here: the standard OPENGL32.DLL has no hardware
acceleration. Instead, 3DFX supplies you with a file called
3dfxVGL.DLL or 3dfxOGL.DLL (found in your windows\system folder).
Simply copy (drag it with the right mouse button and select "copy" from the
pop-up-menu) it into the folder "armagetronad.exe" is in and rename it
there to "OPENGL32.DLL". Then, "armagetronad.exe" will use this file
instead of Microsoft's standard OPENGL32.DLL. If you cannot find
3dfxVGL.DLL or 3dfxOGL.DLL, you should first check whether you can
find ANY .DLL files in the folder; if not, you'll have to enable
the item "show all files" (or similar) in the folder options.
<br>
If you have problems with that procedure or get crashes in glide3x.*,
<a href="http://armagetron.sourceforge.net/old/download/opengl32.zip" target=_top><strong>download this working version</strong></a> for VooDoo 2 (maybe 1)
and unpack it into your Armagetron Advanced directory. According to the driver, you
need at least Glide 2.56 installed; it really should work if you use
the driver version 3.02.02 (or higher?).
</p>
You need to be in 16 bit colour depth mode to run Armagetron Advanced on some cards
(Riva 128, some VooDoos).
<br>
<p align=center>This document was created by
<a href="http://armagetron.sf.net/contact.html" target=_top><strong>Manuel Moos</strong></a>
</p>
<p align=center>
Last modification: Aug 04 2006
</p>
<p align=center><!--#spaceportsbanner--></p>
<table width="90%" align=center>
<tr>
<td align=center width="15%">
<a href="index.html" target="_top">First Start</a>
</td>
<td align=center width="15%">
<a href="install_linux.html" target="_top"> Installation</a>
</td>
<td align=center width="15%">
<a href="network.html" target="_top">Network Play</a>
</td>
<td align=center width="15%">
<a href="config.html" target="_top">Configuration</a>
</td>
<td align=center width="10%">
<a href="faq.html" target="_top">FAQ</a>
</td>
<td align=center width="15%">
<a href="compile.html" target="_top">Redistribution</a>
</td>
</tr>
</table>
</body>
</html>
