live: AC3AudioStreamFramer Class Reference

typedef void( FramedSource::afterGettingFunc)(void *clientData, unsigned frameSize, unsigned numTruncatedBytes, struct timeval presentationTime, unsigned durationInMicroseconds) [inherited]

Definition at line 36 of file FramedSource.hh.

typedef void( FramedSource::onCloseFunc)(void *clientData) [inherited]

Definition at line 40 of file FramedSource.hh.

AC3AudioStreamFramer::AC3AudioStreamFramer	(	UsageEnvironment &	env,
		FramedSource *	inputSource,
		unsigned char	streamCode
	)			`[private]`

Definition at line 86 of file AC3AudioStreamFramer.cpp.

References AC3AudioStreamParser, fNextFramePresentationTime, fParser, FramedFilter::inputSource(), and NULL.

Referenced by createNew().

00089   : FramedFilter(env, inputSource), fOurStreamCode(streamCode) {
00090   // Use the current wallclock time as the initial 'presentation time':
00091   gettimeofday(&fNextFramePresentationTime, NULL);
00092 
00093   fParser = new AC3AudioStreamParser(this, inputSource);
00094 }

AC3AudioStreamFramer::~AC3AudioStreamFramer ( ) [private, virtual]

Definition at line 96 of file AC3AudioStreamFramer.cpp.

References fParser.

00096                                             {
00097   delete fParser;
00098 }

AC3AudioStreamFramer * AC3AudioStreamFramer::createNew	(	UsageEnvironment &	env,
		FramedSource *	inputSource,
		unsigned char	streamCode = `0x80`
	)			`[static]`

Definition at line 101 of file AC3AudioStreamFramer.cpp.

References AC3AudioStreamFramer(), env, and FramedFilter::inputSource().

Referenced by MPEG1or2DemuxedServerMediaSubsession::createNewStreamSource().

00103                                                           {
00104   // Need to add source type checking here???  #####
00105   return new AC3AudioStreamFramer(env, inputSource, streamCode);
00106 }

unsigned AC3AudioStreamFramer::samplingRate ( )

Definition at line 108 of file AC3AudioStreamFramer.cpp.

References AC3AudioStreamParser::currentFrame(), fParser, AC3AudioStreamParser::haveParsedAFrame(), AC3AudioStreamParser::readAndSaveAFrame(), and AC3FrameParams::samplingFreq.

00108                                             {
00109   if (!fParser->haveParsedAFrame()) {
00110     // Because we haven't yet parsed a frame, we don't yet know the input
00111     // stream's sampling rate.  So, we first need to read a frame
00112     // (into a special buffer that we keep around for later use).
00113     fParser->readAndSaveAFrame();
00114   }
00115 
00116   return fParser->currentFrame().samplingFreq;
00117 }

void AC3AudioStreamFramer::flushInput ( )

Definition at line 119 of file AC3AudioStreamFramer.cpp.

References StreamParser::flushInput(), and fParser.

00119                                       {
00120   fParser->flushInput();
00121 }

void AC3AudioStreamFramer::handleNewData	(	void *	clientData,
		unsigned char *	ptr,
		unsigned	size,
		struct timeval	presentationTime
	)			`[static, private]`

Definition at line 146 of file AC3AudioStreamFramer.cpp.

References handleNewData().

Referenced by handleNewData().

00147                                                      {
00148   AC3AudioStreamFramer* framer = (AC3AudioStreamFramer*)clientData;
00149   framer->handleNewData(ptr, size);
00150 }

void AC3AudioStreamFramer::handleNewData	(	unsigned char *	ptr,
		unsigned	size
	)			`[private]`

Definition at line 153 of file AC3AudioStreamFramer.cpp.

References fOurStreamCode, fParser, parseNextFrame(), and AC3AudioStreamParser::testStreamCode().

00153                                                  {
00154   if (!fParser->testStreamCode(fOurStreamCode, ptr, size)) {
00155     // This block of data is not for us; try again:
00156     parseNextFrame();
00157     return;
00158   }
00159 
00160   // Now that we know that this data is for us, get the next frame:
00161   parseNextFrame();
00162 }

void AC3AudioStreamFramer::parseNextFrame ( ) [private]

Definition at line 164 of file AC3AudioStreamFramer.cpp.

References FramedSource::afterGetting(), currentFramePlayTime(), FramedSource::fDurationInMicroseconds, FramedSource::fFrameSize, fNextFramePresentationTime, FramedSource::fNumTruncatedBytes, fParser, FramedSource::fPresentationTime, MILLION, and AC3AudioStreamParser::parseFrame().

Referenced by doGetNextFrame(), and handleNewData().

00164                                           {
00165   unsigned acquiredFrameSize = fParser->parseFrame(fNumTruncatedBytes);
00166   if (acquiredFrameSize > 0) {
00167     // We were able to acquire a frame from the input.
00168     // It has already been copied to the reader's space.
00169     fFrameSize = acquiredFrameSize;
00170 
00171     // Also set the presentation time, and increment it for next time,
00172     // based on the length of this frame:
00173     fPresentationTime = fNextFramePresentationTime;
00174 
00175     struct timeval framePlayTime = currentFramePlayTime();
00176     fDurationInMicroseconds = framePlayTime.tv_sec*MILLION + framePlayTime.tv_usec;
00177     fNextFramePresentationTime.tv_usec += framePlayTime.tv_usec;
00178     fNextFramePresentationTime.tv_sec
00179       += framePlayTime.tv_sec + fNextFramePresentationTime.tv_usec/MILLION;
00180     fNextFramePresentationTime.tv_usec %= MILLION;
00181 
00182     // Call our own 'after getting' function.  Because we're not a 'leaf'
00183     // source, we can call this directly, without risking infinite recursion.
00184     afterGetting(this);
00185   } else {
00186     // We were unable to parse a complete frame from the input, because:
00187     // - we had to read more data from the source stream, or
00188     // - the source stream has ended.
00189   }
00190 }

void AC3AudioStreamFramer::doGetNextFrame ( ) [private, virtual]

Implements FramedSource.

Definition at line 123 of file AC3AudioStreamFramer.cpp.

References FramedSource::fMaxSize, fParser, FramedSource::fTo, parseNextFrame(), and AC3AudioStreamParser::registerReadInterest().

00123                                           {
00124   fParser->registerReadInterest(fTo, fMaxSize);
00125   parseNextFrame();
00126 }

struct timeval AC3AudioStreamFramer::currentFramePlayTime ( ) const [read, private]

Definition at line 130 of file AC3AudioStreamFramer.cpp.

References AC3AudioStreamParser::currentFrame(), fParser, MILLION, and AC3FrameParams::samplingFreq.

Referenced by parseNextFrame().

00130                                                                 {
00131   AC3FrameParams const& fr = fParser->currentFrame();
00132   unsigned const numSamples = 1536;
00133   unsigned const freq = fr.samplingFreq;
00134 
00135   // result is numSamples/freq
00136   unsigned const uSeconds = (freq == 0) ? 0
00137     : ((numSamples*2*MILLION)/freq + 1)/2; // rounds to nearest integer
00138 
00139   struct timeval result;
00140   result.tv_sec = uSeconds/MILLION;
00141   result.tv_usec = uSeconds%MILLION;
00142   return result;
00143 }

FramedSource* FramedFilter::inputSource ( ) const [inline, inherited]

Definition at line 30 of file FramedFilter.hh.

References FramedFilter::fInputSource.

Referenced by AC3AudioStreamFramer(), EndianSwap16::createNew(), HostFromNetworkOrder16::createNew(), NetworkFromHostOrder16::createNew(), PCMFromuLawAudioSource::createNew(), QCELPDeinterleaver::createNew(), MPEG4VideoStreamFramer::createNew(), MPEG4VideoStreamDiscreteFramer::createNew(), MPEG2IFrameIndexFromTransportStream::createNew(), MPEG1or2VideoStreamFramer::createNew(), MPEG1or2VideoStreamDiscreteFramer::createNew(), MPEG1or2AudioStreamFramer::createNew(), MP3Transcoder::createNew(), MP3ADUTranscoder::createNew(), MP3ADUdeinterleaver::createNew(), MP3ADUinterleaver::createNew(), MP3FromADUSource::createNew(), ADUFromMP3Source::createNew(), H263plusVideoStreamFramer::createNew(), createNew(), H264VideoRTPSink::doSpecialFrameHandling(), MP3ADUinterleaverBase::getInputSource(), H263plusVideoStreamFramer::H263plusVideoStreamFramer(), MPEG1or2VideoStreamFramer::MPEG1or2VideoStreamFramer(), MPEG4VideoStreamFramer::MPEG4VideoStreamFramer(), MP3AudioFileServerMediaSubsession::seekStreamSource(), ClientTrickPlayState::setSource(), and MP3AudioFileServerMediaSubsession::setStreamSourceScale().

00030 { return fInputSource; }

char const * FramedFilter::MIMEtype ( ) const [protected, virtual, inherited]

Reimplemented from MediaSource.

Reimplemented in ADUFromMP3Source, and MP3FromADUSource.

Definition at line 39 of file FramedFilter.cpp.

References FramedFilter::fInputSource, MediaSource::MIMEtype(), and NULL.

00039                                          {
00040   if (fInputSource == NULL) return "";
00041 
00042   return fInputSource->MIMEtype();
00043 }

void FramedFilter::getAttributes ( ) const [protected, virtual, inherited]

Reimplemented from MediaSource.

Reimplemented in MP3ADUTranscoder.

Definition at line 45 of file FramedFilter.cpp.

References FramedFilter::fInputSource, MediaSource::getAttributes(), and NULL.

00045                                        {
00046   if (fInputSource != NULL) fInputSource->getAttributes();
00047 }

void FramedFilter::doStopGettingFrames ( ) [protected, virtual, inherited]

Reimplemented from FramedSource.

Reimplemented in MPEG2TransportStreamFramer, and MPEG2TransportStreamTrickModeFilter.

Definition at line 49 of file FramedFilter.cpp.

References FramedFilter::fInputSource, NULL, and FramedSource::stopGettingFrames().

Referenced by MPEG2TransportStreamTrickModeFilter::doStopGettingFrames(), and MPEG2TransportStreamFramer::doStopGettingFrames().

00049                                        {
00050   if (fInputSource != NULL) fInputSource->stopGettingFrames();
00051 }

Boolean FramedSource::lookupByName	(	UsageEnvironment &	env,
		char const *	sourceName,
		FramedSource *&	resultSource
	)			`[static, inherited]`

Definition at line 41 of file FramedSource.cpp.

References env, False, MediaSource::isFramedSource(), MediaSource::lookupByName(), NULL, and True.

Referenced by MP3ADUinterleaverBase::getInputSource().

00042                                                                 {
00043   resultSource = NULL; // unless we succeed
00044 
00045   MediaSource* source;
00046   if (!MediaSource::lookupByName(env, sourceName, source)) return False;
00047 
00048   if (!source->isFramedSource()) {
00049     env.setResultMsg(sourceName, " is not a framed source");
00050     return False;
00051   }
00052 
00053   resultSource = (FramedSource*)source;
00054   return True;
00055 }

Boolean MediaSource::lookupByName	(	UsageEnvironment &	env,
		char const *	sourceName,
		MediaSource *&	resultSource
	)			`[static, inherited]`

Definition at line 62 of file MediaSource.cpp.

References env, False, Medium::isSource(), Medium::lookupByName(), NULL, and True.

Referenced by RTPSource::lookupByName(), and FramedSource::lookupByName().

00064                                                               {
00065   resultSource = NULL; // unless we succeed
00066 
00067   Medium* medium;
00068   if (!Medium::lookupByName(env, sourceName, medium)) return False;
00069 
00070   if (!medium->isSource()) {
00071     env.setResultMsg(sourceName, " is not a media source");
00072     return False;
00073   }
00074 
00075   resultSource = (MediaSource*)medium;
00076   return True;
00077 }

Boolean Medium::lookupByName	(	UsageEnvironment &	env,
		char const *	mediumName,
		Medium *&	resultMedium
	)			`[static, inherited]`

Definition at line 65 of file Media.cpp.

References env, False, MediaLookupTable::lookup(), NULL, MediaLookupTable::ourMedia(), UsageEnvironment::setResultMsg(), and True.

Referenced by ServerMediaSession::lookupByName(), RTSPServer::lookupByName(), RTSPClient::lookupByName(), RTCPInstance::lookupByName(), MediaSource::lookupByName(), MediaSink::lookupByName(), MediaSession::lookupByName(), and DarwinInjector::lookupByName().

00066                                                          {
00067   resultMedium = MediaLookupTable::ourMedia(env)->lookup(mediumName);
00068   if (resultMedium == NULL) {
00069     env.setResultMsg("Medium ", mediumName, " does not exist");
00070     return False;
00071   }
00072 
00073   return True;
00074 }

void FramedSource::getNextFrame	(	unsigned char *	to,
		unsigned	maxSize,
		afterGettingFunc *	afterGettingFunc,
		void *	afterGettingClientData,
		onCloseFunc *	onCloseFunc,
		void *	onCloseClientData
	)			`[inherited]`

Definition at line 57 of file FramedSource.cpp.

References FramedSource::doGetNextFrame(), Medium::envir(), FramedSource::fAfterGettingClientData, FramedSource::fAfterGettingFunc, FramedSource::fDurationInMicroseconds, FramedSource::fIsCurrentlyAwaitingData, FramedSource::fMaxSize, FramedSource::fNumTruncatedBytes, FramedSource::fOnCloseClientData, FramedSource::fOnCloseFunc, FramedSource::fTo, and True.

00061                                                          {
00062   // Make sure we're not already being read:
00063   if (fIsCurrentlyAwaitingData) {
00064     envir() << "FramedSource[" << this << "]::getNextFrame(): attempting to read more than once at the same time!\n";
00065     exit(1);
00066   }
00067 
00068   fTo = to;
00069   fMaxSize = maxSize;
00070   fNumTruncatedBytes = 0; // by default; could be changed by doGetNextFrame()
00071   fDurationInMicroseconds = 0; // by default; could be changed by doGetNextFrame()
00072   fAfterGettingFunc = afterGettingFunc;
00073   fAfterGettingClientData = afterGettingClientData;
00074   fOnCloseFunc = onCloseFunc;
00075   fOnCloseClientData = onCloseClientData;
00076   fIsCurrentlyAwaitingData = True;
00077 
00078   doGetNextFrame();
00079 }

void FramedSource::handleClosure ( void * clientData ) [static, inherited]

Definition at line 95 of file FramedSource.cpp.

References False, FramedSource::fIsCurrentlyAwaitingData, FramedSource::fOnCloseClientData, FramedSource::fOnCloseFunc, and NULL.

00095                                                  {
00096   FramedSource* source = (FramedSource*)clientData;
00097   source->fIsCurrentlyAwaitingData = False; // because we got a close instead
00098   if (source->fOnCloseFunc != NULL) {
00099     (*(source->fOnCloseFunc))(source->fOnCloseClientData);
00100   }
00101 }

void FramedSource::stopGettingFrames ( ) [inherited]

Definition at line 103 of file FramedSource.cpp.

References FramedSource::doStopGettingFrames(), False, and FramedSource::fIsCurrentlyAwaitingData.

Referenced by MPEG2TransportStreamFromPESSource::doStopGettingFrames(), FramedFilter::doStopGettingFrames(), AMRDeinterleaver::doStopGettingFrames(), and MediaSink::stopPlaying().

00103                                      {
00104   fIsCurrentlyAwaitingData = False; // indicates that we can be read again
00105 
00106   // Perform any specialized action now:
00107   doStopGettingFrames();
00108 }

unsigned FramedSource::maxFrameSize ( ) const [virtual, inherited]

Reimplemented in MPEG1or2DemuxedElementaryStream.

Definition at line 116 of file FramedSource.cpp.

Referenced by StreamParser::ensureValidBytes1().

00116                                           {
00117   // By default, this source has no maximum frame size.
00118   return 0;
00119 }

Boolean FramedSource::isCurrentlyAwaitingData ( ) const [inline, inherited]

Definition at line 60 of file FramedSource.hh.

References FramedSource::fIsCurrentlyAwaitingData.

Referenced by afterPlaying(), InputESSourceRecord::askForNewData(), MPEG2TransportStreamFromESSource::awaitNewBuffer(), QuickTimeFileSink::continuePlaying(), AVIFileSink::continuePlaying(), DeviceSource::deliverFrame(), QCELPDeinterleaver::doGetNextFrame(), AMRDeinterleaver::doGetNextFrame(), ByteStreamFileSource::fileReadableHandler(), and BasicUDPSource::incomingPacketHandler1().

00060 {return fIsCurrentlyAwaitingData;}

void FramedSource::afterGetting ( FramedSource * source ) [static, protected, inherited]

Definition at line 81 of file FramedSource.cpp.

References FramedSource::fAfterGettingClientData, FramedSource::fAfterGettingFunc, False, FramedSource::fDurationInMicroseconds, FramedSource::fFrameSize, FramedSource::fIsCurrentlyAwaitingData, FramedSource::fNumTruncatedBytes, FramedSource::fPresentationTime, and NULL.

00081                                                     {
00082   source->fIsCurrentlyAwaitingData = False;
00083       // indicates that we can be read again
00084       // Note that this needs to be done here, in case the "fAfterFunc"
00085       // called below tries to read another frame (which it usually will)
00086 
00087   if (source->fAfterGettingFunc != NULL) {
00088     (*(source->fAfterGettingFunc))(source->fAfterGettingClientData,
00089                                    source->fFrameSize, source->fNumTruncatedBytes,
00090                                    source->fPresentationTime,
00091                                    source->fDurationInMicroseconds);
00092   }
00093 }

Boolean MediaSource::isRTPSource ( ) const [virtual, inherited]

Reimplemented in RTPSource.

Definition at line 43 of file MediaSource.cpp.

References False.

Referenced by RTPSource::lookupByName().

00043                                        {
00044   return False; // default implementation
00045 }

Boolean MediaSource::isMPEG1or2VideoStreamFramer ( ) const [virtual, inherited]

Reimplemented in MPEG1or2VideoStreamFramer.

Definition at line 46 of file MediaSource.cpp.

References False.

Referenced by MPEG1or2VideoRTPSink::sourceIsCompatibleWithUs().

00046                                                        {
00047   return False; // default implementation
00048 }

Boolean MediaSource::isMPEG4VideoStreamFramer ( ) const [virtual, inherited]

Reimplemented in MPEG4VideoStreamFramer.

Definition at line 49 of file MediaSource.cpp.

References False.

Referenced by MPEG4ESVideoRTPSink::sourceIsCompatibleWithUs().

00049                                                     {
00050   return False; // default implementation
00051 }

Boolean MediaSource::isH264VideoStreamFramer ( ) const [virtual, inherited]

Reimplemented in H264VideoStreamFramer.

Definition at line 52 of file MediaSource.cpp.

References False.

Referenced by H264VideoRTPSink::sourceIsCompatibleWithUs().

00052                                                    {
00053   return False; // default implementation
00054 }

Boolean MediaSource::isJPEGVideoSource ( ) const [virtual, inherited]

Reimplemented in JPEGVideoSource.

Definition at line 55 of file MediaSource.cpp.

References False.

Referenced by JPEGVideoRTPSink::sourceIsCompatibleWithUs().

00055                                              {
00056   return False; // default implementation
00057 }

Boolean MediaSource::isAMRAudioSource ( ) const [virtual, inherited]

Reimplemented in AMRAudioSource.

Definition at line 58 of file MediaSource.cpp.

References False.

Referenced by AMRAudioRTPSink::sourceIsCompatibleWithUs(), and AMRAudioFileSink::sourceIsCompatibleWithUs().

00058                                             {
00059   return False; // default implementation
00060 }

void Medium::close	(	UsageEnvironment &	env,
		char const *	mediumName
	)			`[static, inherited]`

Definition at line 76 of file Media.cpp.

References env, MediaLookupTable::ourMedia(), and MediaLookupTable::remove().

00076                                                           {
00077   MediaLookupTable::ourMedia(env)->remove(name);
00078 }

void Medium::close ( Medium * medium ) [static, inherited]

Definition at line 80 of file Media.cpp.

References Medium::close(), Medium::envir(), Medium::name(), and NULL.

00080                                  {
00081   if (medium == NULL) return;
00082 
00083   close(medium->envir(), medium->name());
00084 }

UsageEnvironment& Medium::envir ( ) const [inline, inherited]

Definition at line 59 of file Media.hh.

References Medium::fEnviron.


Public Types
typedef void(	afterGettingFunc )(void *clientData, unsigned frameSize, unsigned numTruncatedBytes, struct timeval presentationTime, unsigned durationInMicroseconds)
typedef void(	onCloseFunc )(void *clientData)
Public Member Functions
unsigned	samplingRate ()
void	flushInput ()
FramedSource *	inputSource () const
void	getNextFrame (unsigned char to, unsigned maxSize, afterGettingFunc afterGettingFunc, void afterGettingClientData, onCloseFunc onCloseFunc, void *onCloseClientData)
void	stopGettingFrames ()
virtual unsigned	maxFrameSize () const
Boolean	isCurrentlyAwaitingData () const
virtual Boolean	isRTPSource () const
virtual Boolean	isMPEG1or2VideoStreamFramer () const
virtual Boolean	isMPEG4VideoStreamFramer () const
virtual Boolean	isH264VideoStreamFramer () const
virtual Boolean	isJPEGVideoSource () const
virtual Boolean	isAMRAudioSource () const
UsageEnvironment &	envir () const
char const *	name () const
virtual Boolean	isSink () const
virtual Boolean	isRTCPInstance () const
virtual Boolean	isRTSPClient () const
virtual Boolean	isRTSPServer () const
virtual Boolean	isMediaSession () const
virtual Boolean	isServerMediaSession () const
virtual Boolean	isDarwinInjector () const
Static Public Member Functions
static AC3AudioStreamFramer *	createNew (UsageEnvironment &env, FramedSource *inputSource, unsigned char streamCode=0x80)
static Boolean	lookupByName (UsageEnvironment &env, char const sourceName, FramedSource &resultSource)
static Boolean	lookupByName (UsageEnvironment &env, char const sourceName, MediaSource &resultSource)
static Boolean	lookupByName (UsageEnvironment &env, char const mediumName, Medium &resultMedium)
static void	handleClosure (void *clientData)
static void	close (UsageEnvironment &env, char const *mediumName)
static void	close (Medium *medium)
Protected Member Functions
virtual char const *	MIMEtype () const
virtual void	getAttributes () const
virtual void	doStopGettingFrames ()
TaskToken &	nextTask ()
Static Protected Member Functions
static void	afterGetting (FramedSource *source)
Protected Attributes
FramedSource *	fInputSource
unsigned char *	fTo
unsigned	fMaxSize
unsigned	fFrameSize
unsigned	fNumTruncatedBytes
timeval	fPresentationTime
unsigned	fDurationInMicroseconds
Private Member Functions
	AC3AudioStreamFramer (UsageEnvironment &env, FramedSource *inputSource, unsigned char streamCode)
virtual	~AC3AudioStreamFramer ()
void	handleNewData (unsigned char *ptr, unsigned size)
void	parseNextFrame ()
virtual void	doGetNextFrame ()
timeval	currentFramePlayTime () const
Static Private Member Functions
static void	handleNewData (void clientData, unsigned char ptr, unsigned size, struct timeval presentationTime)
Private Attributes
timeval	fNextFramePresentationTime
AC3AudioStreamParser *	fParser
unsigned char	fOurStreamCode
Friends
class	AC3AudioStreamParser

AC3AudioStreamFramer Class Reference

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation