/home/cube/sources/osgearth/src/osgEarthUtil/ObjectLocator

Go to the documentation of this file.

#ifndef OSGEARTH_UTIL_OBJECT_LOCATOR_H
#define OSGEARTH_UTIL_OBJECT_LOCATOR_H

#include <osgEarthUtil/Common>
#include <osgEarth/Map>
#include <osgEarth/Revisioning>
#include <osg/MatrixTransform>

namespace osgEarth { namespace Util
{
    using namespace osgEarth;

    class OSGEARTHUTIL_EXPORT ObjectLocator : public osgEarth::Revisioned<osg::Referenced>
    {
    public:

        enum Components {
            COMP_NONE           = 0x00,
            COMP_POSITION       = 0x01,
            COMP_HEADING        = 0x02,
            COMP_PITCH          = 0x04,
            COMP_ROLL           = 0x08,
            COMP_ORIENTATION    = COMP_HEADING | COMP_PITCH | COMP_ROLL,
            COMP_ALL            = COMP_POSITION | COMP_ORIENTATION
        };

        enum RotationOrder {
            HPR,
            RPH
        };

    public:

        ObjectLocator( const osgEarth::Map* map );

        ObjectLocator(ObjectLocator* parent, unsigned int compsToInherit =COMP_ALL );

        void setPosition( const osg::Vec3d& pos );
        const osg::Vec3d& getPosition() const { return _pos; }

        void setOrientation( const osg::Vec3d& hpr_deg );
        const osg::Vec3d& getOrientation() const { return _hpr; }

        void setTime( double t ) { _timestamp = t; }
        double getTime() const { return _timestamp; }

        void setRotationOrder( RotationOrder value ) { _rotOrder = value; }
        RotationOrder getRotationOrder() const { return _rotOrder; }

        void setParentLocator( ObjectLocator* parent, unsigned int componentsToInherit =COMP_ALL );
        ObjectLocator* getParentLocator() { return _parentLoc.get(); }
        const ObjectLocator* getParentLocator() const { return _parentLoc.get(); }

        void setComponentsToInherit( unsigned int compMask );
        unsigned int getComponentsToInherit() const { return _componentsToInherit; }

        const Map* getMap() const { return _map.get(); }

        bool isEmpty() const;

        bool isValid() const { return !_isEmpty && _map.valid(); }

    public:

        bool getLocatorPosition( osg::Vec3d& output ) const;

        bool getPositionMatrix( osg::Matrixd& output ) const;

        bool getLocatorOrientation( osg::Vec3d& output ) const;

        bool getOrientationMatrix( osg::Matrixd& output, unsigned inherit =COMP_ALL ) const;

        bool getLocatorMatrix( osg::Matrixd& output, unsigned components =COMP_ALL ) const;

    public:
        //override
        virtual bool inSyncWith( int exRev ) const;

    private:
        osg::observer_ptr<const osgEarth::Map> _map;
        osg::ref_ptr<ObjectLocator> _parentLoc;
        unsigned int _componentsToInherit; // Locator::Components mask
        RotationOrder _rotOrder;
        osg::Vec3d _pos;
        osg::Vec3d _hpr;
        double _timestamp;
        bool _isEmpty;
    };


    class OSGEARTHUTIL_EXPORT ObjectLocatorNode : public osg::MatrixTransform
    {
    public:
        ObjectLocatorNode();
        ObjectLocatorNode( ObjectLocator* locator );
        ObjectLocatorNode( const Map* map );
        ObjectLocatorNode( const ObjectLocatorNode& rhs, const osg::CopyOp& =osg::CopyOp::SHALLOW_COPY );
        META_Node(osgEarthUtil, ObjectLocatorNode);

    public:
        void setLocator( ObjectLocator* locator );
        ObjectLocator* getLocator() { return _locator.get(); }
        const ObjectLocator* getLocator() const { return _locator.get(); }

    public:
        virtual void update();

        virtual void traverse(osg::NodeVisitor &nv);

    private:
        osg::ref_ptr<ObjectLocator> _locator;
        osgEarth::Revision _matrixRevision;
    };

} } // namespace osgEarth::Util

#endif // OSGEARTH_UTIL_OBJECT_LOCATOR_H