Air Combat Maneuvering 6.0
--------------------------

ACM is an air combat maneuvering flight simulator program originally developed
by Riley Rainey until the version 5.0. Starting from that already good program,
I added several new features and extensions to make the program more suitable
for civil and instrumental flight.

The following list summarizes the features of the program; please read the
reference manual for a detailed description:

- Open source, mostly GNU GPL or public domain license.

- Only C source code with small TCL launcher interface.

- Very small CPU and memory footprint; does not require specialized hardware.

- Simulated environment: ellipsoidal Earth (WGS-84 model), magnetic field
  calculation (NOAA WMM model), Sun ephemeris, standard atmosphere, wind and
  gusts, clouds.

- Aircraft: several models available, both civil and military, 6 degrees of
  freedom, bicycle or tricycle landing gear, aerodynamics simulation;
  power-plant: propeller piston engine, jet engine with afterburner, rocket,
  glider.

- Instrumentation: magnetic compass, classic panel (attitude indicator, airspeed
  indicator, altitude indicator, turn and slip indicator, climb speed
  indicator), HSI and RNAV calculator, ADF, head-up display, autopilot, direct
  stick control or rate stick control.

- Weapon systems: radar, radar warning receiver, missiles, cannon, drop bombs;
  robot opponents can be generated for ACM techniques practicing.

- Multiplayer capability through the standard DIS network protocol; up to 31
  remote players supported.

- Sound effects.

- Extensible sceneries for several areas of the world, with navigation charts
  including airports, NDB, VOR, ILS.

- Allow to choose the departure date and time, airport and runway; allows to
  fly freely around the globe (sceneries are loaded dynamically, where
  available).

Sources and binary packages are available from
http://www.icosaedro.it/acm/download.html

Please read the INSTALL.txt file for more about system requirements, compilation
procedure and basic usage of the program. The doc/ directory contains a
detailed reference manual and other useful documents.


Layout of the package
---------------------

Here is summary of the contents of the ACM source package.
The Windows binary package may contain only the essential part of these files
and directories.

acm.tcl      Launcher for the src/acm.exe simulator. Requires the TCL interpreter.
CHANGES.txt  Latest changes are listed here.
COPYING.txt  GNU GPL license; most of the source refers to this one.
doc          Documentation and reference manual.
doc/charts   Basic navigation charts generated from the available sceneries
             using the tools/chart/chart.exe program (see below).
doc/manual/acmdoc.html  ACM Reference Manual (START HERE!).
doc/acm.man  Very basic ACM "troff" manual page (Unix-like systems only).
objects      Inventory of planes, zones, sceneries etc. acm.exe needs this dir.
objects/WMM.COF  Coefficients for the World Magnetic Model library.
objects/zones.txt  Zones of the Earth covered by the available seneries.
objects/zones/  The sceneries. USA sceneries generated from FAA data base.
src          All the sources in C language. Makefiles made with make-makefile.
src/acm      The actual simulator.
src/dis      DIS protocol library and tools.
src/dis/server/dis_relay.exe  DIS relay program.
src/gedit    Very basic aircraft model editor. DOES NOT WORK ON 64-BITS PC.
src/util     Utility libraries.
src/V        Very efficient, lightweight, 3D graphic library.
src/wmm      World Magnetic Model library.
test         Test programs.
tools/build-doxygen-doc.sh  Bash script to generate Doxygen docs from sources.
             Mostly useful to check for missing or non-compliant DocBlocks.
tools/chart  Program to generate navigation charts from ACM sceneries.
tools/faaairports  Program to generate sceneries from the USA FAA data base.
CHANGES.txt  Chronological list of the changes to the ACM program since its
             version 2 back in the '90!
COPYING.txt  GNU GPL license covering most of the code. Where not stated
             otherwise, the license is public domain.
INSTALL.txt  Basic installation instructions. See also the ACM Reference Manual.
Makefile     Global, do-it-all makefile. Works on Linux only, though...
             Under Windos + MinGW I had to issue the "make" command under the
             src/acm directory (or any specific directory of interest).
README.txt   This file.
TODO.txt     Known bugs and wanted features.
acm.tcl      Handy launcher interface. Requires the tck/tk interpreter.


Development of the source
-------------------------

This version of ACM compiles and has been tested under these systems:

	- Slackware 14.2, x86_64 (Linux).
	- Slackware 14.1, x86_32 (Linux).
	- Windows 7 Starter, x86_32 + MinGW system development kit.

Each Makefile has been generated using the make-makefile program available at
http://cvs.icosaedro.it:8080/viewvc/public/tools

The CVS repository is available at:
http://cvs.icosaedro.it:8080/viewvc/public/acm (HTML interface)
http://www.icosaedro.it/cvs.html (anonymous cvs access instructions)


Enjoy!

Umberto Salsi (salsi@icosaedro.it)
Bologna, Italy
2017-10-29
