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

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

ESSynchronizer Class Reference

Adaptor class Synchronizer handles stream synchronization can be used for VES and AES <short description="">. More...

#include <ESSynchronizer.hpp>

Inheritance diagram for ESSynchronizer:

List of all members.

Public Member Functions
	ESSynchronizer (ESInfo *esi, GlobalTimer *globalTimer)
list< Frame * >	adapt (Frame *frm)
	Blocks the calling data channel until the presentation time stamp (CTS) of the given frame matches the play-out media time returned by the associated GlobalTimer.
Adaptor *	clone ()
	Create a shallow copy of the Adaptor.
void	initialize ()
	Initialize internal data structures.
list< Frame * >	close ()
	Close and destroy an Adaptor.
void	setPaused (bool pause)
	Blocks/deblocks the data channel this ESSynchronizer adaptor belongs to.
void	setESInfo (ESInfo *esi)
	Sets a reference to an ESInfo object.
ESInfo *	getESInfo ()
GlobalTimer *	getGlobalTimer () const
	Return associated GlobalTimer.
bool	setOutputRateFactor (double factor)
	Set output rate factor w.r.t.
double	getOutputRateFactor () const
	Returns output rate factor.
bool	adjust (double sec)
	Adjust the associated global timer to the given media time point.
virtual u32	getTranscodingCosts () const
	returns adaptation costs (CPU only)
Protected Attributes
ESInfo *	es
timeval	tv
long	frmCount
double	outputRate
	The output rate factor.

---

Detailed Description

Adaptor class Synchronizer handles stream synchronization can be used for VES and AES <short description="">.

Author:

Michael Kropfberger and Peter Schojer

Version:

Id

ESSynchronizer.hpp,v 1.15 2006/05/12 11:32:49 mkropfbe Exp

Definition at line 88 of file ESSynchronizer.hpp.

---

Member Function Documentation

list< Frame * > ESSynchronizer::adapt (  Frame *  frm  )  [virtual]

Blocks the calling data channel until the presentation time stamp (CTS) of the given frame matches the play-out media time returned by the associated GlobalTimer. If the frame lags behind the play-out time by more than ESSYNC_GRACE_MSECS milliseconds, the frame will be dropped. If the frame hurries ahead the play-out time by more than ESSYNC_DISCONT_MSECS milliseconds, a media stream discontinuity will be assumed and the GlobalTimer will be adjusted to the frame's CTS. Reimplemented from Adaptor. Definition at line 103 of file ESSynchronizer.cpp. References GlobalTimer::adjust(), VCondition::condWait(), GlobalTimer::getActualSec(), Frame::getAU(), ESInfo::getMediaTimeScale(), Frame::getMediaTimeScale(), VMutex::getMutexObject(), Frame::getType(), VMutex::lock(), Frame::markForDelete(), outputRate, VMutex::release(), and Frame::setMediaTimeScale(). { bool forwardFrame = false; list < Frame * >tmp; int act_wait; double t, tframe; /* block until not paused */ cond_pause_mutex.lock(); while (paused) { dprintf_full("ESSynchronizer::adapt() PAUSED @ %4.2f sec, frame %i\n", globalTimer->getActualSec(), frm->getAU()->cts); cond_pause.condWait(cond_pause_mutex.getMutexObject()); } cond_pause_mutex.release(); tmp.push_front(frm); //TURN OFF SYNC IF BENCHMARKING NETWORK! #ifdef NETBENCH #define FORCE_DISPLAY #endif #ifdef FORCE_DISPLAY forwardFrame = true; #endif Frame::FrameType myType = frm->getType(); #ifndef LOCALBENCH if ((myType == Frame::I_VOP) || (myType == Frame::P_VOP) || (myType == Frame::HEADER_VOP)) forwardFrame = true; #endif if(myType == Frame::NN_VOP || myType == Frame::MP3_AUDIO) forwardFrame = true; if (frmCount == 0) //always show first frame! forwardFrame = true; frmCount++; // a bypassing YUV_VOP or RGB_VOP is fully subjected to dropping, if time is out! if(frm->getMediaTimeScale() == 0) frm->setMediaTimeScale(es->getMediaTimeScale()); assert(frm->getMediaTimeScale() != 0); t = (double) frm->getMediaTimeScale(); if (outputRate != 1.0) t *= outputRate; tframe = (double)frm->getAU()->cts / t; // play-out time in seconds act_wait = (int) ((tframe - globalTimer->getActualSec()) * 1000.0 ); //dprintf_full("ESSynchronizer::adapt() frame type=%d forwarding=%d cts=%d timescale(t)=%f tframe=%f\n", // myType, forwardFrame, frm->getAU()->cts, t, tframe); /* Detect discontinuity in stream and re-synchronize GlobalTimer. * Re-synchronization is done only if the current frame is *ahead* * of play-out time to avoid competing with * SDLaudioIO:sdl_audio_callback(). */ if (act_wait > ESSYNC_DISCONT_MSECS) { dprintf_small("ESSynchronizer::adapt() detected stream discontinuity (%d > %d, " "re-synchronizing globalTimer to %4.2f sec\n", act_wait, ESSYNC_DISCONT_MSECS, tframe); globalTimer->adjust(tframe); act_wait = 0; } //dprintf_full("ESSynchronizer::adapt @ %4.2f sec, outputRate %5.3f, frameCTS %i (size %i) -> act_wait: %i\n", // globalTimer->getActualSec(), outputRate, frm->getAU()->cts, frm->getAU()->size,act_wait); if (act_wait > (-1) * ESSYNC_GRACE_MSECS) { forwardFrame = true; } if (forwardFrame) { if(act_wait >= 10 /*&& frm->getType() != Frame::MP3_AUDIO*/) msleep(act_wait); } else { //not forward frame dprintf_err("ESSynchronizer::adapt -> act_wait: %i DROPPING frame (dropCount=%d) ... missed CTS %i!!!\n", act_wait, ++dropCount, frm->getAU()->cts); //deletion is done in DataChannel! frm->markForDelete(); return tmp; } return tmp; }

bool ESSynchronizer::adjust (  double  sec  )

Adjust the associated global timer to the given media time point. Note that the GlobalTimer::adjust(double) method adjusts to a play-out time point, which is different from the media time point if the output rate factor is not equal to 1.0. Parameters: sec  media time point in seconds. Returns: true on success. Definition at line 85 of file ESSynchronizer.cpp. References GlobalTimer::adjust(), and outputRate. { if (!globalTimer || sec < 0.0) return false; globalTimer->adjust(sec / outputRate); return true; }

Adaptor* ESSynchronizer::clone (   )  [inline, virtual]

Create a shallow copy of the Adaptor. Creates an Adaptor with the same setup (without copying the current status). Returns: An Adaptor object. Implements Adaptor. Definition at line 112 of file ESSynchronizer.hpp. { return new ESSynchronizer(es,globalTimer); };

list< Frame * > ESSynchronizer::close (   )  [inline, virtual]

Close and destroy an Adaptor. Releases all internally buffered frame objects, and deallocate all allocated memory. The Adaptor must not be used after calling the close method!!! Returns: List of adapted Frame objects. Reimplemented from Adaptor. Definition at line 116 of file ESSynchronizer.hpp. { list < Frame * >tmp; return tmp; };

double ESSynchronizer::getOutputRateFactor (   )  const [inline]

Returns output rate factor. See also: setOutputRateFactor(double) Definition at line 154 of file ESSynchronizer.hpp. References outputRate. { return outputRate; }

void ESSynchronizer::initialize (   )  [virtual]

Initialize internal data structures. Implements Adaptor. Definition at line 70 of file ESSynchronizer.cpp. { }

void ESSynchronizer::setESInfo (  ESInfo *  esi  )  [inline, virtual]

Sets a reference to an ESInfo object. Adaptors are allowed to change ESInfo objects. If you don't want that, pass an es->clone() Reimplemented from Adaptor. Definition at line 137 of file ESSynchronizer.hpp. {es=esi;};

bool ESSynchronizer::setOutputRateFactor (  double  factor  )

Set output rate factor w.r.t. media frame rate. E.g. setting this value to 0.5 will cause a 30 Hz media stream to be forwarded with 15 Hz. Parameters: factor  must be positive; 1.0 means media frame rate. Returns: true on success. Definition at line 74 of file ESSynchronizer.cpp. References GlobalTimer::adjust(), GlobalTimer::getActualSec(), outputRate, and GlobalTimer::setPaused(). { if (factor <= 0.0 || !globalTimer) return false; globalTimer->setPaused(true); globalTimer->adjust(globalTimer->getActualSec() * outputRate / factor); outputRate = factor; globalTimer->setPaused(false); return true; }

void ESSynchronizer::setPaused (  bool  pause  )

Blocks/deblocks the data channel this ESSynchronizer adaptor belongs to. The associated GlobalTimer is not paused! As opposed to the corresponding method of GlobalTimer, the pause state of this class is binary, i.e. the calling sequence setPaused(true) - setPaused(true) - setPaused(false) will yield a pause state of false (no reference counting). Parameters: pause  if true, the data channel will be blocked; if false, it will be deblocked. See also: GlobalTimer::setPaused(bool) Definition at line 93 of file ESSynchronizer.cpp. References VMutex::lock(), VMutex::release(), and VCondition::signal(). Referenced by SDLaudioIO::open(), DSPaudioIO::open(), and DSPaudioIO::writeFrame(). { cond_pause_mutex.lock(); paused = pause; if (!paused) cond_pause.signal(); cond_pause_mutex.release(); }

---

Member Data Documentation

double ESSynchronizer::outputRate [protected]

The output rate factor. 1.0 means media frame rate. Definition at line 187 of file ESSynchronizer.hpp. Referenced by adapt(), adjust(), getOutputRateFactor(), and setOutputRateFactor().

---

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

• ESSynchronizer.hpp
• ESSynchronizer.cpp

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