/usr/include/osgEarthAnnotation/TrackNode is in libosgearth-dev 2.5.0+dfsg-8build1.
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 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 | /* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
* Copyright 2008-2013 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.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* 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_ANNOTATION_TRACK_NODE_H
#define OSGEARTH_ANNOTATION_TRACK_NODE_H 1
#include <osgEarthAnnotation/OrthoNode>
#include <osgEarthSymbology/Style>
#include <osgEarth/Containers>
#include <osg/Image>
#include <osgText/String>
namespace osgEarth
{
class MapNode;
}
namespace osgEarth { namespace Annotation
{
using namespace osgEarth;
using namespace osgEarth::Symbology;
/**
* Defines for a labeling field associated with a TrackNode. A TrackNode
* can have zero or more "fields", each being a text label rendered
* along with the node's icon.
*/
struct /*no-export*/ TrackNodeField
{
/**
* Constructs a new field definition.
* @param symbol Text symbol describing the field's appearance and placement
* @param dynamic Whether the text label will be dynamic; i.e. whether the user
* intends to update it at runtime. Setting this to "false" for a
* static label yields better performance in a multithreaded app.
*/
TrackNodeField( const TextSymbol* symbol, bool dynamic =true )
: _symbol(symbol), _dynamic(dynamic) { }
/** other constructors (internal) */
TrackNodeField()
: _dynamic(true) { }
TrackNodeField( const TrackNodeField& rhs )
: _symbol(rhs._symbol.get()), _dynamic(rhs._dynamic) { }
osg::ref_ptr<const TextSymbol> _symbol;
bool _dynamic;
};
/**
* Schema that maps field names to field definitions.
*/
typedef fast_map<std::string, TrackNodeField> TrackNodeFieldSchema;
/**
* TrackNode is a movable, single-point entity represented by an icon,
* optional placeable text labels, and optional localized geometry.
*
* NOTE. TrackNode does not automatically support terrain clamping. This is
* because its intention is for use as a trackable entity marker, and
* presumably the entity itself will be responsible for its own absolute
* positioning (and clamping, if applicable).
*/
class OSGEARTHANNO_EXPORT TrackNode : public OrthoNode
{
public:
META_AnnotationNode(osgEarthAnnotation, TrackNode);
/**
* Constructs a new track node
* @param mapNode Map node under which this track will live
* @param position Initial position
* @param image Icon image to use
* @param fieldSchema Schema for track label fields
*/
TrackNode(
MapNode* mapNode,
const GeoPoint& position,
osg::Image* image,
const TrackNodeFieldSchema& fieldSchema );
/**
* Constructs a new track node
* @param mapNode Map node under which this track will live
* @param position Initial position
* @param style Style containing an IconSymbol for the image
* @param fieldSchema Schema for track label fields
*/
TrackNode(
MapNode* mapNode,
const GeoPoint& position,
const Style& style,
const TrackNodeFieldSchema& fieldSchema );
/**
* Sets the value of one of the field labels.
* @param name Field name as identified in the field schema.
* @param value Value to which to set the field label.
*/
void setFieldValue( const std::string& name, const std::string& value ) { setFieldValue(name, osgText::String(value)); }
void setFieldValue( const std::string& name, const osgText::String& value );
/**
* Adds an arbitrary drawable to this track node. Useful for adding
* user-defined graphics.
* @param name Name of the drawable (for later retrieval). The namespace
* should not conflict with that of the field schema.
* @param drawable Drawable to add.
*/
void addDrawable( const std::string& name, osg::Drawable* drawable );
/**
* Gets a drawable (as previously added with addDrawable).
* Note: Make sure that if you are modifying a drawable, mark it with a
* DYNAMIC data variance so it will be thread-safe.
*/
osg::Drawable* getDrawable( const std::string& name ) const;
public: // override
virtual void setAnnotationData( AnnotationData* data );
protected:
virtual ~TrackNode() { }
Style _style;
class osg::Geode* _geode;
typedef fast_map<std::string, osg::Drawable*> NamedDrawables;
NamedDrawables _namedDrawables;
void init( const TrackNodeFieldSchema& schema );
private:
// required by META_Node, but this object is not cloneable
TrackNode() { }
TrackNode(const TrackNode& rhs, const osg::CopyOp& op =osg::CopyOp::DEEP_COPY_ALL) { }
};
} } // namespace osgEarth::Annotation
#endif //OSGEARTH_ANNOTATION_TRACK_NODE_H
|