MPEG2TransportStreamFromESSource Class Reference

#include <MPEG2TransportStreamFromESSource.hh>

Inheritance diagram for MPEG2TransportStreamFromESSource:

[legend]Collaboration diagram for MPEG2TransportStreamFromESSource:


Public Types
typedef void(	afterGettingFunc )(void *clientData, unsigned frameSize, unsigned numTruncatedBytes, struct timeval presentationTime, unsigned durationInMicroseconds)
typedef void(	onCloseFunc )(void *clientData)
Public Member Functions
void	addNewVideoSource (FramedSource *inputSource, int mpegVersion)
void	addNewAudioSource (FramedSource *inputSource, int mpegVersion)
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 void	getAttributes () const
virtual char const *	MIMEtype () 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 MPEG2TransportStreamFromESSource *	createNew (UsageEnvironment &env)
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
	MPEG2TransportStreamFromESSource (UsageEnvironment &env)
virtual	~MPEG2TransportStreamFromESSource ()
void	handleNewBuffer (unsigned char *buffer, unsigned bufferSize, int mpegVersion, MPEG1or2Demux::SCR scr)
TaskToken &	nextTask ()
Static Protected Member Functions
static void	afterGetting (FramedSource *source)
Protected Attributes
Boolean	fHaveVideoStreams
unsigned char *	fTo
unsigned	fMaxSize
unsigned	fFrameSize
unsigned	fNumTruncatedBytes
timeval	fPresentationTime
unsigned	fDurationInMicroseconds
Private Member Functions
virtual void	doStopGettingFrames ()
virtual void	awaitNewBuffer (unsigned char *oldBuffer)
void	addNewInputSource (FramedSource *inputSource, u_int8_t streamId, int mpegVersion)
Private Attributes
InputESSourceRecord *	fInputSources
unsigned	fVideoSourceCounter
unsigned	fAudioSourceCounter
Friends
class	InputESSourceRecord

Detailed Description

Definition at line 29 of file MPEG2TransportStreamFromESSource.hh.

Member Typedef Documentation

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.

Constructor & Destructor Documentation

MPEG2TransportStreamFromESSource::MPEG2TransportStreamFromESSource ( UsageEnvironment & env ) [protected]

Definition at line 95 of file MPEG2TransportStreamFromESSource.cpp.

References False.

00096   : MPEG2TransportStreamMultiplexor(env),
00097     fInputSources(NULL), fVideoSourceCounter(0), fAudioSourceCounter(0) {
00098   fHaveVideoStreams = False; // unless we add a video source
00099 }

MPEG2TransportStreamFromESSource::~MPEG2TransportStreamFromESSource ( ) [protected, virtual]

Definition at line 101 of file MPEG2TransportStreamFromESSource.cpp.

References fInputSources.

00101                                                                     {
00102   delete fInputSources;
00103 }

Member Function Documentation

MPEG2TransportStreamFromESSource * MPEG2TransportStreamFromESSource::createNew ( UsageEnvironment & env ) [static]

Definition at line 77 of file MPEG2TransportStreamFromESSource.cpp.

References env.

Referenced by main(), and ClientTrickPlayState::updateStateOnScaleChange().

00077                                  {
00078   return new MPEG2TransportStreamFromESSource(env);
00079 }

void MPEG2TransportStreamFromESSource::addNewVideoSource	(	FramedSource *	inputSource,
		int	mpegVersion
	)

Definition at line 82 of file MPEG2TransportStreamFromESSource.cpp.

References True.

Referenced by main(), and ClientTrickPlayState::updateStateOnScaleChange().

00082                                                               {
00083   u_int8_t streamId = 0xE0 | (fVideoSourceCounter++&0x0F);
00084   addNewInputSource(inputSource, streamId, mpegVersion);
00085   fHaveVideoStreams = True;
00086 }

void MPEG2TransportStreamFromESSource::addNewAudioSource	(	FramedSource *	inputSource,
		int	mpegVersion
	)

Definition at line 89 of file MPEG2TransportStreamFromESSource.cpp.

00089                                                               {
00090   u_int8_t streamId = 0xC0 | (fAudioSourceCounter++&0x0F);
00091   addNewInputSource(inputSource, streamId, mpegVersion);
00092 }

void MPEG2TransportStreamFromESSource::doStopGettingFrames ( ) [private, virtual]

Reimplemented from FramedSource.

Definition at line 105 of file MPEG2TransportStreamFromESSource.cpp.

References fInputSources, and NULL.

00105                                                            {
00106   // Stop each input source:
00107   for (InputESSourceRecord* sourceRec = fInputSources; sourceRec != NULL;
00108        sourceRec = sourceRec->next()) {
00109     sourceRec->inputSource()->stopGettingFrames();
00110   }
00111 }

void MPEG2TransportStreamFromESSource::awaitNewBuffer ( unsigned char * oldBuffer ) [private, virtual]

Implements MPEG2TransportStreamMultiplexor.

Definition at line 114 of file MPEG2TransportStreamFromESSource.cpp.

References InputESSourceRecord::askForNewData(), InputESSourceRecord::buffer(), InputESSourceRecord::deliverBufferToClient(), fInputSources, FramedSource::isCurrentlyAwaitingData(), InputESSourceRecord::next(), NULL, and InputESSourceRecord::reset().

Referenced by InputESSourceRecord::afterGettingFrame1().

00114                                          {
00115   InputESSourceRecord* sourceRec;
00116   // Begin by resetting the old buffer:
00117   if (oldBuffer != NULL) {
00118     for (sourceRec = fInputSources; sourceRec != NULL;
00119          sourceRec = sourceRec->next()) {
00120       if (sourceRec->buffer() == oldBuffer) {
00121         sourceRec->reset();
00122         break;
00123       }
00124     }
00125   }
00126 
00127   if (isCurrentlyAwaitingData()) {
00128     // Try to deliver one filled-in buffer to the client:
00129     for (sourceRec = fInputSources; sourceRec != NULL;
00130          sourceRec = sourceRec->next()) {
00131       if (sourceRec->deliverBufferToClient()) break;
00132     }
00133   }
00134 
00135   // No filled-in buffers are available. Ask each of our inputs for data:
00136   for (sourceRec = fInputSources; sourceRec != NULL;
00137        sourceRec = sourceRec->next()) {
00138     sourceRec->askForNewData();
00139   }
00140 
00141 }

void MPEG2TransportStreamFromESSource::addNewInputSource	(	FramedSource *	inputSource,
		u_int8_t	streamId,
		int	mpegVersion
	)			`[private]`

Definition at line 144 of file MPEG2TransportStreamFromESSource.cpp.

References fInputSources, InputESSourceRecord, and NULL.

00145                                                         {
00146   if (inputSource == NULL) return;
00147   fInputSources = new InputESSourceRecord(*this, inputSource, streamId,
00148                                           mpegVersion, fInputSources);
00149 }

void MPEG2TransportStreamMultiplexor::handleNewBuffer	(	unsigned char *	buffer,
		unsigned	bufferSize,
		int	mpegVersion,
		MPEG1or2Demux::SCR	scr
	)			`[protected, inherited]`

Definition at line 87 of file MPEG2TransportStreamMultiplexor.cpp.

Referenced by MPEG2TransportStreamFromPESSource::afterGettingFrame1(), and InputESSourceRecord::deliverBufferToClient().

00088                                                          {
00089   if (bufferSize < 4) return;
00090   fInputBuffer = buffer;
00091   fInputBufferSize = bufferSize;
00092   fInputBufferBytesUsed = 0;
00093 
00094   u_int8_t stream_id = fInputBuffer[3];
00095   // Use "stream_id" directly as our PID.
00096   // Also, figure out the Program Map 'stream type' from this.
00097   if (stream_id == 0xBE) { // padding_stream; ignore
00098     fInputBufferSize = 0;
00099   } else if (stream_id == 0xBC) { // program_stream_map
00100     setProgramStreamMap(fInputBufferSize);
00101     fInputBufferSize = 0; // then, ignore the buffer
00102   } else {
00103     fCurrentPID = stream_id;
00104 
00105     // Set the stream's type:
00106     u_int8_t& streamType = fPIDState[fCurrentPID].streamType; // alias
00107 
00108     if (streamType == 0) {
00109       // Instead, set the stream's type to default values, based on whether
00110       // the stream is audio or video, and whether it's MPEG-1 or MPEG-2:
00111       if ((stream_id&0xF0) == 0xE0) { // video
00112         streamType = mpegVersion == 1 ? 1 : mpegVersion == 2 ? 2 : 0x10;
00113       } else if ((stream_id&0xE0) == 0xC0) { // audio
00114         streamType = mpegVersion == 1 ? 3 : mpegVersion == 2 ? 4 : 0xF;
00115       } else if (stream_id == 0xBD) { // private_stream1 (usually AC-3)
00116         streamType = 0x06; // for DVB; for ATSC, use 0x81
00117       } else { // something else, e.g., AC-3 uses private_stream1 (0xBD)
00118         streamType = 0x81; // private
00119       }
00120     }
00121 
00122     if (fPCR_PID == 0) { // set it to this stream, if it's appropriate:
00123       if ((!fHaveVideoStreams && (streamType == 3 || streamType == 4 || streamType == 0xF))/* audio stream */ ||
00124           (streamType == 1 || streamType == 2 || streamType == 0x10)/* video stream */) {
00125         fPCR_PID = fCurrentPID; // use this stream's SCR for PCR
00126       }
00127     }
00128     if (fCurrentPID == fPCR_PID) {
00129       // Record the input's current SCR timestamp, for use as our PCR:
00130       fPCR = scr;
00131     }
00132   }
00133 
00134   // Now that we have new input data, retry the last delivery to the client:
00135   doGetNextFrame();
00136 }

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(), 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 }

void MediaSource::getAttributes ( ) const [virtual, inherited]

Reimplemented in FramedFilter, MP3ADUTranscoder, MP3FileSource, and RTPSource.

Definition at line 79 of file MediaSource.cpp.

References Medium::envir(), and UsageEnvironment::setResultMsg().

Referenced by MP3ADUTranscoder::getAttributes(), and FramedFilter::getAttributes().

00079                                       {
00080   // Default implementation
00081   envir().setResultMsg("");
00082 }

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

Reimplemented in RawAMRRTPSource, AC3AudioRTPSource, FramedFilter, H261VideoRTPSource, H263plusVideoRTPSource, H264VideoRTPSource, JPEGVideoRTPSource, ADUFromMP3Source, MP3FromADUSource, MP3ADURTPSource, MP3FileSource, MPEG1or2AudioRTPSource, MPEG1or2DemuxedElementaryStream, MPEG1or2VideoRTPSource, MPEG4ESVideoRTPSource, MPEG4GenericRTPSource, MPEG4LATMAudioRTPSource, QuickTimeGenericRTPSource, SimpleRTPSource, and RawQCELPRTPSource.

Definition at line 36 of file MediaSource.cpp.

Referenced by HTTPSink::continuePlaying(), MP3ADUTranscoder::createNew(), MP3FromADUSource::createNew(), ADUFromMP3Source::createNew(), MP3ADUinterleaverBase::getInputSource(), MediaSession::initiateByMediaType(), SimpleRTPSource::MIMEtype(), QuickTimeGenericRTPSource::MIMEtype(), FramedFilter::MIMEtype(), and MPEG1or2DemuxedElementaryStream::MPEG1or2DemuxedElementaryStream().

00036                                         {
00037   return "application/OCTET-STREAM"; // default type
00038 }

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.

MPEG2TransportStreamFromESSource Class Reference

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation