/usr/include/osgSim/ScalarBar is in libopenscenegraph-dev 3.2.3+dfsg1-2+b4.
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 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 | /* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
*
* This library is open source and may be redistributed and/or modified under
* the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
* (at your option) any later version. The full license is in LICENSE file
* included with this distribution, and on the openscenegraph.org website.
*
* This library 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
* OpenSceneGraph Public License for more details.
*/
#ifndef OSGSIM_SCALARBAR
#define OSGSIM_SCALARBAR 1
#include <osgSim/Export>
#include <osgSim/ColorRange> // The default ScalarsToColors is a ColorRange
#include <osg/Geode>
#include <string>
namespace osgSim
{
/**
A ScalarBar is an osg::Geode to render a colored bar representing a range
of scalars. The scalar/color ranges are specified by an instance of
ScalarsToColors. There are a number of configurable properties on the
ScalarBar, such as the orientation, the number of labels to be displayed
across the range, the number of distinct colors to use when rendering the
bar, text details etc.
In summary, the main configurables on the ScalarBar are:
-# The range of scalars represented by the bar, and the colors
corresponding to this range - these are specified by the
ScalarsToColors object.
-# The number of colors used when rendering the bar geometry -
this may be thought of as the bar 'density'.
-# The number of text labels to be used when displaying the bar.
The other configurables should be self-explanatory.
*/
class OSGSIM_EXPORT ScalarBar: public osg::Geode
{
public:
/** ScalarBar orientation specification. */
enum Orientation{
HORIZONTAL, ///< a horizontally ascending scalar bar (x-axis)
VERTICAL ///< a vertically ascending scalar bar (y-axis)
};
/**
Users may provide their own ScalarPrinter by deriving from this base class and
overriding the printScalar() method. Users may map the scalar float passed in
to any string they wish.
*/
struct OSGSIM_EXPORT ScalarPrinter: public osg::Referenced
{
virtual std::string printScalar(float scalar);
};
/**
TextProperties allows users to specify a number of properties for the
text used to display the labels & title on the ScalarBar. Specifiying a character
size of 0 will cause the ScalarBar to estimate an appropriate size. Note that
the attributes are public, and may be set directly.
*/
struct TextProperties
{
std::string _fontFile;
std::pair<int,int> _fontResolution;
float _characterSize;
osg::Vec4 _color;
TextProperties():
_fontFile("fonts/arial.ttf"),
_fontResolution(40,40),
_characterSize(0.0f),
_color(1.0f,1.0f,1.0f,1.0f)
{
}
};
/** Default constructor. */
ScalarBar(): osg::Geode(),
_numColors(256),
_numLabels(11),
_stc(new ColorRange(0.0f,1.0f)),
_title("Scalar Bar"),
_position(0.0f,0.0f,0.0f),
_width(1.0f),
_aspectRatio(0.03),
_orientation(HORIZONTAL),
_sp(new ScalarPrinter)
{
createDrawables();
}
/**
Construct a ScalarBar with the supplied parameters.
@param numColors Specify the number of colors in the scalar bar. Color
interpolation occurs where necessary.
@param numLabels Specify the number of labels in the scalar bar.
@param stc The ScalarsToColors defining the range of scalars
and the colors they map to.
@param title The title to be used when displaying the ScalarBar.
Specify "" for no title.
@param orientation The orientation of the ScalarBar. @see Orientation.
@param aspectRatio The aspect ration (y/x) for the displayed bar. Bear in mind you
may want to change this if you change the orientation.
@param sp A ScalarPrinter object for the ScalarBar. For every displayed
ScalarBar label, the scalar value will be passed to the
ScalarPrinter object to turn it into a string. Users may
override the default ScalarPrinter object to map scalars to
whatever strings they wish. @see ScalarPrinter
*/
ScalarBar(int numColors, int numLabels, ScalarsToColors* stc,
const std::string& title,
Orientation orientation = HORIZONTAL,
float aspectRatio=0.25,
ScalarPrinter* sp=new ScalarPrinter):
osg::Geode(),
_numColors(numColors),
_numLabels(numLabels),
_stc(stc),
_title(title),
_position(0.0f,0.0f,0.0f),
_width(1.0f),
_aspectRatio(aspectRatio),
_orientation(orientation),
_sp(sp)
{
createDrawables();
}
/** Copy constructor */
ScalarBar(const ScalarBar& rhs, const osg::CopyOp& co): osg::Geode(rhs,co),
_numColors(rhs._numColors),
_numLabels(rhs._numLabels),
_stc(rhs._stc), // Consider clone for deep copy?
_title(rhs._title),
_position(rhs._position),
_width(rhs._width),
_aspectRatio(rhs._aspectRatio),
_orientation(rhs._orientation),
_sp(rhs._sp), // Consider clone for deep copy?
_textProperties(rhs._textProperties)
{
}
META_Node(osgSim, ScalarBar);
/** Set the number of distinct colours on the ScalarBar. */
void setNumColors(int numColors);
/** Get the number of distinct colours on the ScalarBar. */
int getNumColors() const;
/** Set the number of labels to display along the ScalarBar. There
will be one label at each end point, and evenly distributed labels
in between. */
void setNumLabels(int numLabels);
/** Get the number of labels displayed along the ScalarBar. */
int getNumLabels() const;
/** Set the ScalarsToColors mapping object for the ScalarBar. */
void setScalarsToColors(ScalarsToColors* stc);
/** Get the ScalarsToColors mapping object from the ScalarBar. */
const ScalarsToColors* getScalarsToColors() const;
/** Set the title for the ScalarBar, set "" for no title. */
void setTitle(const std::string& title);
/** Get the title for the ScalarBar. */
const std::string& getTitle() const;
/** Set the position of scalar bar's lower left corner.*/
void setPosition(const osg::Vec3& pos);
/** Get the position of scalar bar.*/
const osg::Vec3& getPosition() const { return _position; }
/** Set the width of the scalar bar.*/
void setWidth(float width);
/** Get the width of the scalar bar.*/
float getWidth() const { return _width; }
/** Set the aspect ration (y/x) for the displayed bar. Bear in mind you
may want to change this if you change the orientation. */
void setAspectRatio(float aspectRatio);
/** Get the aspect ration (y/x) for the displayed bar. */
float getAspectRatio() const;
/** Set the orientation of the ScalarBar. @see Orientation */
void setOrientation(ScalarBar::Orientation orientation);
/** Get the orientation of the ScalarBar. @see Orientation */
ScalarBar::Orientation getOrientation() const;
/** Set a ScalarPrinter object for the ScalarBar. For every displayed
ScalarBar label, the scalar value will be passed to the ScalarPrinter
object to turn it into a string. Users may override the default ScalarPrinter
object to map scalars to whatever strings they wish. @see ScalarPrinter */
void setScalarPrinter(ScalarPrinter* sp);
/** Get the ScalarPrinter object */
const ScalarPrinter* getScalarPrinter() const;
/** Set the TextProperties for the labels & title. @see TextProperties */
void setTextProperties(const TextProperties& tp);
/** Get the TextProperties for the labels & title. @see TextProperties */
const TextProperties& getTextProperties() const;
/** force update the drawables used to render the scalar bar.*/
void update() { createDrawables(); }
protected:
virtual ~ScalarBar();
int _numColors;
int _numLabels;
osg::ref_ptr<ScalarsToColors> _stc;
std::string _title;
osg::Vec3 _position;
float _width;
float _aspectRatio;
Orientation _orientation;
osg::ref_ptr<ScalarPrinter> _sp;
TextProperties _textProperties;
void createDrawables();
};
}
#endif
|