The AA Renderer depends on the configuration files for the TripleA Open Source "Axis and Allies" clone game. You need to ensure that you have the game installed and that the configuration for the AA renderer is pointing to the correct location.
You can use the "Default" section to configure the AA renderer. Select the version from the combo box, specify the directory that you installed the TripleA game into (e.g c:\program files\TripleA) and then hit the apply defaults button. This will update the three value described below with values appropriate for the specified TripleA version. By using the radio buttons in the default section you can specify which of the default maps you would like the renderer to use.
You can use the default section as a helper to switch between TripleA maps. If you have downloaded skins, you can modify the maps directory to point to the directory containing the skins.
You can also explicitly set the following three configuration values:
- TripleA Maps Directory - This is the location of the map tiles for the game. This could be a skin or a directory that game with the game. It is important to ensure that the maps directory you choose corresponds with the "Game Config" file that you select (see below).
- TripleA Images Directory - This is the location of the images files for the game. This includes the unit icons and country flags.
- TripleA Game Config File - This is the XML configuration file that you wish to use. Each XML file should correspond with a map directory (see above). For instance the Big_World_1942.xml corresponds with the map files in the big_world directory.
The renderer will accept any combination of the above directories and file (N.B. You can have the renderer drawing different regions (from the XML) over a totally incompatible map. The renderer will function if the config and images aren't specified (albeit without units and region names rendered), but it does need the maps directory to point to a valid TripleA maps directory.
The renderer now supports importing of save games generated by TripleA version 0_8_1 and above. If you select the "Import TripleA Savegame" check box and specify a save game file it will generate a AAA.txt in the aa renderer install location. This file is used to render the current save game and all previous turns. You can configure the speed that the screen saver flips through turns by modifying the values in the configuration dialog.
N.B. To use the import save game functionality you will need to ensure that the configuration points to the most recent javaw.exe on your machine (packaged with newer versions of tripleA). You will also need to configure the AA renderer to point to the current TripleA.jar in the TripleA install directory. (the JAR file that was used to generate the turn). The defaults section of the configuration dialog tries to fill these values correctly, so you can use that for a guide.
Please email me if you have any questions.
Copyright (c) 2006 Tom Horn. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Redistributions in any form must be accompanied by information on how to obtain complete source code for the DB software and any accompanying software that uses the DB software. The source code must either be included in the distribution or be available for no more than the cost of distribution plus a nominal fee, and must be freely redistributable under reasonable conditions. For an executable file, complete source code means the source code for all modules it contains. It does not include source code for modules or files that typically accompany the major components of the operating system on which the executable file runs. THIS SOFTWARE IS PROVIDED BY TOM HORN ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE DISCLAIMED. IN NO EVENT SHALL TOM HORN BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.