Templates for interacting with OSG objects

Template functions and overloaded functions for accessing property values.

These are useful for writing templates that manipulate properties.

Manuel Massing:

Attached is a small fix for the sorting in CloudShaderGeometry.cxx.
I think the sorting problem stems from the osg idiosyncracy
to store transposed matrices...so the intuitive

       osg::Vec4f p = vm * osg::Vec4f(_cloudsprites[i]->position.osg(), 1.0f);

needs to be replaced with...

       osg::Vec4f p = vm.preMult(osg::Vec4f(_cloudsprites[i]->position.osg(), 1.0f);

The patch also optimizes the distance calculation - it evaluates the distances
in model space instead of eye space, which reduces computation to a dot-
product instead of a matrix multiplication.

Stuart Buchanan :
It fixes the following issues (to a greater or lesser extent):
1) Performance. Quad trees used to improve culling, and the sprites are placed on the surface of a sphere rather than
randomly throughout the cloud, requiring fewer textures. This saves about 5-10fps on my machine.
2) Disabled 3D clouds have no performance impact. Previously they were still in the scenegraph. Now they are removed.
3) Clouds are now loaded on start-up, and don't require the scenario to be changed, they also work with METAR.
4) The cloud field is shifted as you travel. There's a small bug in that the clouds "jump" as you reach the edge of the field.
5) Iterative sorting of sprites. This doesn't appear to solve the alpha blending problem completely, but may help a bit.

Respect precipitation-enable property

From Csaba Halász

enable world coordinate particle fix

Tidy up for a source code "snapshot" release.

3D clouds from Stuart Buchanan. Need a recent driver update, --enable-clouds3d option and a Weather Scenario to show up

Fix a few spelling errors.

fix regression: sgLoad3DModel_internal should not make assumptions
about the type of SGModelData. This *can* have to do with Nasal,
but doesn't have to. That's entirely that class instance's business.

add global switch for particle systems

allow to modify the XML animation config of a loaded submodel by
defining an <overlay> branch, which is copied over the submodel's
properties before the animations are evaluated

Move omit-node part from startElement to endElement to allow nodes
of this type to have children. We have to save the omit state on the
stack for that.

Syd Adams: Replace rgb with png.

s/multiplayer/multiplay/, as this seems to be the slightly more
official version (--multiplay option, /sim/multiplay/ properties etc.)

if a model XML file contains a <multiplayer> block, copy its contents
 to the model's property root (/ai/models/multiplayer[*])

Yeah, I really shouldn't be in the lexer

Another lexer fix

Fix broken lex.c checkin

Fixes for bugs shaken out in the recent push: die properly for nil
indexes in slices.  Fix string conversion issue with bare "+" and "-".
Fix lexing of exponent expressions such that "1e" is not a number.

MINGW patch by Csaba Halasz

Fix parsing for degenerate cases like a[,] a[:] and {:}.  The slicing syntax exposed the low-level generators to some new cases.

Sync with Nasal upstream (Melchior already had a chance to test this,
so hopefully not too much breaks).  New syntax features:

1. Call-by-name function arguments.  You can specify a hash literal in
place of ordered function arguments, and it will become the local
variable namespace for the called function, making functions with many
arguments more readable.  Ex:

   view_manager.lookat(heading:180, pitch:20, roll:0, x:X0, y:Y0, z:Z0,
                       time:now, fov:55);

Declared arguments are checked and defaulted as would be expected:
it's an error if you fail to pass a value for an undefaulted argument,
missing default arguments get assigned, and any rest parameter
(e.g. "func(a,b=2,rest...){}") will be assigned with an empty vector.

2. Vector slicing.  Vectors (lists) can now be created from others
using an ordered list of indexes and ranges.  For example:

   var v1 = ["a","b","c","d","e"]

   var v2 = v1[3,2];   # == ["d","c"];
   var v3 = v1[1:3];   # i.e. range from 1 to 3: ["b","c","d"];
   var v4 = v1[1:];    # no value means "to the end": ["b","c","d","e"]
   var i = 2;
   var v5 = v1[i];     # runtime expressions are fine: ["c"]
   var v6 = v1[-2,-1]; # negative indexes are relative to end: ["d","e"]

The range values can be computed at runtime (e.g. i=1; v5=v1[i:]).
Negative indices work the same way the do with the vector functions
(-1 is the last element, -2 is 2nd to last, etc...).

3. Multi-assignment expressions.  You can assign more than one
variable (or lvalue) at a time by putting them in a parenthesized
list:

   (var a, var b) = (1, 2);
   var (a, b) = (1, 2);               # Shorthand for (var a, var b)
   (var a, v[0], obj.field) = (1,2,3) # Any assignable lvalue works

   var color = [1, 1, 0.5];
   var (r, g, b) = color;  # works with runtime vectors too

Keep non-local particles in a Z-up frame that is periodically moved.

This eliminates jitter and other rendering problems.
For the moment this is dependent on an osg fix.

Also, don't read wind properties from FlightGear; provide a mechanism
for fg to set the wind.

Make sure the compiler is aware that SGModelData a child of osg::Referenced, now gcc-3.3 will compile.

Use a more relevant library name

Update version

Don't use osgDB::SharedStateManager::share in SGLoadTexture2D

It is not safe to call this function from the database pager thread;
in any event, state sets and textures created in the database pager
will get passed through the SharedStateManager anyway.

- Update SimGear.dsp
- Assign an arbitrary prerelease version number
- Fix a "make dist" problem.

Fix typing error with fgetc in readln().  On most boxes, this would
cause a spurious EOF when there was a 0xff in the stream.  But on PPC,
char is unsigned (for reasons known only to IBM) and it would loop
forever.

pointers in Particles object should be ref_ptr

Return eof after a number of reptetitions of file input.

Update MSVC 7.1 projects - Adapt to OSG 2.6.0-rc1 : location of header files should now be searched in the install directory, here ..\..\..\install\msvc71\OpenSceneGraph\include

final fixes for SG_USING_STD removal

forward declare osg::DrawElementsUShort for real

Replace SG_USE_STD() by using std::

GL/wgl.h never existed, and a glx equivalent is not needed

 - remove the SG_GLxxxx_H #defines, since OSG provides its own versions
 - this exposed a bizarre issue on Mac where dragging in <AGL/agl.h> in
   extensions.hxx was pulling in all of Carbon to the global namespace
   - very scary. As a result, I now need to explicitly include CoreFoundation
   in fg_init.cxx.
 - change SG_USING_STD(x) to using std::x

Issues:

 - the logic for X11 and Win32 in RenderTexture and extensions is tortured,
   please see if you agree I got all the ifdefs correct.

Remove unneeded inclusions of windows.h, GL.h and GLU.H

Maybe a more portable way to do it

Compile again with MSVC

Reduce compiler.h to almost nothing (but it's worth keeping around I think, for
the MSVC and MipsPro warning stuff).

As a result of this patch, simgear/sg_traits.h can be deleted. So can SGCMath.h,
but I'll do that separately.

There is one more 'mechanical' change to come - getting rid of SG_USING_STD(X),
but I want to keep that separate from everything else. (There's another mechnica
l change, replacing <math.h> with <cmath> and so on *everywhere*, but one step a
t a time)

Attached patches remove BORLANDC, and hence SG_MATH_EXCEPTION_CLASH and SG_INCOM
PLETE_FUNCTIONAL from SimGear and FlightGear.

As a result, SG_HAVE_STD_INCLUDES is now *always* set, so I will get the boring
fixes for that done, but separately. I'm still auditing the other things in comp
ilers.h - there's a lot that can die now BORLAND is gone.

remove a workaround for the C++ / stdlibary bug which existed aeons ago on Mac.

Patch to remove macintosh and MWERKS from Simgear.

Add repeat option to SGFile.

This supports auto-looping over a playback file, for demos and such.

Eliminate empty default constructor for SGReaderWriterBTGOptions

s/getChild/getNode/  (otherwise "start/size" wouldn't work)

- XML interface changes:
  * condition at top level
  * <start|end>/<color|size> hierarchy
  * wind/gravity -> bool
  * rename some properties (rotspeed -> rotation-speed, etc.)
  * unit suffixes
- remove redundant code
- warnings--

fix SGPropertyNode::LAST_USED_ATTRIBUTE

write-protection warning: use simplified path

let readProperties() refuse to overwrite write-proteced properties

remove redundant #defines (they are already in compiler.h)

From Benoit Laniel: replace SG threading constructs with those from OpenThreads

Also, move any static local mutexes up to global level.

Update MSVC 7.1 projects

warnings--

add OSGVersion.hxx to VC7.1 project file

OSG DatabasePager interface change in 2.5.1

Move OSG version macro from FlightGear to simgear

Replace header files istream and ostream with iosfwd

Don't include <iostream> and "using" declarations in header files

<iostream> sucks in expensive initialization of the standard streams
and isn't appropriate in a header file. Use <istream> and <ostream>
instead.

using declarations should never appear at global scope in a header
file; source files get to decide what they want to use in their
namespace.

Fix non threadsafe code

Report abnormal condition

Update MSVC 7.1 projects

Fix a problem in loading models with paged LOD in some circunstances ( debug with MSVC for instance )

Use bool instead of int to represent boolean values

xmlsound: warning--

add <delay-sec> parameter that defines how many seconds after triggering
the sound should be played (default: 0)

update library version requirements

Win32 fix

sg: move most scenery-related code to simgear

From Till Busch

Till BUSCH: enable HOT intersection tests on random buildings

Nicolas: let SGPath::create_dir() return success/failure (for screenshot)

Till BUSCH:

"tim recently noticed the database pager was repeatedly loading and unloading
the same objects. he also tracked down the problem to missing bounding sphere
information in osgDB::PagedLOD. this is a simplicistic approach to fix this:
SGPagedLOD will now remember whatever value it sees for getBound() after
loading a child. this patch will make database pager run much calmer."

Fix new livery code

It turns out that the database pager causes the texture image to be
unloaded after it is applied, so the image and its file name may not
be available for doing the livery substitution. Ask a work around we
set the name of the texture to its file name.

Update MSVC 7.1 projects

Rewrite livery texture replacement to copy StateSet objects

Also, add a NodeAndDrawableVisitor that descends into osg::Drawable.

That motivation for this is that it's a bad idea to modify state sets
that the osgDB::SharedStateManager might be keeping.

Till BUSCH:

this is a small (-1/+3) patch to fix pick animations on scenery objects.
since picking apparently doesn't care for polygon offsets, the objects
got into the picklist in the wrong way. now, no matter if the "highlight
group" or the "normal group" gets hit first, the callback will fire.

rewrite of sky dome code

Add more points to the dome, giving it a dome shape rather than a
dunce cap shape.

Represent as OpenGL DrawElements instead of as triangle strips.

Only calculate have the sky colors and reflect those across the dome.

Update MSVC 7.1 projects

Fixes for compiling with gcc 4.3

Include standard header files and qualify with std:: where needed.

Add "const" to various char parameters and variables.

Allows to load submodels with path relative to current model path.
Submodel path must be prefixed by ./ otherwise path is relative to fg_root ( current behavior )

Change the tile light group node mask to traverse VASI lights too.

The change to set the light group node mask to LIGHTS_BITS caused
VASI/PAPI lights to not be displayed during the day. This patch fixes
that and optimizes VASI creation a bit.

Update MSVC 7.1 projects

Win32 fix

model paging patch from Till Busch

Comments from Till:
I started the project at the end of february with a simple idea: move all
3d-model loading to the DatabasePager-thread. my first attempts looked
promising, though they were a little too optimistic (or naive?). the patch
has evolved a lot since.

currently it does the following things:
1. revive SGModelLib, move functions for xml-model-loading there

2. replace all calls to sgLoad3dModel with calls to either
SGModelLib::loadModel() or SGModelLib::loadPagedModel()
almost all models will be loaded by the DatabasePager. the few exceptions are:
your own plane, shared models in scenery, random objects, AIBallistic models.

3. simplify mode-loading functions (avoid passing around fg_root)

4. avoid supurious MatrixTransform nodes in loaded models

5. fix some memory leaks

- warnings--
- make one-shot sounds subject to volume and pitch control (To get
  constant volume/pitch during the whole lifetime, just *configure*
  the sound that way.)

rationalize node masks a bit

argh, missed 1.8.4 in one spot.

Simgear also enforces plib-1.8.5 in order to build.

From Till Busch: use install -p if possible

Update MSVC 7.1 projects

use new arrow shortcuts for compatibility reasons (will be removed later)

cleanup of precipitation contribution

Reindent everything to Stroustrup style and make member variable style
consistent.

Remove unused header files.

SGPrecipitation is now a subclass of osg::Referenced.

Initialize snow and ice intensity to 0 directly. The methods that set
the intensities change the value slowly and so don't work when the
initial value is garbage.

precipitation effects from Nicolas Vivien

Add methods to SGGeod to return OSG Matrix objects for local frames.

Methods have been added for Z down (simulation) and Z up frames.

Initialize variables before using them

Olaf Flebbe: Micro update to the MSVC8 Project files.

Update MSVC 7.1 projects

don't reset visibility modifier in the M5SM case

Syd ADAMS: remove season suffix, this is now done via <condition>s