Restructure the way tile freeing is handled.  When a tile is removed from
the tile cache it's ssg elements are disconnected from the main ssg scene
graph, and then the tile is thrown on the end of a delete queue.  The
tilemgr->update() routine runs every frame.  It looks at this queue and if
it is non-empty, it incrementally frees the compents of the first tile
on the queue.  When the tile is completely free it is removed from the queue.

The amount of time to free the memory for even a single tile can be quite
substantial, especially with the increased overhead of dynamic/random
ground objects.  This change allows the system to spread the work of freeing
tile memory out over many frames so you don't get a noticable single frame
hit or stutter.

Restructuring how tiles are freed to allow us to eventually spread the task
out over multiple frames.

Fix random seeds to avoid coincident objects but still ensure
consistency.

Change the extra culling to do only a quarter of the scene every 200
frames rather than the whole thing, to avoid tiny stutters.

Added a new range-selector layer above each tile.  That way, by
default, each tile has only 3 extra SSG nodes unless it falls into
range.

Fix a problem with the culling of out-of-range random objects.  When
the triangles containing the objects were out of the view Frustum,
they were never traversed by ssg (and thus, never culled).  Now, every
200 frames, do a pass through the whole scene graph with cull-testing
disabled and without drawing anything; that will allow random-objects
to be collected incrementally.

Fixed a bug in FlightGear.py.  Splitting name,value,type using whitespace
failed on /sim/time/gmt-string because the raw value contains an embedded
space.  Now I use a regex instead of a plain split().  I also removed the
view_next and view_prev functions.  These will have to be replaced with
command properties.

I've also added a FGFSDemo.py script which is a python version of David's java program.

We require plib-1.4.2 or newer.

Save state before drawing '3d' panel, and then restore it after.

Removed some redundant glLight() calls.

This was an old version, so I replaced the contents with a pointer to
the newest version in the base package.

Patch to explicitely control the specular lighting component.

Support for fuel selector switch.

Renamed /sim/rendering/dynamic-objects to
/sim/rendering/random-objects, and changed the default from false to true.

Added more documentation.

Added --disable-random-objects and --enable-random-objects options.

More efficient version of get_bounding_radius from Norm Vine.

Enforce a sane minimum of 1000m for coverage, to avoid run-away object
placement.

Randomly-place object overhaul and enhancements
-----------------------------------------------

Fixed a segfault on exit.

Changed the radius of the dummy bounding sphere from 10m to 1000m to
ensure that FOV culling doesn't leave anything out.

Allow an object to have more than one variant model, which will be
chosen randomly.  Simply repeat the <path>...</path> property.

Removed the <billboard> property and replaced it with <heading-type>,
which can be set to "fixed" (leave the model oriented as it is),
"random" (give the model a random heading between 0 and 359 deg), or
"billboard" (always turn the model to face the camera).  The default
is "fixed".  Models look much better when they are not all facing the
same direction.

Allow the user to group models with the same visual range, so that
there can be *many* fewer nodes in the scene graph when the models are
not visible.  This causes an XML-format change, so that instead of

  <object>
   <range-m>...</range-m>
   ...
  </object>
  <object>
   <range-m>...</range-m>
   ...
  </object>
  ...

we now have

  <object-group>
   <range-m>...</range-m>
   <object>
    ...
   </object>
   <object>
    ...
   </object>
   ...
  </object-group>

Every object in a group can still have its own model(s), coverage, and
heading-type, but they all share the same range selector.

This change should already help users with tight memory constraints,
but it will matter much more when we add more object types -- for
example, we can now add dozens of different urban building types
without bloating the scene graph or slowing down the LOD tests for
tris that are out of range (i.e. most of them).

Moved object information into a new subclass of FGNewMat, and changed
the property name from coverage to coverage_m2.

Problem reported by Erik Hofman:

Replaced left-over std::cout statements with SG_LOG statements.

Patch from Cameron Moore:

* Rearranged member initializers

Patch from Cameron Moore:

* Fixed (un)signed comparisons

Patch from Cameron Moore:

* Rearranged member initializers

Patch from Cameron Moore:

* Fixed (un)signed comparisons
* Rearranged member initializers

Patch from Cameron Moore:

* Rearranged member initializers to shut gcc -Wall up

Patch from Cameron Moore:

* Fixed uninitialized values

Patch from Cameron Moore:

* Fixed uninitialized MaxAileron value (set to 0.5)

Make objects appear more smoothly and reliably.

More efficient rotation matrix calc from Norm Vine.

Significant speedup for randomly-placed objects, by taking better
advantage of ssg Frustum culling.

Modifed random-object code for more memory efficiency:

1. Only one copy of each object (and its texture) is stored in memory,
   no matter how many materials use it.

2. Random objects are added to a triangle only when the objects are in
   range, and they are deleted as soon as the objects are out of
   range.  That way, only a relatively small number of ssg nodes are
   used at any one time.

This patch seems to eliminate freezes when tiles are freed.  There are
occasional stutters at extremely high speeds (i.e. over 3,000kt), but
it seems smooth enough for normal aviation speeds.

More functional decomposition and documentation.

Fix some minor inconsistencies and inefficiencies:

- no extra nodes are created at all if the material has no random
  objects defined

- the range selector is place correctly under the transformation

- there is only one range selector for each object type in each
  triangle (experimental -- doesn't seem to make a difference in speed
  or memory)

This patch removes Curt's patch that randomized ranges slightly, since
individual random objects no longer have their own range selectors.
It also leaves the object-group-range value unused, for now.

Started functional decomposition for dynamic objects.

Fixed typo in last patch, where objects were using object_group_lod
rather than object_lod.

put a separate LOD node in front of ever random object so we can randomize
the exact pop in location of each object ... this allows us to put some objects further out and perhaps hide the popping just a tiny bit?

Added support for dynamically-generated scenery objects.  Set the
property /sim/rendering/dynamic-objects to true to enable them.

Member variable initialization fixes from Cameron Moore

Fixed typo in SetGammaFallback()

Change FGSteam into a proper subsystem rather than a collection of
static methods, and remove outdated dependency in panel_io.cxx.

Patch from Julian Foad:

- tidies up the update-time-step handling (making it a simple "dt");
- makes the altimeter get a proper pressure, and the (unused) vacuum
  calculation get a proper RPM (*);
- replaces property name look-ups with static pointers to property nodes.

Notes from DPM:

- the static pointers are a very bad idea, but they're only temporary;
  I plan to make FGSteam into a proper subsystem soon, and then they
  can be member variables
- I fixed the patch to get the current static pressure from the
  /environment/pressure-inhg property, so that the altimeter interacts
  properly with FGEnvironment

Patch from Julian Foad:

The present sets of bindings result in the throttle being "squared"
about its centre, which is silly.  This is because the "squared"
parameter is not set by the throttle binding, but the default is
"true".  We discussed this before and I think there was general
agreement that the default should be "false" on the basis of
generality.

Patch from Julian Foad:

May I offer this patch which will help non-Linux users find their
joysticks' names.

Remove a kludge that was introduced to work around the #defined "NONE".

Change identifiers to their new names to match hud.hxx.

Prefix "HUD_" (or "HUD_FONT_" in two cases) to #defined identifiers.
Remove some unused #defines (not mentioned anywhere, even in
comments).

Update controls so we can specify each tank on/off individually.  Also
updated the network interface files to add fuel tank selector information.

Oops, fixed a typo.

Added a fuel selector switch.  I understand that this won't handle all
situations for every kind of airplane.  But at the moment we have nothing
implimented and this will cover the simpler cases until someone has a
chance to impliment a fuller solution.

Switch to snprintf() for safety.

MSVC fixups.

Added interface to ATC xponder hardware.

Initial revision of a Bendix/King KT 70 transponder.

Fixed up a couple loose ends.

Modified to use named-joystick bindings when available (js-named
rather than js).  This functionality is available only with recent CVS
plib versions (i.e. since about May 2002).

A bunch of reorg and clean up of the KR 87 (adf) code including some
property renaming with corresponding changes to instruments in the base
package.

Updated adf property names.

A couple ADF needle direction tweaks.

Add support for KR 87 annunciators.

Patch from Dave Luff to use dt properly in CHT calculation.

Fix a bug reported by Frederic Bouvier:

GL/gl.h can't be included at the first position in windows. It requires
the inclusion of windows.h that must be included in other fgfs header
file. I only move down #include <GL/gl.h>

Commented out a cout statement.

Default to ADF (rather than ANT) mode and start with the ADF turned on.
Oops, left in a debugging statement.

- Oops, some name simplification led to overlapping variable names which caused
  the adf needle to not point correctly, fixed.
- Make the code slightly smarter so ADF needle never takes the long way around
  to it's destination.

Fixes for IA-64 with Intel compiler.

Updated hardware interface to match new KR 87 features.

Working on implimenting the timer features of the King KR 87 ADF (as well
as some of the other subtleties.)

Allow the default GUI font to be set via properties.

Patch from Melchior Franz:

This patch eliminates about 10 of valgrind's "Use of uninitialised
value of size ..." messages. They are all caused by approachlist building
incomplete FGApproach class instances and then copying them into the
approchlist container, hence copying data garbage.
   I know, I couldn't win a beauty contest with this patch, but the
alternative approach -- letting operator<< always leave complete
entries -- didn't look any better. And I do only add those seemingly
useless initialization where the values would be used uninitialized
else. The constructors are only run during setup and won't slow fgfs
down at runtime.

Fixed an uninitialized variable reported by Frederic Bouvier; this
could cause the FDM occasionally to get caught in a very long loop.

Update from JSBSim - fix bugs reported by Gonzalo Peralta with CHT and
oil pressure.

Patch from Julian Foad:

Fix float/int mis-match warnings.

Patch from Julian Foad:

Use defined constant instead of yet another approximation to pi.

Patch from Julian Foad:

Make locally-used strings local instead of global.  (The safety and
cleanliness benefit outweights the slight performance hit.  If
performance is an issue, the way these strings are used should be
optimised.)  Use existing defined constant instead of a literal
number.

Patch from Julian Foad:

Remove trailing comma (unportable).

Patch from Julian Foad:

Remove redundant class scope qualifiers.  (Should not be used within
class definition.)

Patch from Julian Foad:

Remove unused variable.

Patch from Julian Foad:

Newline at end of file is required.  (On a preprocessor line it is
required; on other lines it is recommended but not required.)

Patch from Melchior Franz:

- fix error message
- add PThread rule (needs valgrind >= 20020603)
- add missing files to .cvsignore

Patch from Cameron Moore:

The patch fixes the uninitialized values by explicitly starting
everything at sea_level values.

3D panel support from Andy Ross:

+ The panel(s) are now an first-class SSG node inside the aircraft
  scene graph.  There's a little code added to model.cxx to handle the
  parsing, but most of the changes are inside the new FGPanelNode
  class (Model/panelnode.[ch]xx).

+ The old FGPanel source changed a lot, but mostly cosmetically.  The
  virtual-cockpit code moved out into FGPanelNode, and the core
  rendering has been abstracted into a draw() method that doesn't try
  to set any OpenGL state.  I also replaced the old inter-layer offset
  code with glPolygonOffset, as calculating the right Z values is hard
  across the funky modelview matrix I need to use.  The older virtual
  panel code got away with it by disabling depth test, thus the "panel
  draws on top of yoke" bug.  PolygonOffset is really the appropriate
  solution for this sort of task anyway.

+ The /sim/virtual-cockpit property is no more.  The 2D panels are
  still specified in the -set.xml file, but 3D panels are part of the
  model file.

+ You can have as many 3D panels as you like.

Problems:

+ The mouse support isn't ready yet, so the 3D panels still aren't
  interactive.  Soon to come.

+ Being part of the same scene graph as the model, the 3D panels now
  "jitter" in exactly the same way.  While this makes the jitter of
  the attitude gyro less noticeable, it's still *very* noticeable and
  annoying.  I looked hard for this, and am at this point convinced
  that the problem is with the two orientation computations.  We have
  one in FGLocation that is used by the model code, and one in
  FGViewer that is used at the top of the scene graph.  My suspicion
  is that they don't agree exactly, so the final orientation matrix is
  the right answer plus the difference.  I did rule out the FDMs
  though.  None of them show more than about 0.0001 degree of
  orientation change between frames for a stopped aircraft.  That's
  within an order of magnitude of what you'd expect for the
  orientation change due to the rotation of the earth (which we don't
  model -- I cite it only as evidence of how small this is); far, far
  less than one pixel on the screen.

[and later]

OK, this is fixed by the attached panel.cxx file.  What's happened is
that the winding order for the text layer's polygons is wrong, so I
reverse it before drawing.  That's largely a hatchet job to make
things work for now, though.  We should figure out why the winding
order is wrong for only text layers and fix it.  I checked the plib
sources -- they're definitely doing things CCW, as is all the rest of
the panel code.

Odd.  I'm also not sure why the 2D panel doesn't care (it works in
both winding orders).  But this will allow you to check in working
code, anyway.  There's a big comment to this effect in there.

Half-finished utility class.

Added files that only I use locally; it shouldn't hurt anyone else.

Updates to the OpenGC interface from John Wojnaroski.

Initialize a value so we don't see non-deterministic behavior.

Wrong units when interpreting <weight> tags.

Hack in an /accelerations/pilot-g property, for testing a new panel
instrument.  This needs to move somewhere permanent.

Also, remove a bogus fuel consumption setting that (1) was off by a factor
of 3600 (hours, not seconds) and (2) collided with identical code in FGFDM.

Allow an empty virtual model, to which other submodels can be attached
(when no path is specified).

Avoid a segfault when a named object is not found for an animation.

Ensure that global animations are applied to the model.

Added fgAddChangeListener convenience functions.

Updated to match changes in radiostack.[ch]xx

A little prepratory code reorganization before modeling the King KR 87
Silver Crown Digital ADF.

Finally fixed the flap drag issue.  Drag modifications need to be based on
the amount of drag that the produced lift *would* have produced given an
unflapped air surface.  A nifty trick involving the assumption that AoA is
small works for this, and produces plausible results in the high AoA case
as well.

Also, trim for approach using the elevator-trim control, not elevator.
Just cosmetic for current planes, but future ones might have differing
implementations of trim.

Erik Hofman:
Specify default values for properties so we get expected behavior when
an option isn't specified in the sound config file.

Andy Ross:
Fixes for uninitialized variables.

Erik Hofman:
This is the small code fix which is needed for the new options.xml file.
It is needed because otherwise the "--prop:name=value" is showed
incorrectly.

There is another problem though, when compiling with --without-logging
the help message isn't displayed at all! We *must* change that somehow.

Curt: good point, the SG_LOG()'s have been switched to cout's ...

Bugfix.  The engine thrust is recalculated based on the current N1 value
(and not the throttle setting), but the recalculation left in a degeneracy
when the target/throttle setting was exactly zero.  Zero times a big number
is still zero.  Fixed to use real math, not theoretical math.

Updates to the 610x interface:
- More progress with proper radio freq tuning and proper interpreting of the
  hardware values.
- Filter ignition and flap switch values since the hardware implimentation has
  a dead zone where the value can go to zero in the middle of a change in
  switch position.

Erik Hofman:
I've updated the FIXME in the code, and fixed a typo (descr instead of
description), but the SG_LOG() functions doesn't produce any output for
me. Could you confirm it's still working for you?

Curt Olson:
I did a bit of further tweaking and it all looks good now.  The tricky thing
is that SG_LOG() always appends an endl at the end of every message.

Erik Hofman:
This patch solves an unknown reference to a function which showed up
when using no-inlining.