Cleaned up comments to tile entry code

Till Busch:

As discussed with Tim on irc: Here is a quick fix for the memory-hungry tile
manager. Due to bugs in FGNewCache, old tiles were never deleted.

I left the timestamp-updates in the cull-traversal. but imho things work
just as well when timestamps are updated in FGNewCache::insert_tile() and
FGNewCache::get_tile()

Lee ELLIOT: documentation for autopilot PID & PI controllers

Roy Vegard OVESEN & Lee ELLIOT:

Lee has added two new filter types, "gain" and "reciprocal". These filters can
read their gain factor from a property. In the process we also added minimum
and maximum output clamps that are applicable to all filters.

I added the ability to configure adaptive controllers i.e. the controller gain
can be tied to a property, so that it can be changed at runtime. This
requires a change in the xml structure of the autopilot configuration file:

<Kp>
  <prop>/autopilot/KAP140/settings/ROL/Kp</prop>
  <value>0.10</value>
</Kp>        <!-- proportional gain -->

The old method <Kp>0.10</Kp> still works so as to not break all existing
autopilots, but it will output a warning to use the new method.

Csaba HALASZ: implement conditional (e.g. seasonal) texture loading at startup

Wingman code from Vivian Meazza

Call particle initialization code in simgear namespace

particles from Tiago_G

Toggle tree effect on /sim/rendering/random-vegetation property

The Concorde Maintainer:

- replace hardcoded name "inst-vertical-speed-indicator" by the one from
  the instrumentation config

mf: some indentation fixes, remove redundant block

any wind < 1kt is "calm", not just 0.0

cygwin related fixes, and some minor future release related maintenance
work.

Roy Ovesen:

Please find attatched a new version of xmlauto.cxx.

Remove the call to build() in reinit(). This prevents build() from being
called twice when Reload Autopilot is selected from the Debug menu.

I've also added the ability to define an enabled property for the filters.
It's used like the PID controllers. If there is no enabled tag then the
filter defaults to enabled so that nothing should get broken by this change.

This ability can be used to create a filter between the output of a PID
controller and the property that it controls (a control surface). By putting
a noise spike filter between the output of a controller and the control
surface that it controls, we can simulate the limited movement rate that is
inherent in autopilot servos.

Maik: remove tow end force smoothing.

Daniyar ATADJANOV:

This patch contains bugfixes from my previous patch
 (i made mistakes when using "diff" utility last time):

    1. Now ATC do not tells us to go around because of
       traffic on RWy, when that traffic is WE.
    2. Now ATC don't say that we must follow ourself
       (like "GFS, number two, follow GFS on final").

And new Tower-ATC features:

    1. Requesting departure clearance. When you are
       on taxiway, you can request departure clearance.
       Tower will answer with something like:
       "Line up runway two eight right".

       TODO: check if any AI-Planes on final and tell
       something like: "After the landing AI-CALLSIGN
       line up runway two eight right".

    2. Requesting take-off clearance. If you are on
       runway, you can tell to ATC that you are ready
       for take-off. So, Tower will tell you that you
       are cleared for take-off (or immediate take-off).

    3. Reporting landing gear position on final by pilot.
       If you are on aircraft, which landing gear can
       be UP, when reporting final you will tell
       "Gear down, ready to land".

    4. Reporting landing gear position on final by ATC.
       When i was newbie and was flying on Cessna 310, i
       ALWAYS forgot landing gears on final. Now if you are on
       final and forgot landing gear, Tower will tell you:
       "LANDING GEAR APPEARS UP" or "Check wheels down and
       locked". So you will have some time to push gear
       down or execute missed approach ;)

    5. ATIS phonetic ID in requesting landing message.
       In FG pilots says: "for full stop with ATIS" everytime
       (when airport doesn't have ATIS too). But in real life
       pilot saying phonetic ID of ATIS message. Now we have:
       "for full stop, information alpha ... / ... zulu".
       If airport doesn't have ATIS, pilot don't say this.

       TODO: add this feature to AI-Planes too.

     6. Advising weather condition in airport by Tower.
        If you are requesting take-off or landing in airport
        that doesn't have ATIS service, Tower will tell you
        about wind direction and speed, visibility and QFE.

     7. Reporting downwind if missed approach. When some AI-Plane
        is on final FG's ATC tell you to "continue approach".
        And then you lost radio transmission. Now ATC says:
        "continue approach and report left/right downwind".
        And now we have "Report Downwind" entry (button)
        in "ATC Communication" form.

Clear chat messages when an aircraft becomes inactive in the property tree.

set MAX_ENGINES=12 (10 aren't enough for the DO-X)

near and far are #defined in MSVC

Fix main window aspect ratios other than 4/3

This also fixes distortion weirdness in the osgviewer version. That
was caused by osg::GraphicsContext getting in the act on resize events
and adding its own scaling to the projectionOffset of slave cameras!

Another round of memory leak fixes from Till Busch

remove last traces of PSL

Fix leak in interpolate().  Also give property nodes a name so they
look better in debug output

Packet should be formated in network byte order.

Memory leak fixes from Till Busch

Update MSVC 7.1 projects

segfault in fg_fx.cxx fix

Check for null fx node, submitted by Tiago Gusmão.

Josh Babcock:
I got tired of watching all those http requests scroll over the screen, so I made them SG_LOG( SG_IO, SG_INFO, );

FB: adapt a bit

Martin Spott:

Fix that reorders osg libs to make FreeBSD happy.

Remove an incorrect use of AM_CONDITIONAL()

Add checks to avoid writing NaNs into the scene graph transforms

OS X build fixes from Hans Fugal

cleanup of dead code and change ViewPartitionNode::makeNewProjMat be public static

Ballistics underslung load changes from Vivian Meazza

add ViewPartitionNode to VS project

Add ViewPartionNode to the scenegraph

ViewPartitionNode addresses Z-fighting issues by rendering near and far
parts of the scene seperately.

Return the --fov= to it's original functionality.

Ballistics fix from Vivian Meazza

Modified Files:
src/Main/renderer.cxx: Use osg::Hint instead of glHint.

Modified Files:
fg_os_osgviewer.cxx: Use the DISPLAY environment variable
if not set otherwise.

Remove references to SceneView and CameraView

Experimental patch for applying force to ballistic objects

From Vivian Meazza

s/no-warning/depreciated/, so people adding that to custom huds understand
better what they are doing  :-)

depreciation warning for users of old custom HUDs

Fix tabs and spaces. No overflow risk here

Fix for "falling through ground" problem

The LOD far range on the tile entry scenegraph node was initialized to
0. This meant that any traverals of active children that happened
before the tile manager updated the node would ignore the node
altogether. Among these is the groundcache traversal which was failing
at startup even though scenery was loaded.

Also added a function to dump scene graph nodes to files; very handy
in gdb.

Update MSVC 7.1 projects - compile with osgViewer instead of glut

Added copyright to SceneryPager. Removed FGTileLoader

Check if request has already been satisfied

schedule tiles in Inited state if we get a valid bucket

Set up pager in GLUT embedded osgViewer

Use the OSG DatabasePager instead of FGTileLoader

Make an OSG file reader for .stg files.

New class flightgear::SceneryPager, which is a subclass
osg::DatabasePager to handle explicit delete requests.

Modify FGNewCache, FGTileEntry, and FGTileManager to use
SceneryPager. Mostly this involved removing the queues that talked to
FGTileLoader.

Calculate accurate tile timestamps from the time they are traversed in
the cull stage (which means that they are visible) instead of updating
them periodically.

Replace tile entry transform and range node with one LOD node

Update GroundLightManager

Also use GroundLightManager to manage light node masks.

Fix mouse warping for embedded osgviewer in SDL

As in the GLUT implementation, let the FGManipulator drain its event queue.

Handle warped pointer in embedded GLUT osgViewer

Signal the FGManipulator that a warp has occured so that it can drain its
event queue, but otherwise no warp handling is done in GLUT specific code.

Make sure fgfs finds the correct version of the base package.

Check if scenery is available before blowing away existing values in ground cache

This fixes a race condition when teleporting somewhere outside of the
currently loaded scenery. Before, if there was no valid scenery, an
aircraft might end up at the center of the earth...

Use a render target fallback that works in any case.
Avoids a crash on dri cards on linux.

Maik: add ROTORBALANCE axis.  Fix spelling of ROTORRELTARGET.

Tatsuhiro NISHIOKA: initialize classes (fixes segfault on exit on MacOS)

add some generic properties for free use

Check for valid multiplayer packet.

Instead of just reporting that the magic number, length, etc. of a
multiplayer packet is invalid, abort processing this packet. Also,
check if enough space remains to send a property string.

Add an option to FGTextureManager to create dynamic textures.

Dynamic textures shouldn't have their STATIC attribute set.

Changed GLUT support to use an embedded osgViewer too

- move exception handling from init() and childAdded() to add_model()
- tell why loading a model failed

tell *why* loading a model failed

Various updates.

add runway number as "id" to the runway hash within an airport hash
(It's already available as runway hash key, but the runway hash shouldn't
depend on it and be self-contained.)

backport from JSBSim/cvs: apply prop sense only once  (OK'ed by JSB)

Win32 fix

make the state of the Meta and Super modifier keys available. These keys
are not available out-of-the-box on all systems and keyboards, and should
therefore not be used in files committed to CVS. This makes them well
suited for local key bindings, as they aren't likely to get overwritten
with later releases. SDL supports Meta and Super, OSG supports only Meta,
and GLUT supports neither.

(Somehow this part escaped the previous commit. :-)

read key code and modifiers back in after event interface call

- minor command update (loadxml, savexml, property-scale)
- add <condition> and <mod-{up,shift,ctrl,alt,meta,super}>
  example to key definition description

add <mod-meta> and <mod-super> XML elements for key bindings

make the state of the Meta and Super modifier keys available. These keys
are not available out-of-the-box on all systems and keyboards, and should
therefore not be used in files committed to CVS. This makes them well
suited for local key bindings, as they aren't likely to get overwritten
with later releases. SDL supports Meta and Super, OSG supports only Meta,
and GLUT supports neither.

Rewrite SDL code to use an embedded osgViewer.

This uses the osgViewer infrastructure instead of setting up and osg::SceneView.
When the same change is made for glut, much of render.cxx can be deleted.

move callback registration functions to fg_os_common.cxx

backport of code using ModelRegistry

Move to loading tiles and their submodels only by name.

Some cleanup in tileentry.cxx, but mostly code to implement loading of tiles
and their models without reference to FGTileEntry or SGBucket structures.
Also, don't do deferred model loading; load them when the tile is loaded.

Tiago GUSMAO: keep sound muted after pause/unpause

initialize _material pointer in FGGroundCache

_material was uninitialized. This was causing a segfault with
as-yet-to-be-checked-in paging code; I don't know if it ever resulted
in a segfault with the old tile loader, but it certainly could have.

Add a command to dump just the terrain portion of the scene graph to a .osg
file.  Possible uses of this functionality could include converting the
model to some other format or coordinate system for use in some other
visualization or simulation.

Minor documentation update.

initialize release_keys array

Changed to use getId() instead of using a direct iterator comparison,
because MSVC8 crashed on that.

Olaf Flebbe: Add a few new files to the MSVC projects.

- move temporary keyboard fix from input.cxx to fg_os{,_sdl}.cxx.
  This is required to make sure the same letter key gets released,
  which got the press event. (After Ctrl-press -> a-press -> Ctrl-release
  a-release we want the Ctrl-a binding released, not the a binding.)

- add key listener interface for direct key access from Nasal space

also copy name & type to /sim/current-view
That's useful for animations, and we can't rely on numbers. And shouldn't.

Move some values exclusively used by LaRCsim to LaRCsim

don't overwrite rudder position with nose wheel position

mainloop: move event_mgr and viewmgr updated before spatial sound calculations

move event_mgr and view_mgr bundle right before the requestRedraw()
This fixes the last jitter problems with views attached to MP/AI
objects, and doesn't seem to cause any new ones.

change update order to fdm -> events -> viewmanager
This removes some jitter in cases where Nasal is used to set up view
parameters from FDM data, such as position and orientation. (The event
subsystem handles Nasal's settimer() calls.)

revert swapping of x & y offsets in "lookat" mode
This was correct in the old repository and in revision 1.1 of the new,
but then broken in revision 1.2. After that, "lookat" and "lookfrom"
mode used different coordinate systems, and the "Adjust View Distance"
didn't work correctly in "lookat" mode.

Csaba HALASZ: fix IVSI instrument problem

"I have been investigating the Concorde IVSI problem. I came to the
conclusion that the trouble is that the environment altitude and thus
the pressure (which is calculated from that) is lagging by 1 frame.
Normally that wouldn't be a problem, but the IVSI calculates rate of
change and it will use the new dt with the old value difference,
thereby arriving at bad results if dt changes (and it does)."

sorting nodes -> don't use shared pointer

Add a --vehicle= option which is a synonym for --aircraft= but is more
natural when selecting ground vehicles like a jeep or a snowplow.

sort entries alphabetically (consistent with property browser)

try to fix yet another crash bug (don't worry, there's one for anybody!)

re-active commented out "delete". Doesn't seem to crash anymore.

unescape \a and \b as well