openscenegraph
Classes | Public Types | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | List of all members
osgViewer::StatsHandler Class Reference
Inheritance diagram for osgViewer::StatsHandler:
osgGA::GUIEventHandler osg::NodeCallback osg::Drawable::EventCallback osg::Object osg::Object osg::Referenced osg::Referenced

Classes

struct  UserStatsLine

Public Types

enum  StatsType {
  NO_STATS = 0, FRAME_RATE = 1, VIEWER_STATS = 2, CAMERA_SCENE_STATS = 3,
  VIEWER_SCENE_STATS = 4, LAST = 5
}

Public Member Functions

 StatsHandler ()
void setKeyEventTogglesOnScreenStats (int key)
int getKeyEventTogglesOnScreenStats () const
void setKeyEventPrintsOutStats (int key)
int getKeyEventPrintsOutStats () const
void setKeyEventToggleVSync (int key)
int getKeyEventToggleVSync () const
double getBlockMultiplier () const
void reset ()
osg::CameragetCamera ()
const osg::CameragetCamera () const
virtual bool handle (const osgGA::GUIEventAdapter &ea, osgGA::GUIActionAdapter &aa)
virtual void getUsage (osg::ApplicationUsage &usage) const
void addUserStatsLine (const std::string &label, const osg::Vec4 &textColor, const osg::Vec4 &barColor, const std::string &timeTakenName, float multiplier, bool average, bool averageInInverseSpace, const std::string &beginTimeName, const std::string &endTimeName, float maxValue)
void removeUserStatsLine (const std::string &label)
- Public Member Functions inherited from osgGA::GUIEventHandler
 GUIEventHandler ()
 GUIEventHandler (const GUIEventHandler &eh, const osg::CopyOp &copyop)
 META_Object (osgGA, GUIEventHandler)
virtual void operator() (osg::Node *node, osg::NodeVisitor *nv)
virtual void event (osg::NodeVisitor *nv, osg::Drawable *drawable)
virtual bool handle (const GUIEventAdapter &ea, GUIActionAdapter &aa, osg::Object *, osg::NodeVisitor *)
bool handleWithCheckAgainstIgnoreHandledEventsMask (const GUIEventAdapter &ea, GUIActionAdapter &aa, osg::Object *object, osg::NodeVisitor *nv)
bool handleWithCheckAgainstIgnoreHandledEventsMask (const GUIEventAdapter &ea, GUIActionAdapter &aa)
void setIgnoreHandledEventsMask (unsigned int mask)
unsigned int getIgnoreHandledEventsMask () const
- Public Member Functions inherited from osg::NodeCallback
 NodeCallback ()
 NodeCallback (const NodeCallback &nc, const CopyOp &)
 META_Object (osg, NodeCallback)
void traverse (Node *node, NodeVisitor *nv)
void setNestedCallback (NodeCallback *nc)
NodeCallbackgetNestedCallback ()
const NodeCallbackgetNestedCallback () const
void addNestedCallback (NodeCallback *nc)
void removeNestedCallback (NodeCallback *nc)
- Public Member Functions inherited from osg::Object
 Object ()
 Object (bool threadSafeRefUnref)
 Object (const Object &, const CopyOp &copyop=CopyOp::SHALLOW_COPY)
virtual ObjectcloneType () const =0
virtual Objectclone (const CopyOp &) const =0
virtual bool isSameKindAs (const Object *) const
virtual const char * libraryName () const =0
virtual const char * className () const =0
virtual void setThreadSafeRefUnref (bool threadSafe)
virtual void setName (const std::string &name)
void setName (const char *name)
const std::string & getName () const
void setDataVariance (DataVariance dv)
DataVariance getDataVariance () const
virtual void computeDataVariance ()
void setUserDataContainer (osg::UserDataContainer *udc)
osg::UserDataContainergetUserDataContainer ()
const osg::UserDataContainergetUserDataContainer () const
osg::UserDataContainergetOrCreateUserDataContainer ()
virtual void setUserData (Referenced *obj)
virtual ReferencedgetUserData ()
virtual const ReferencedgetUserData () const
template<typename T >
bool getUserValue (const std::string &name, T &value) const
template<typename T >
void setUserValue (const std::string &name, const T &value)
virtual void resizeGLObjectBuffers (unsigned int)
virtual void releaseGLObjects (osg::State *=0) const
- Public Member Functions inherited from osg::Referenced
 Referenced ()
 Referenced (bool threadSafeRefUnref)
 Referenced (const Referenced &)
Referencedoperator= (const Referenced &)
bool getThreadSafeRefUnref () const
OpenThreads::MutexgetRefMutex () const
int ref () const
int unref () const
int unref_nodelete () const
int referenceCount () const
ObserverSetgetObserverSet () const
ObserverSetgetOrCreateObserverSet () const
void addObserver (Observer *observer) const
void removeObserver (Observer *observer) const
- Public Member Functions inherited from osg::Drawable::EventCallback
 EventCallback ()
 EventCallback (const EventCallback &, const CopyOp &)
 META_Object (osg, EventCallback)

Protected Types

typedef std::vector
< UserStatsLine
UserStatsLines

Protected Member Functions

void setUpHUDCamera (osgViewer::ViewerBase *viewer)
osg::GeometrycreateBackgroundRectangle (const osg::Vec3 &pos, const float width, const float height, osg::Vec4 &color)
osg::GeometrycreateGeometry (const osg::Vec3 &pos, float height, const osg::Vec4 &colour, unsigned int numBlocks)
osg::GeometrycreateFrameMarkers (const osg::Vec3 &pos, float height, const osg::Vec4 &colour, unsigned int numBlocks)
osg::GeometrycreateTick (const osg::Vec3 &pos, float height, const osg::Vec4 &colour, unsigned int numTicks)
void createTimeStatsLine (const std::string &lineLabel, osg::Vec3 pos, const osg::Vec4 &textColor, const osg::Vec4 &barColor, osg::Stats *viewerStats, osg::Stats *stats, const std::string &timeTakenName, float multiplier, bool average, bool averageInInverseSpace, const std::string &beginTimeName, const std::string &endTimeName)
void createCameraTimeStats (osg::Vec3 &pos, bool acquireGPUStats, osg::Stats *viewerStats, osg::Camera *camera)
void setUpScene (osgViewer::ViewerBase *viewer)
void updateThreadingModelText ()

Protected Attributes

int _keyEventTogglesOnScreenStats
int _keyEventPrintsOutStats
int _keyEventToggleVSync
int _statsType
bool _initialized
osg::ref_ptr< osg::Camera_camera
osg::ref_ptr< osg::Switch_switch
osg::ref_ptr< osg::Geode_statsGeode
ViewerBase::ThreadingModel _threadingModel
osg::ref_ptr< osgText::Text_threadingModelText
unsigned int _frameRateChildNum
unsigned int _viewerChildNum
unsigned int _cameraSceneChildNum
unsigned int _viewerSceneChildNum
unsigned int _numBlocks
double _blockMultiplier
float _statsWidth
float _statsHeight
std::string _font
float _startBlocks
float _leftPos
float _characterSize
float _lineHeight
UserStatsLines _userStatsLines
- Protected Attributes inherited from osgGA::GUIEventHandler
unsigned int _ignoreHandledEventsMask

Additional Inherited Members

- Static Public Member Functions inherited from osg::Referenced
static OpenThreads::MutexgetGlobalReferencedMutex ()
static void setThreadSafeReferenceCounting (bool enableThreadSafeReferenceCounting)
static bool getThreadSafeReferenceCounting ()
static void setDeleteHandler (DeleteHandler *handler)
static DeleteHandlergetDeleteHandler ()
- Public Attributes inherited from osg::NodeCallback
ref_ptr< NodeCallback_nestedCallback

Detailed Description

Event handler for adding on screen stats reporting to Viewers.

Member Typedef Documentation

Member Enumeration Documentation

Enumerator:
NO_STATS 
FRAME_RATE 
VIEWER_STATS 
CAMERA_SCENE_STATS 
VIEWER_SCENE_STATS 
LAST 

Constructor & Destructor Documentation

osgViewer::StatsHandler::StatsHandler ( )

Member Function Documentation

void osgViewer::StatsHandler::addUserStatsLine ( const std::string &  label,
const osg::Vec4 textColor,
const osg::Vec4 barColor,
const std::string &  timeTakenName,
float  multiplier,
bool  average,
bool  averageInInverseSpace,
const std::string &  beginTimeName,
const std::string &  endTimeName,
float  maxValue 
)

This allows the user to register additional stats lines that will be added to the graph. The stats for these will be gotten from the viewer (viewer->getViewerStats()). The stats can be displayed in either or all of the following ways:

  • A numeric time beside the stat name Requires that an elapsed time be recorded in the viewer's stats for the "timeTakenName".
  • A bar in the top bar graph Requires that two times (relative to the viewer's start tick) be recorded in the viewer's stats for the "beginTimeName" and "endTimeName".
  • A line in the bottom graph Requires that an elapsed time be recorded in the viewer's stats for the "timeTakenName" and that the value be used as an average.

If you don't want a numeric value and a line in the bottom line graph for your value, pass the empty string for timeTakenName. If you don't want a bar in the graph, pass the empty string for beginTimeName and endTimeName.

Parameters
labelThe label to be displayed to identify the line in the stats.
textColorWill be used for the text label, the numeric time and the bottom line graph.
barColorWill be used for the bar in the top bar graph.
timeTakenNameThe name to be queried in the viewer stats for the numeric value (also used for the bottom line graph).
multiplierThe multiplier to apply to the numeric value before displaying it in the stats.
averageWhether to use the average value of the numeric value.
averageInInverseSpaceWhether to average in inverse space (used for frame rate).
beginTimeNameThe name to be queried in the viewer stats for the begin time for the top bar graph.
endTimeNameThe name to be queried in the viewer stats for the end time for the top bar graph.
maxValueThe value to use as maximum in the bottom line graph. Stats will be clamped between 0 and that value, and it will be the highest visible value in the graph.
osg::Geometry* osgViewer::StatsHandler::createBackgroundRectangle ( const osg::Vec3 pos,
const float  width,
const float  height,
osg::Vec4 color 
)
protected
void osgViewer::StatsHandler::createCameraTimeStats ( osg::Vec3 pos,
bool  acquireGPUStats,
osg::Stats viewerStats,
osg::Camera camera 
)
protected
osg::Geometry* osgViewer::StatsHandler::createFrameMarkers ( const osg::Vec3 pos,
float  height,
const osg::Vec4 colour,
unsigned int  numBlocks 
)
protected
osg::Geometry* osgViewer::StatsHandler::createGeometry ( const osg::Vec3 pos,
float  height,
const osg::Vec4 colour,
unsigned int  numBlocks 
)
protected
osg::Geometry* osgViewer::StatsHandler::createTick ( const osg::Vec3 pos,
float  height,
const osg::Vec4 colour,
unsigned int  numTicks 
)
protected
void osgViewer::StatsHandler::createTimeStatsLine ( const std::string &  lineLabel,
osg::Vec3  pos,
const osg::Vec4 textColor,
const osg::Vec4 barColor,
osg::Stats viewerStats,
osg::Stats stats,
const std::string &  timeTakenName,
float  multiplier,
bool  average,
bool  averageInInverseSpace,
const std::string &  beginTimeName,
const std::string &  endTimeName 
)
protected
double osgViewer::StatsHandler::getBlockMultiplier ( ) const
inline
osg::Camera* osgViewer::StatsHandler::getCamera ( )
inline
const osg::Camera* osgViewer::StatsHandler::getCamera ( ) const
inline
int osgViewer::StatsHandler::getKeyEventPrintsOutStats ( ) const
inline
int osgViewer::StatsHandler::getKeyEventTogglesOnScreenStats ( ) const
inline
int osgViewer::StatsHandler::getKeyEventToggleVSync ( ) const
inline
virtual void osgViewer::StatsHandler::getUsage ( osg::ApplicationUsage usage) const
virtual

Get the keyboard and mouse usage of this manipulator.

Reimplemented from osgGA::GUIEventHandler.

virtual bool osgViewer::StatsHandler::handle ( const osgGA::GUIEventAdapter ,
osgGA::GUIActionAdapter  
)
virtual

Deprecated, Handle events, return true if handled, false otherwise.

Reimplemented from osgGA::GUIEventHandler.

void osgViewer::StatsHandler::removeUserStatsLine ( const std::string &  label)
void osgViewer::StatsHandler::reset ( )
void osgViewer::StatsHandler::setKeyEventPrintsOutStats ( int  key)
inline
void osgViewer::StatsHandler::setKeyEventTogglesOnScreenStats ( int  key)
inline
void osgViewer::StatsHandler::setKeyEventToggleVSync ( int  key)
inline
void osgViewer::StatsHandler::setUpHUDCamera ( osgViewer::ViewerBase viewer)
protected
void osgViewer::StatsHandler::setUpScene ( osgViewer::ViewerBase viewer)
protected
void osgViewer::StatsHandler::updateThreadingModelText ( )
protected

Member Data Documentation

double osgViewer::StatsHandler::_blockMultiplier
protected
osg::ref_ptr<osg::Camera> osgViewer::StatsHandler::_camera
protected
unsigned int osgViewer::StatsHandler::_cameraSceneChildNum
protected
float osgViewer::StatsHandler::_characterSize
protected
std::string osgViewer::StatsHandler::_font
protected
unsigned int osgViewer::StatsHandler::_frameRateChildNum
protected
bool osgViewer::StatsHandler::_initialized
protected
int osgViewer::StatsHandler::_keyEventPrintsOutStats
protected
int osgViewer::StatsHandler::_keyEventTogglesOnScreenStats
protected
int osgViewer::StatsHandler::_keyEventToggleVSync
protected
float osgViewer::StatsHandler::_leftPos
protected
float osgViewer::StatsHandler::_lineHeight
protected
unsigned int osgViewer::StatsHandler::_numBlocks
protected
float osgViewer::StatsHandler::_startBlocks
protected
osg::ref_ptr<osg::Geode> osgViewer::StatsHandler::_statsGeode
protected
float osgViewer::StatsHandler::_statsHeight
protected
int osgViewer::StatsHandler::_statsType
protected
float osgViewer::StatsHandler::_statsWidth
protected
osg::ref_ptr<osg::Switch> osgViewer::StatsHandler::_switch
protected
ViewerBase::ThreadingModel osgViewer::StatsHandler::_threadingModel
protected
osg::ref_ptr<osgText::Text> osgViewer::StatsHandler::_threadingModelText
protected
UserStatsLines osgViewer::StatsHandler::_userStatsLines
protected
unsigned int osgViewer::StatsHandler::_viewerChildNum
protected
unsigned int osgViewer::StatsHandler::_viewerSceneChildNum
protected

The documentation for this class was generated from the following file: