// #autoload
// #name = ArtificalHorizon
// #version = 1.02
// #author = Barbarian
// #warrior = Barb4rian
// #email = conanford@hotmail.com
// #web = http://barb4rian.tripod.com/
// #credit = jsut
// #description = Provides an artifical horizon like display for air vehicles through 16 waypoints in
	the distance.  Set a key bind to "Artifical Horizon" in Tribes 2 control settings to toggle.
// #status = release level
// #readme = scripts/barbarian/artificalhorizon.txt
// #category = barbarian
//
// requires support.vl2


Artifical Horizon
Tribes 2 script
1.02
October 26, 2002.
http://barb4rian.tripod.com/

Barbarian - conanford@hotmail.com - Barb4rian in-game

This is a simple script that provides a virtual artifical horizon for Tribes 2 vehicles by setting 16
	user waypoints on the distant horizon.  

This is mostly useful when you are too high see the ground and are flying something like a havoc
	transport or you are flying low in fog (i.e. Desiccator) and want to keep level.  A real
	artifical horizon line for vehicles was once in the promised future features of Tribes 2
	(to-do list), but it seems to have gotten killed by the layoff of Dynamix people.

There is one keybinding you can set, "Artifical Horizon", which will toggle the script on and off.

The artifical horizon points are activated when you jump in a vehicle, and removed when you leave the
	vehicle. The points are set as North, East, South, West, then NW, NE, SW, SE, then the eight
	points of NNE, NNW, etc...--this is so that if you have other waypoints set by other scripts
	the most important horizon points are set first.  The points are set at the arbitrary absolute
	altitude of 150 m, which is good for most maps, and at 9999 units distance from the map center.
	The script will not delete points set by other scripts, and there is a hard limit of 16 user
	waypoints at once.  

Installation
------------
Place ArtificalHorizon.vl2 in Dynamix\Tribes2\Gamedata\base.


Requires
--------

Requires Writer's support.vl2 -- get it from Tribes 2 Depot http://www.planettribes.com/depot

Credits
-------
Jsut (jsut@kabob.ca) for waypoint code.


Future wish list
----------------

- Add options gui
- Add an option to remove current waypoints on activation and set entire horizon points, then restore
	old waypoints on leaving vehicle
- Add an option to use 4, 8, or the full 16 points

Revision History
----------------

1.02	Fixed a nasty little thing where Artifical Horizon would not activate in some configurations.
	On/off toggle persists

1.01	Added check for presence of RevengeWaypoints, if it is installed only use 8 waypoints instead of
	16 to allow for RevengeWaypoint's 3 waypoints, since Tribes 2 only allows 16 user waypoints.

1.00	First release version, removed script activating with non-air vehicles

0.01	First test version.