/usr/include/osgEarthUtil/AnnotationEvents is in libosgearth-dev 2.7.0+dfsg-2+b3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | /* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
* Copyright 2015 Pelican Mapping
* http://osgearth.org
*
* osgEarth is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program.  If not, see <http://www.gnu.org/licenses/>
*/
#ifndef OSGEARTH_UTIL_ANNOTATION_EVENTS_H
#define OSGEARTH_UTIL_ANNOTATION_EVENTS_H 1
#include <osgEarthUtil/Common>
#include <osgEarthAnnotation/AnnotationNode>
#include <set>
/**
 * @deprecated
 *
 * These classes are deprecated, and will be removed in a future version.
 * Please consider using the RTTPicker class instead and handling hovering and 
 * clicking in your own code.
 */
namespace osgEarth { namespace Util
{	
    using namespace osgEarth::Util;
    using namespace osgEarth::Annotation;
    /**
     * Event handler skeleton for handling events from the AnnotationEventCallback.
     * @deprecated
     */
    struct AnnotationEventHandler : public osg::Referenced
    {
        struct EventArgs
        {
            float x, y;
            int   buttons;   // see osgGA::GUIEventAdapter::MouseButtonMask
            int   modkeys;   // see osgGA::GUIEventAdapter::ModKeyMask
        };
        virtual void onClick( AnnotationNode* node, const EventArgs& details ) { }
        virtual void onHoverEnter( AnnotationNode* node, const EventArgs& details ) { }
        virtual void onHoverLeave( AnnotationNode* node, const EventArgs& details ) { }
        virtual ~AnnotationEventHandler() { }
    };
    /**
     * Event-traversal node callback that handles user interaction with 
     * annotation objects.
     * @deprecated
     */
    class OSGEARTHUTIL_EXPORT AnnotationEventCallback : public osg::NodeCallback
    {
    public:
        AnnotationEventCallback( AnnotationEventHandler* handler =0L );
        /** 
         * Adds an event handler whose events will fire upon user actions
         */
        void addHandler( AnnotationEventHandler* handler );
        /**
         * Sets whether "hovering" events will fire. By default they do. But you 
         * can disable this (if you're not using hovering) and get a small
         * performance improvement.
         */
        void setHoverEnabled( bool hoverEnabled );
    public: // osg::NodeCallback
        virtual void operator()( osg::Node* node, osg::NodeVisitor* nv );
    protected:
        virtual ~AnnotationEventCallback() { }
        AnnotationEventHandler::EventArgs _args;
        bool  _mouseDown;
        bool _hoverEnabled;
        std::set<AnnotationNode*> _hovered;
        typedef std::vector< osg::ref_ptr<AnnotationEventHandler> > Handlers;
        Handlers _handlers;
        typedef void (AnnotationEventHandler::*EventHandlerMethodPtr)(AnnotationNode*,const AnnotationEventHandler::EventArgs&);
        void fireEvent(EventHandlerMethodPtr mp, AnnotationNode* node);
    };
} } // namespace osgEarth::Annotation
#endif // OSGEARTH_ANNO_ANNOTATION_NODE_H
 |