forcing users to use osgDB::readRef*File() methods. The later is preferable as it closes a potential threading bug when using paging databases in conjunction
with the osgDB::Registry Object Cache. This threading bug occurs when one thread gets an object from the Cache via an osgDB::read*File() call where only
a pointer to the object is passed back, so taking a reference to the object is delayed till it gets reassigned to a ref_ptr<>, but at the same time another
thread calls a flush of the Object Cache deleting this object as it's referenceCount is now zero. Using osgDB::readREf*File() makes sure the a ref_ptr<> is
passed back and the referenceCount never goes to zero.
To ensure the OSG builds when OSG_PROVIDE_READFILE is to OFF the many cases of osgDB::read*File() usage had to be replaced with a ref_ptr<> osgDB::readRef*File()
usage. The avoid this change causing lots of other client code to be rewritten to handle the use of ref_ptr<> in place of C pointer I introduced a serious of
templte methods in various class to adapt ref_ptr<> to the underly C pointer to be passed to old OSG API's, example of this is found in include/osg/Group:
bool addChild(Node* child); // old method which can only be used with a Node*
tempalte<class T> bool addChild(const osg::ref_ptr<T>& child) { return addChild(child.get()); } // adapter template method
These changes together cover 149 modified files, so it's a large submission. This extent of changes are warrent to make use of the Object Cache
and multi-threaded loaded more robust.
git-svn-id: http://svn.openscenegraph.org/osg/OpenSceneGraph/trunk@15164 16af8721-9629-0410-8352-f15c8da7e697
into this. This has been done to rework code nearer to what Stephan Huber
used to get round a crash under OSX when a model was passed in. This crash
suggest a problem in dynamic_cast<> perhaps?
the text implementation to provide better speed, especially by using the
alignement to screen option.
Deprecated the Text::setFontSize(,) method, which is now being replaced
by setFontResolution(,)
Fixed typos in Texture*.cpp.
Removed old deprecated methods from osg headers.
leaving it up to the Viewer to specify the mode (which by default is MultiThreaded).
Added a check for the presence of osgParticle systems so that threading is
disabled in this case.
o Object files now go in subdirectories named $(OS)$(ARCH).Opt and
$(OS)$(ARCH).Debug for OS's that support both architectures.
eg. Linux32.Opt and Linux32.Debug
o Libraries links are now placed in lib/$(OS)$(ARCH)
eg. lib/Linux32/
o Binaries are now placed in bin/$(OS)$(ARCH)
eg. bin/Linux32
o 'make install' and 'make instlinks' now place files/links in
/usr/local/{include,lib,share/OpenSceneGraph} by default on
most systems (Solaris still goes in /opt/OpenSceneGraph).
Rather than having the somwehat confusing INST_SYS_PREFIX and
INST_SHARE_PREFX, you can override these with just
INST_LOCATION
For example,
make INST_LOCATION=/usr
will place files at /usr/include, /usr/lib,
/usr/share/OpenSceneGraph.
