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

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

DataDump Class Reference

Adaptor class DataDump stores each passing frame to disk (any IO), but also inserts old frames if one was missing, to adhere to frame dropping adaptation if this automatic insertion feature is not wanted, set the corresponding constructor flag! <short description="">. More...

#include <DataDump.hpp>

Inheritance diagram for DataDump:

List of all members.

Public Member Functions
	DataDump (ESInfo *esi, IO *outStream, bool autoFix=true)
list< Frame * >	adapt (Frame *frm)
	Accepts as input a frame, and checks if it can adapt the frame, If the frame is modified, a new Frame object is created and inserted into the return list.
Adaptor *	clone ()
	Create a shallow copy of the Adaptor.
void	initialize ()
	Initialize internal data structures.
list< Frame * >	close ()
	Close and destroy an Adaptor.
void	setESInfo (ESInfo *esi)
	Sets a reference to an ESInfo object.
ESInfo *	getESInfo ()
u32	getTranscodingCosts () const
	returns adaptation costs (CPU only).
Protected Attributes
ESInfo *	es
IO *	out
bool	autoFix
AU	lastAU
u8 *	lastPayload
Frame *	dummyFrame
int	numFrames

---

Detailed Description

Adaptor class DataDump stores each passing frame to disk (any IO), but also inserts old frames if one was missing, to adhere to frame dropping adaptation if this automatic insertion feature is not wanted, set the corresponding constructor flag! <short description="">.

Author:

Michael Kropfberger

Version:

Id

DataDump.hpp,v 1.5 2006/01/20 15:37:17 mkropfbe Exp

Definition at line 64 of file DataDump.hpp.

---

Member Function Documentation

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

Accepts as input a frame, and checks if it can adapt the frame, If the frame is modified, a new Frame object is created and inserted into the return list. This new frame is returned only, if the size of the payload is larger than zero. If the frame was not modified, it is also inserted into the list. For more complex adaptors, it will happen, that the adaptor caches up one complete GOP and returns the full GOP in network order. A caching adaptor has to create deep-copies for each frames. Never directly modify the payload of the input frm, always create copies!!! Parameters: frm  object to adapt. An Adaptor is never allowed to free the input frame. This has to be done in the caller. Returns: List of adapted Frame objects Reimplemented from Adaptor. Definition at line 83 of file DataDump.cpp. References Frame::getAU(), VideoFrame::getHeight(), Frame::getMediaTimeScale(), ESInfo::getMediaTimeScale(), IO::getURL(), ESInfo::getVOPTimeIncrement(), VideoFrame::getWidth(), IO::open(), Frame::setAU(), Frame::setMediaTimeScale(), Frame::unsetAU(), and IO::writeFrame(). { list < Frame * >tmp; u32 thisCTS; int thisSec; int done=0; //call open on first frame if (numFrames == 0) if (!out->open()) { dprintf_err("DataDump: FATAL: not writing, since another IO class is accessing file %s\n",out->getURL()); //standard forwarding adaptor behaviour tmp.push_front(frm); return tmp; } UncompressedVideoFrame *thisFrame = (UncompressedVideoFrame*)frm; thisCTS = frm->getAU()->cts; thisSec = (int)floor((double)thisCTS / es->getMediaTimeScale()); dprintf_full("DataDump::adapt frame %i CTS %i, VOP increment %i\n", numFrames, thisCTS,es->getVOPTimeIncrement()); //FIXME: assert(isVideoFrame) //first frame, malloc payload, size is always the same for YUV frames! if (!lastAU.payload) { dprintf_full("DataDump::adapt creating initial buffers\n"); lastPayload = (u8*)malloc(thisFrame->getAU()->size); lastAU.payload = lastPayload; lastAU.size = thisFrame->getAU()->size; dummyFrame = new UncompressedVideoFrame(Frame::NN_VOP, thisFrame->getWidth(), thisFrame->getHeight()); dummyFrame->setMediaTimeScale(thisFrame->getMediaTimeScale()); dummyFrame->setAU(&lastAU,false); //disable detectFrameType() for efficiency! } while(!done) { if (numFrames * es->getVOPTimeIncrement() == thisCTS) { //NO FRAME LOSS out->writeFrame(thisFrame); done=1; } else if (autoFix) { //catch up BECAUSE OF FRAME LOSS dprintf_full("DataDump::adapt %i dummyADAPT!\n",numFrames); out->writeFrame(dummyFrame); } numFrames++; } // assert(lastAU.size == thisFrame->getAU()->size); dummyFrame->unsetAU(); lastAU = thisFrame->getAU(); lastAU.payload = lastPayload; lastAU.size = thisFrame->getAU()->size; memcpy(lastAU.payload, thisFrame->getAU()->payload, thisFrame->getAU()->size); dummyFrame->setAU(&lastAU,false); //disable detectFrameType() for efficiency! //standard forwarding adaptor behaviour tmp.push_front(frm); return tmp; }

Adaptor* DataDump::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 78 of file DataDump.hpp. { return new DataDump(es, new DevNull(), autoFix); };

list< Frame * > DataDump::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 82 of file DataDump.hpp. { list < Frame * >tmp; return tmp; };

u32 DataDump::getTranscodingCosts (   )  const [inline, virtual]

returns adaptation costs (CPU only). This adaptor causes hd costs, which are currently ignored. as CPU side effect we can only guess but it should depend on the bytes of the video Implements Adaptor. Definition at line 99 of file DataDump.hpp. References ESInfo::getAvgBandwidth(). { return es->getAvgBandwidth()/8; }

void DataDump::initialize (   )  [virtual]

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

void DataDump::setESInfo (  ESInfo *  esi  )  [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 73 of file DataDump.cpp. { es = esi; }

---

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

• DataDump.hpp
• DataDump.cpp

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