VizKit::VisualTiming Class Reference

#include <VisualTiming.h>

Collaboration diagram for VizKit::VisualTiming:

List of all members.

Classes
struct	DurationItem
Static Public Member Functions
static void	dispose (void)
static void	update (void)
static uint32	getElapsedMilliSecsSinceReset (const char *const durationName)
static uint32	getElapsedMilliSecsSinceReset (const VisualItemIdentifier &visualDurationIdentifier)
static uint32	getElapsedMilliSecsSinceLastCall (const char *const durationName)
static uint32	getElapsedMilliSecsSinceLastCall (const VisualItemIdentifier &visualDurationIdentifier)
static void	resetTimestamp (const char *const durationName)
static void	resetTimestamp (const VisualItemIdentifier &visualDurationIdentifier)
static const char *const	getCurrentMillisecsDateTime (void)
static void	addDurationItemToDurationMap (const VisualItemIdentifier &visualDurationIdentifier)
Private Types
typedef std::map < VisualItemIdentifier, DurationItem * >	DurationMap
typedef DurationMap::iterator	DurationMapIterator
Private Member Functions
	VisualTiming ()
	~VisualTiming ()
	VisualTiming (const VisualTiming &other)
VisualTiming &	operator= (const VisualTiming &other)
Static Private Member Functions
static VisualTiming *	getInstance (void)
Private Attributes
DurationMap	durationMap
char	dateTimeStr [32]
Static Private Attributes
static VisualTiming *	theVisualTiming = NULL

---

Detailed Description

Provides facilities to deal with and calculate time values. All public methods are declared static.

---

Member Typedef Documentation

typedef std::map<VisualItemIdentifier, DurationItem*> VizKit::VisualTiming::DurationMap [private]

A DurationMap is a map of duration items.

typedef DurationMap::iterator VizKit::VisualTiming::DurationMapIterator [private]

A DurationMapIterator is the iterator of a DurationMap.

---

Constructor & Destructor Documentation

VisualTiming::VisualTiming

(

)

[private]

The constructor. VisualTiming is a singleton class. The constructor is private. New instance of class can only be created internally.

VisualTiming::~VisualTiming

(

)

[private]

The destructor.

VizKit::VisualTiming::VisualTiming

(

const VisualTiming &

other

)

[private]

Copy constructor.

Parameters:

other

Another VisualTiming.

Remarks:

Explicitely declared in private section and not implemented to enforce uniqueness of singleton pattern.

---

Member Function Documentation

void VisualTiming::addDurationItemToDurationMap

(

const VisualItemIdentifier &

visualDurationIdentifier

)

[static]

Adds a duration item to the duration map.

Parameters:

visualDurationIdentifier

The identifier of the duration item.

void VisualTiming::dispose

(

void

)

[static]

Disposes the visual timing.

const char *const VisualTiming::getCurrentMillisecsDateTime

(

void

)

[static]

Returns the current date and time including milliseconds. The date and time are represented as YYYYMMDDHHMISS000 (year-month-day-hour-minute-seconds-milliseconds).

uint32 VisualTiming::getElapsedMilliSecsSinceLastCall

(

const char *const

durationName

)

[static]

Returns the number of milliseconds that have elapsed since the last call of the duration item. Time is measured individually for single duration items. The duration items are itentified by name. This function returns the milliseconds that have passed since the last render call.

Parameters:

durationName

The identifier of the duration.

Returns:

The number of milliseconds that have elapsed since the last call.

uint32 VisualTiming::getElapsedMilliSecsSinceLastCall

(

const VisualItemIdentifier &

visualDurationIdentifier

)

[static]

Returns the number of milliseconds that have elapsed since the last call of the duration item. Time is measured individually for single duration items. The duration items are itentified by name. This function returns the milliseconds that have passed since the last render call.

Parameters:

visualDurationIdentifier

The identifier of the duration.

Returns:

The number of milliseconds that have elapsed since the last call.

uint32 VisualTiming::getElapsedMilliSecsSinceReset

(

const VisualItemIdentifier &

visualDurationIdentifier

)

[static]

Returns the number of milliseconds that have elapsed since first call of the duration item. Time is measured individually for single duration items. The duration items are itentified by name. This function returns the milliseconds that have passed since the duration item first asked for its elapsed milliseconds.

Parameters:

visualDurationIdentifier

The identifier of the duration.

Returns:

The number of milliseconds that have elapsed since first call of the duration item.

uint32 VisualTiming::getElapsedMilliSecsSinceReset

(

const char *const

durationName

)

[static]

Returns the number of milliseconds that have elapsed since first call of the duration item. Time is measured individually for single duration items. The duration items are itentified by name. This function returns the milliseconds that have passed since the duration item first asked for its elapsed milliseconds.

Parameters:

durationName

The identifier of the duration.

Returns:

The number of milliseconds that have elapsed since first call of the duration item.

VisualTiming * VisualTiming::getInstance

(

void

)

[static, private]

Returns a pointer to the VisualTiming. Initializes VisualTiming if neccessary. VisualTiming is a singleton.

Returns:

A pointer to the VisualTiming.

VisualTiming& VizKit::VisualTiming::operator=

(

const VisualTiming &

other

)

[private]

Assignment operator.

Remarks:

Explicitely declared in private section and not implemented to enforce uniqueness of singleton pattern.

void VisualTiming::resetTimestamp

(

const VisualItemIdentifier &

visualDurationIdentifier

)

[static]

Resets the stored timing values for this duration item. Time is measured individually for single duration items. The duration items are itentified by name. This function resets the timing values for this duration item.

Parameters:

visualDurationIdentifier

The identifier of the duration.

void VisualTiming::resetTimestamp

(

const char *const

durationName

)

[static]

Resets the stored timing values for this duration item. Time is measured individually for single duration items. The duration items are itentified by name. This function resets the timing values for this duration item.

Parameters:

durationName

The identifier of the duration.

void VisualTiming::update

(

void

)

[static]

Refreshes the current timestamp.

---

Member Data Documentation

char VizKit::VisualTiming::dateTimeStr[32] [private]

The frequency of QueryPerformanceFrequency. Windows only. A string representing date and time (YYYYMMDDHHMISS).

DurationMap VizKit::VisualTiming::durationMap [private]

The map of the duration items.

VisualTiming * VisualTiming::theVisualTiming = NULL [static, private]

Returns the difference between one timestamp and another.

Parameters:

	young_timestamp	The timestamp that was recorded before old_timestamp.
	old_timestamp	The timestamp that was recorded after young_timestamp.

Returns:

The difference between young_timestamp and old_timestamp. The timestamp of the current render call. VisualTiming is a singleton class. Pointer to private instance is handled internally.

---

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

• Tools/Timing/VisualTiming.h
• Tools/Timing/VisualTiming.cpp