Home    News    Components    Get ViTooKi    Documentation    Community    Developers    @sf.net  

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

TimeMeasurement Class Reference

This class is used to measure the elapsed time of a streaming session. More...

#include <TimeMeasurement.hpp>

List of all members.

Public Member Functions
	TimeMeasurement ()
	default constructor
	~TimeMeasurement ()
	default destructor
void	addNewSection (ulong prebuffertime)
	Add a new section to the list of sections.
void	setPreviousSessionDuration (ulong previousSessionDuration)
	Set the endtime of previous session.
void	setDuration (ulong duration)
	Set the duration of the movie.
ulong	getPreviousSessionDuration ()
ulong	getDuration ()
ulong	getElapsedTime (uint sectionNr=0, ulong serverPlayout=0, ulong clientPlayout=0)
uint	getTimeSectionCount ()
void	startTS ()
	Set start-timestamp of current time-section.
void	stopTS ()
	Set stop-timestamp of current time-section.
void	setTSrequestedFrom (ulong reqfrom)
	Set requested range-from value of current time-section (and correct duration of previous time-section).
void	setTSserverPlayout (ulong playout)
	Set client playout-time (retrieved from mediaserver) of current time-section.
void	setTSclientPlayout (ulong playout)
	Set client playout-time (retrieved from client) of current time-section.

---

Detailed Description

This class is used to measure the elapsed time of a streaming session.

Author:

Klaus Schoeffmann

Definition at line 68 of file TimeMeasurement.hpp.

---

Member Function Documentation

ulong TimeMeasurement::getDuration (   )

Returns: duration of current session Definition at line 113 of file TimeMeasurement.cpp. Referenced by SSession::getDuration(). { return duration; }

ulong TimeMeasurement::getElapsedTime (  uint  sectionNr = 0, ulong  serverPlayout = 0, ulong  clientPlayout = 0 )

Returns: estimated elapsed time of current session. This value is either calculated as the difference between measured end-time/start-time and client-buffer-size or from retrieved server-estimation and client-buffer-size. Furthermore, if this session contains more than one time-sections, the range-values of the client-requests are considered, to minimize the deviation from the real mediatime Definition at line 186 of file TimeMeasurement.cpp. References TimeSection::getClientPlayout(), TimeSection::getClientReceived(), TimeSection::getCurrentMsecs(), TimeSection::getMeasuredEndtime(), TimeSection::getMeasuredStarttime(), TimeSection::getPrebufferTime(), and TimeSection::getServerPlayout(). Referenced by SSession::getElapsedMsecs(). { assert(sections->back() != NULL); Globals::sdebug << "\n********************************\n"; Globals::sdebug << "\nTimeMeasurement::getElapsedTime() sectionNr=" << sectionNr << ", currserverPlayout=" << currserverPlayout << ", currclientPlayout=" << currclientPlayout; //elapsed time, considering all time-sections long tmElapsed = 0; //cumulative client-received //this value contains the duration of all time-sections, which //were confirmed by the client ulong cumClientReceived = 0; //if there was a section-number specified, iterate //through the sections only until specified section-number uint untilSection = sections->size(); if (sectionNr != 0) { untilSection = sectionNr; } Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): untilSection=" << untilSection; //iterate through sections vector<TimeSection*>::const_iterator iter = sections->begin(); for (uint i =1; iter != sections->end() && i <= untilSection; iter++, i++) { TimeSection *ts = *iter; long tsElapsed; //elapsed time of time-section if (ts->getMeasuredStarttime() == 0) { cerr << "\nWARNING: getmeasuredstarttime of timesection " << i << " == 0 !!!" << endl; } else { Globals::sdebug << "\nTimeMeasurement::getElapsedTime()" << i << ": "; //calculate elapsed time of this time-section //if we do not have an endtime yet, use current time as end-time Globals::sdebug << "\n\t measuredendtime=" << ts->getMeasuredEndtime() << " "; if (ts->getMeasuredEndtime() != 0) { tsElapsed = ts->getMeasuredEndtime() - ts->getMeasuredStarttime() - ts->getPrebufferTime(); } else { tsElapsed = ts->getCurrentMsecs() - ts->getMeasuredStarttime() - ts->getPrebufferTime(); } //if session has not been started already, correct value to null if (tsElapsed < 0) tsElapsed = 0; //if we have a value confirmed by the player for this section, use this instead of if (currclientPlayout != 0 && ((iter+1) == sections->end())) { tmElapsed = currclientPlayout; Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): current CLIENT playout chosen"; } else if (ts->getClientReceived() != 0) { tmElapsed += ts->getClientReceived(); cumClientReceived += ts->getClientReceived(); Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): CLIENTRECEIVE(pause) chosen"; Globals::sdebug << "\t(clientreceived=" << ts->getClientReceived() << " cumclientreceived=" << cumClientReceived << ") "; } else if (currserverPlayout != 0 && ((iter+1) == sections->end())) { Globals::sdebug << "\n\t currserverPlayout=" << currserverPlayout; //if we have a value confirmed by the player for the last section, use this instead of if (i > 1 && cumClientReceived != 0) { tmElapsed = cumClientReceived + (currserverPlayout - (*(iter-1))->getServerPlayout()); cumClientReceived = 0; //do not use this value for later sections Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): CORRECTED SERVERPLAYOUT chosen"; Globals::sdebug << "\t corrected clientplayout=" << tmElapsed; } else { tmElapsed = currserverPlayout; Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): current SERVER playout chosen"; } } else { //if we have a value from the client or the mediaserver, use this instead of //(attention!: this value is cumulative) //otherwise use calculation above if (ts->getClientPlayout() != 0) { Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): CLIENT playout chosen"; Globals::sdebug << "(\t clientplayout=" << ts->getClientPlayout() << ") "; tmElapsed += ts->getClientPlayout(); } else if (ts->getServerPlayout() != 0) { Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): SERVER playout chosen"; Globals::sdebug << "(\t serverplayout=" << ts->getServerPlayout() << ") "; //on more than one timesections: if we have a previous section, which //were confirmed by the client, add difference to that confirmed value if (i > 1 && cumClientReceived != 0) { tmElapsed = cumClientReceived + (ts->getServerPlayout() - (*(iter-1))->getServerPlayout()); cumClientReceived = 0; //do not use this value for later sections Globals::sdebug << "\n\t corrected clientplayout=" << tmElapsed << " "; } else { tmElapsed = ts->getServerPlayout(); } } else { tmElapsed += tsElapsed; Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): OWN ESTIMANTION chosen (tmElapsed=" << tmElapsed << ")"; } } } } Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): tmElapsed=" << tmElapsed << " prevSD=" << previousSessionDuration; Globals::sdebug << "\nTimeMeasurement::getElapsedTime(): RESULT=" << (tmElapsed + previousSessionDuration); Globals::sdebug << "\n********************************\n"; return tmElapsed + previousSessionDuration; }

ulong TimeMeasurement::getPreviousSessionDuration (   )

Returns: endtime of previous session Definition at line 107 of file TimeMeasurement.cpp. Referenced by SSession::getPreviousSessionDuration(). { return previousSessionDuration; }

uint TimeMeasurement::getTimeSectionCount (   )

Returns: current number of time-sections Definition at line 180 of file TimeMeasurement.cpp. Referenced by SSession::getTimeSectionCount(). { return sections->size(); }

---

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

• TimeMeasurement.hpp
• TimeMeasurement.cpp

© ViTooKi 2003 :: [Lite version] Created with Doxygen