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

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

ContainerDemux Class Reference

is used for simple demultiplexing of mp4 streams, so adaptors can be easily applied for eg. <short description=""> More...

#include <ContainerDemux.hpp>

List of all members.

Static Public Member Functions
ContainerInfo *	demultiplex (ContainerInfo *&info, const char *outputDir, const Adaptor *visualAdaptor=NULL, bool omitHeader=false, bool deleteMP4=false, bool visualizeAdaptation=false)
	takes the info object and demultiplexes every ES into a separate file.
void	demultiplexAndUpdateIO (ContainerInfo *&mp4Info, const char *outputDir, const Adaptor *visualAdaptor=NULL, bool omitHeader=false, bool deleteMP4=false, bool visualizeAdaptation=false)
	same as demultiplex(..) but the input descriptors are updated to point to the new input.
void	adaptESInfo (ESInfo *es, const char *outputFile, Adaptor *adaptor=NULL, u32 startFrame=0u, u32 endFrame=4294967295u, bool omitHeader=false, bool visualize=false)
	adapts single ESInfo
void	adaptESInfo (ESInfo *es, const char *outputFile, Adaptor *adaptor=NULL, double startSecond=0.0, double endSecond=-1.0, bool omitHeader=false, bool visualize=false)
	adapts single ESInfo
DataChannel *	createDataChannel (ESInfo *es, const char *outputFile, Adaptor *adaptor=NULL, u32 startFrame=0u, u32 endFrame=4294967295u, bool omitHeader=false, bool visualize=false)
	creates a DataChannel which is ready for immediate use.

---

Detailed Description

is used for simple demultiplexing of mp4 streams, so adaptors can be easily applied for eg. <short description="">

transcoding

Author:

Michael Kropfberger and Peter Schojer

Version:

Id

ContainerDemux.hpp,v 1.9 2005/01/25 14:10:42 mkropfbe Exp

Definition at line 71 of file ContainerDemux.hpp.

---

Member Function Documentation

void ContainerDemux::adaptESInfo (  ESInfo *  es, const char *  outputFile, Adaptor *  adaptor = NULL, double  startSecond = 0.0, double  endSecond = -1.0, bool  omitHeader = false, bool  visualize = false )  [static]

adapts single ESInfo Parameters: es  with adaptor adaptor.  If outputFile  is set, the created output will be written to the file, otherwise DevNull will be used as output. startSecond  and endSecond  will not work with system files but only with demultiplexed es! Definition at line 164 of file ContainerDemux.cpp. References adaptESInfo(), and ESInfo::getFrameNumber(). { assert(es); u32 startFrame=es->getFrameNumber(startSecond); u32 endFrame=4294967295u; //2^32-1 if(endSecond > 0.0) endFrame=es->getFrameNumber(endSecond); ContainerDemux::adaptESInfo(es,outputFile,adaptor,(u32)startFrame,(u32)endFrame,omitHeader,visualize); }

void ContainerDemux::adaptESInfo (  ESInfo *  es, const char *  outputFile, Adaptor *  adaptor = NULL, u32  startFrame = 0u, u32  endFrame = 4294967295u, bool  omitHeader = false, bool  visualize = false )  [static]

adapts single ESInfo Parameters: es  with adaptor adaptor.  If outputFile  is set, the created output will be written to the file, otherwise DevNull will be used as output. startFrame  and endFrame  will not work with system files but only with demultiplexed es! Definition at line 145 of file ContainerDemux.cpp. References createDataChannel(), VThread::running(), VThread::start(), and VThread::wait(). Referenced by adaptESInfo(). { assert(es); DataChannel* dc = ContainerDemux::createDataChannel(es,outputFile,adaptor,startFrame,endFrame,omitHeader,visualize); if(!dc) return; dc->start(); if(dc->running()) { dc->wait(); } delete dc; }

DataChannel * ContainerDemux::createDataChannel (  ESInfo *  es, const char *  outputFile, Adaptor *  adaptor = NULL, u32  startFrame = 0u, u32  endFrame = 4294967295u, bool  omitHeader = false, bool  visualize = false )  [static]

creates a DataChannel which is ready for immediate use. A DataSink has been inserted and play was called for this DataSink. Access to the inserted DataSink is via id 0. Just start the returned DataChannel with dc->start(). Will return NULL if Parameters: es  is NULL. Definition at line 176 of file ContainerDemux.cpp. References DataChannel::insert(), DataChannel::play(), DataChannel::setAdaptor(), IO::setEndFrameNumber(), IO::setToClosestIFrame(), and DataChannel::visualizeCaching(). Referenced by adaptESInfo(). { assert(es); if(!es) // for release build where all asserts vanish return NULL; IO* input = IOCreator::createInput(es, false); input->setToClosestIFrame(startFrame); input->setEndFrameNumber(endFrame); IO* output=NULL; if(outputFile) output = new MPGStreamIO(es, outputFile, true, omitHeader); else output = new DevNull(); DataSink* datasink = new DataSink(0, output, "127.0.0.1", 0, NULL); DataChannel* dc = new DataChannel(input, es); if(visualize) dc->visualizeCaching(); dc->setAdaptor(adaptor); dc->insert(datasink); dc->play(0, 0.0); return dc; }

ContainerInfo * ContainerDemux::demultiplex (  ContainerInfo *&  info, const char *  outputDir, const Adaptor *  visualAdaptor = NULL, bool  omitHeader = false, bool  deleteMP4 = false, bool  visualizeAdaptation = false )  [static]

takes the info object and demultiplexes every ES into a separate file. A copy of the info object with updated input descriptors is returned. if outputDir is set to NULL, no output will be generated Only call this method with an .mp4 file as input. If an adaptor is set, each visualstream will be adapted with this adaptorDefinition at line 60 of file ContainerDemux.cpp. References ContainerInfo::clone(), and demultiplexAndUpdateIO(). { ContainerInfo * mp4New = mp4Info->clone(); ContainerDemux::demultiplexAndUpdateIO(mp4New, outputDir, visualAdaptor, omitHeader, deleteMP4, visualizeAdaptation); return mp4New; }

void ContainerDemux::demultiplexAndUpdateIO (  ContainerInfo *&  mp4Info, const char *  outputDir, const Adaptor *  visualAdaptor = NULL, bool  omitHeader = false, bool  deleteMP4 = false, bool  visualizeAdaptation = false )  [static]

same as demultiplex(..) but the input descriptors are updated to point to the new input. Per default the MP4FILE is NOT DELETED! if outputDir is set to NULL, no output will be generated If an adaptor is set, each visualstream will be adapted with this adaptorDefinition at line 75 of file ContainerDemux.cpp. References DataChannel::enableCaching(), IO::getCurrentFrameNumber(), DataChannel::getESInfo(), ContainerInfo::getESList(), DataChannel::getInput(), ContainerInfo::getLocalFile(), ESInfo::getNumberOfMediaSamples(), ESInfo::getVOPTimeIncrement(), VThread::running(), ESInfo::setCompleteState(), ESInfo::setDuration(), Adaptor::setESInfo(), VThread::start(), and VThread::wait(). Referenced by demultiplex(), MP7File::generateMP7Description(), and MP7File::writeVariationSet(). { list < ESInfo * > *es = mp4Info->getESList(); assert(es && es->size() > 0); list < ESInfo * >::iterator li = es->begin(); DataChannel **dc = new DataChannel *[es->size()]; for (int i = 0; i < (int) es->size(); i++) { // for each ES create a DataChannel, MP4IO will be used for reading dc[i] = new DataChannel(IOCreator::createInput((*li), false), (*li)); char *out = dc[i]->enableCaching(omitHeader,outputDir); (*li)->setInput(out); delete[] out; if ((*li)->isVisualStream() && visualAdaptor != NULL) { Adaptor* at=((Adaptor*)visualAdaptor)->clone(); at->setESInfo(*li); dc[i]->setAdaptor(at); } if (visualizeAdaptation && (*li)->isVisualStream()) { dc[i]->visualizeCaching(); } ++li; } // rewind the iterator li = es->begin(); for (int j = 0; j < (int) es->size(); j++) { // start & wait for each thread to finish // -> ISOMP4 lib is not thread safe dc[j]->start(); if(dc[j]->running()) dc[j]->wait(); /* the stream may have contained empty frames, * so update the duration to avoid inconsistent * ESInfo::frameStatistics */ ESInfo *ess = (ESInfo *) dc[j]->getESInfo(); u32 essFrames = ess->getNumberOfMediaSamples(); u32 readFrames = dc[j]->getInput()->getCurrentFrameNumber(); if (readFrames != essFrames) { dprintf_full("ContainerDemux::demultiplexAndUpdateIO() stream %d: read %u frames, correcting ESInfo (was %u)\n", j, readFrames, essFrames); ess->setDuration((u64) readFrames * (u64) ess->getVOPTimeIncrement()); } ess->setCompleteState(true); delete dc[j]; } delete[] dc; // now delete the mp4file if (deleteMP4) { dprintf_full("ISOMP4ContainerFile::demultiplexAndUpdateIO: Deleting ISOMP4ContainerFile\r\n"); FILE *fp = fopen(mp4Info->getLocalFile(), "w"); if (fp) { fclose(fp); remove(mp4Info->getLocalFile()); } } }

---

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

• ContainerDemux.hpp
• ContainerDemux.cpp

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