live: H264VideoStreamDiscreteFramer 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.

H264VideoStreamDiscreteFramer::H264VideoStreamDiscreteFramer	(	UsageEnvironment &	env,
		FramedSource *	inputSource
	)			`[protected]`

Definition at line 33 of file H264VideoStreamDiscreteFramer.cpp.

Referenced by createNew().

00034   : H264VideoStreamFramer(env, inputSource, False/*don't create a parser*/, False) {
00035 }

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

Definition at line 37 of file H264VideoStreamDiscreteFramer.cpp.

00037                                                               {
00038 }

H264VideoStreamDiscreteFramer * H264VideoStreamDiscreteFramer::createNew	(	UsageEnvironment &	env,
		FramedSource *	inputSource
	)			`[static]`

Definition at line 27 of file H264VideoStreamDiscreteFramer.cpp.

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

Referenced by ProxyServerMediaSubsession::createNewStreamSource(), and H264VideoMatroskaFileServerMediaSubsession::createNewStreamSource().

00027                                                                                          {
00028   // Need to add source type checking here???  #####
00029   return new H264VideoStreamDiscreteFramer(env, inputSource);
00030 }

void H264VideoStreamDiscreteFramer::doGetNextFrame ( ) [protected, virtual]

Reimplemented from MPEGVideoStreamFramer.

Definition at line 40 of file H264VideoStreamDiscreteFramer.cpp.

References afterGettingFrame(), FramedFilter::fInputSource, FramedSource::fMaxSize, FramedSource::fTo, FramedSource::getNextFrame(), and FramedSource::handleClosure().

00040                                                    {
00041   // Arrange to read data (which should be a complete H.264 NAL unit)
00042   // from our data source, directly into the client's input buffer.
00043   // After reading this, we'll do some parsing on the frame.
00044   fInputSource->getNextFrame(fTo, fMaxSize,
00045                              afterGettingFrame, this,
00046                              FramedSource::handleClosure, this);
00047 }

void H264VideoStreamDiscreteFramer::afterGettingFrame	(	void *	clientData,
		unsigned	frameSize,
		unsigned	numTruncatedBytes,
		struct timeval	presentationTime,
		unsigned	durationInMicroseconds
	)			`[static, protected]`

Definition at line 50 of file H264VideoStreamDiscreteFramer.cpp.

References afterGettingFrame1().

Referenced by doGetNextFrame().

00053                                                      {
00054   H264VideoStreamDiscreteFramer* source = (H264VideoStreamDiscreteFramer*)clientData;
00055   source->afterGettingFrame1(frameSize, numTruncatedBytes, presentationTime, durationInMicroseconds);
00056 }

void H264VideoStreamDiscreteFramer::afterGettingFrame1	(	unsigned	frameSize,
		unsigned	numTruncatedBytes,
		struct timeval	presentationTime,
		unsigned	durationInMicroseconds
	)			`[protected]`

Definition at line 59 of file H264VideoStreamDiscreteFramer.cpp.

References FramedSource::afterGetting(), Medium::envir(), FramedSource::fDurationInMicroseconds, FramedSource::fFrameSize, FramedSource::fNumTruncatedBytes, MPEGVideoStreamFramer::fPictureEndMarker, FramedSource::fPresentationTime, FramedSource::fTo, H264VideoStreamFramer::saveCopyOfPPS(), H264VideoStreamFramer::saveCopyOfSPS(), and True.

Referenced by afterGettingFrame().

00061                                                       {
00062   // Get the "nal_unit_type", to see if this NAL unit is one that we want to save a copy of:
00063   u_int8_t nal_unit_type = frameSize == 0 ? 0xFF : fTo[0]&0x1F;
00064 
00065   // Check for a (likely) common error: NAL units that (erroneously) begin with a 0x00000001 or 0x000001 'start code'
00066   //     (Those start codes should only be in byte-stream data; *not* data that consists of discrete NAL units.)
00067   //     Once again, to be clear: The NAL units that you feed to a "H264VideoStreamDiscreteFramer" MUST NOT include start codes.
00068   if (nal_unit_type == 0) {
00069     if (frameSize >= 4 && fTo[0] == 0 && fTo[1] == 0 && ((fTo[2] == 0 && fTo[3] == 1) || fTo[2] == 1)) {
00070       envir() << "H264VideoStreamDiscreteFramer error: MPEG 'start code' seen in the input\n";
00071     } else {
00072       envir() << "Warning: Invalid 'nal_unit_type': 0\n";
00073     }
00074   } else if (nal_unit_type == 7) { // Sequence parameter set (SPS)
00075     saveCopyOfSPS(fTo, frameSize);
00076   } else if (nal_unit_type == 8) { // Picture parameter set (PPS)
00077     saveCopyOfPPS(fTo, frameSize);
00078   }
00079 
00080   // Next, check whether this NAL unit ends the current 'access unit' (basically, a video frame).  Unfortunately, we can't do this
00081   // reliably, because we don't yet know anything about the *next* NAL unit that we'll see.  So, we guess this as best as we can,
00082   // by assuming that if this NAL unit is a VCL NAL unit, then it ends the current 'access unit'.
00083   Boolean const isVCL = nal_unit_type <= 5 && nal_unit_type > 0; // Would need to include type 20 for SVC and MVC #####
00084   if (isVCL) fPictureEndMarker = True;
00085 
00086   // Finally, complete delivery to the client:
00087   fFrameSize = frameSize;
00088   fNumTruncatedBytes = numTruncatedBytes;
00089   fPresentationTime = presentationTime;
00090   fDurationInMicroseconds = durationInMicroseconds;
00091   afterGetting(this);
00092 }

H264VideoStreamFramer * H264VideoStreamFramer::createNew	(	UsageEnvironment &	env,
		FramedSource *	inputSource,
		Boolean	includeStartCodeInOutput = `False`
	)			`[static, inherited]`

Definition at line 70 of file H264VideoStreamFramer.cpp.

References env, and True.

Referenced by H264VideoFileServerMediaSubsession::createNewStreamSource(), and main().

00070                                                                                               {
00071   return new H264VideoStreamFramer(env, inputSource, True, includeStartCodeInOutput);
00072 }

void H264VideoStreamFramer::getSPSandPPS	(	u_int8_t *&	sps,
		unsigned &	spsSize,
		u_int8_t *&	pps,
		unsigned &	ppsSize
	)			const `[inline, inherited]`

Definition at line 33 of file H264VideoStreamFramer.hh.

References H264VideoStreamFramer::fLastSeenPPS, H264VideoStreamFramer::fLastSeenPPSSize, H264VideoStreamFramer::fLastSeenSPS, and H264VideoStreamFramer::fLastSeenSPSSize.

Referenced by H264VideoRTPSink::auxSDPLine().

00033                                                                                                {
00034     // Returns pointers to copies of the most recently seen SPS (sequence parameter set) and PPS (picture parameter set) NAL unit.
00035     // (NULL pointers are returned if the NAL units have not yet been seen.)
00036     sps = fLastSeenSPS; spsSize = fLastSeenSPSSize;
00037     pps = fLastSeenPPS; ppsSize = fLastSeenPPSSize;
00038   }

void H264VideoStreamFramer::setSPSandPPS	(	u_int8_t *	sps,
		unsigned	spsSize,
		u_int8_t *	pps,
		unsigned	ppsSize
	)			`[inline, inherited]`

Definition at line 40 of file H264VideoStreamFramer.hh.

References H264VideoStreamFramer::saveCopyOfPPS(), and H264VideoStreamFramer::saveCopyOfSPS().

Referenced by H264VideoMatroskaFileServerMediaSubsession::createNewStreamSource().

00040                                                                                       {
00041     // Assigns copies of the SPS and PPS NAL units.  If this function is not called, then these NAL units are assigned
00042     // only if/when they appear in the input stream.  
00043     saveCopyOfSPS(sps, spsSize);
00044     saveCopyOfPPS(pps, ppsSize);
00045   }

void H264VideoStreamFramer::setSPSandPPS ( char const * sPropParameterSetsStr ) [inherited]

Definition at line 90 of file H264VideoStreamFramer.cpp.

References parseSPropParameterSets(), H264VideoStreamFramer::saveCopyOfPPS(), H264VideoStreamFramer::saveCopyOfSPS(), and SPropRecord::sPropBytes.

00090                                                                           {
00091   unsigned numSPropRecords;
00092   SPropRecord* sPropRecords = parseSPropParameterSets(sPropParameterSetsStr, numSPropRecords);
00093   for (unsigned i = 0; i < numSPropRecords; ++i) {
00094     if (sPropRecords[i].sPropLength == 0) continue; // bad data
00095     u_int8_t nal_unit_type = (sPropRecords[i].sPropBytes[0])&0x1F;
00096     if (nal_unit_type == 7/*SPS*/) {
00097       saveCopyOfSPS(sPropRecords[i].sPropBytes, sPropRecords[i].sPropLength);
00098     } else if (nal_unit_type == 8/*PPS*/) {
00099       saveCopyOfPPS(sPropRecords[i].sPropBytes, sPropRecords[i].sPropLength);
00100     }
00101   }
00102   delete[] sPropRecords;
00103 }

void H264VideoStreamFramer::saveCopyOfSPS	(	u_int8_t *	from,
		unsigned	size
	)			`[protected, inherited]`

Definition at line 105 of file H264VideoStreamFramer.cpp.

References H264VideoStreamFramer::fLastSeenSPS, and H264VideoStreamFramer::fLastSeenSPSSize.

Referenced by afterGettingFrame1(), H264VideoStreamParser::parse(), and H264VideoStreamFramer::setSPSandPPS().

00105                                                                        {
00106   delete[] fLastSeenSPS;
00107   fLastSeenSPS = new u_int8_t[size];
00108   memmove(fLastSeenSPS, from, size);
00109 
00110   fLastSeenSPSSize = size;
00111 }

void H264VideoStreamFramer::saveCopyOfPPS	(	u_int8_t *	from,
		unsigned	size
	)			`[protected, inherited]`

Definition at line 113 of file H264VideoStreamFramer.cpp.

References H264VideoStreamFramer::fLastSeenPPS, and H264VideoStreamFramer::fLastSeenPPSSize.

Referenced by afterGettingFrame1(), H264VideoStreamParser::parse(), and H264VideoStreamFramer::setSPSandPPS().

00113                                                                        {
00114   delete[] fLastSeenPPS;
00115   fLastSeenPPS = new u_int8_t[size];
00116   memmove(fLastSeenPPS, from, size);
00117 
00118   fLastSeenPPSSize = size;
00119 }

Boolean H264VideoStreamFramer::isH264VideoStreamFramer ( ) const [protected, virtual, inherited]

Reimplemented from MediaSource.

Definition at line 121 of file H264VideoStreamFramer.cpp.

References True.

00121                                                              {
00122   return True;
00123 }

Boolean& MPEGVideoStreamFramer::pictureEndMarker ( ) [inline, inherited]

Definition at line 40 of file MPEGVideoStreamFramer.hh.

References MPEGVideoStreamFramer::fPictureEndMarker.

Referenced by MPEG4ESVideoRTPSink::doSpecialFrameHandling(), MPEG1or2VideoRTPSink::doSpecialFrameHandling(), and H264VideoRTPSink::doSpecialFrameHandling().

00040 { return fPictureEndMarker; }

void MPEGVideoStreamFramer::flushInput ( ) [inherited]

Definition at line 53 of file MPEGVideoStreamFramer.cpp.

References StreamParser::flushInput(), MPEGVideoStreamFramer::fParser, NULL, and MPEGVideoStreamFramer::reset().

Referenced by MPEG1or2DemuxedServerMediaSubsession::seekStreamSource().

00053                                        {
00054   reset();
00055   if (fParser != NULL) fParser->flushInput();
00056 }

void MPEGVideoStreamFramer::computePresentationTime ( unsigned numAdditionalPictures ) [protected, inherited]

Definition at line 74 of file MPEGVideoStreamFramer.cpp.

References TimeCode::days, MPEGVideoStreamFramer::fCurGOPTimeCode, MPEGVideoStreamFramer::fFrameRate, MPEGVideoStreamFramer::fPicturesAdjustment, MPEGVideoStreamFramer::fPictureTimeBase, FramedSource::fPresentationTime, MPEGVideoStreamFramer::fPresentationTimeBase, MPEGVideoStreamFramer::fTcSecsBase, TimeCode::hours, TimeCode::minutes, TimeCode::pictures, and TimeCode::seconds.

Referenced by MPEG1or2VideoStreamParser::parseGOPHeader(), MPEG4VideoStreamParser::parseGroupOfVideoObjectPlane(), MPEG1or2VideoStreamParser::parsePictureHeader(), MPEG1or2VideoStreamParser::parseSlice(), MPEG4VideoStreamParser::parseVideoObjectLayer(), MPEG4VideoStreamParser::parseVideoObjectPlane(), MPEG1or2VideoStreamParser::parseVideoSequenceHeader(), MPEG4VideoStreamParser::parseVisualObject(), and MPEG4VideoStreamParser::parseVisualObjectSequence().

00074                                                         {
00075   // Computes "fPresentationTime" from the most recent GOP's
00076   // time_code, along with the "numAdditionalPictures" parameter:
00077   TimeCode& tc = fCurGOPTimeCode;
00078 
00079   unsigned tcSecs
00080     = (((tc.days*24)+tc.hours)*60+tc.minutes)*60+tc.seconds - fTcSecsBase;
00081   double pictureTime = fFrameRate == 0.0 ? 0.0
00082     : (tc.pictures + fPicturesAdjustment + numAdditionalPictures)/fFrameRate;
00083   while (pictureTime < fPictureTimeBase) { // "if" should be enough, but just in case
00084     if (tcSecs > 0) tcSecs -= 1;
00085     pictureTime += 1.0;
00086   }
00087   pictureTime -= fPictureTimeBase;
00088   if (pictureTime < 0.0) pictureTime = 0.0; // sanity check
00089   unsigned pictureSeconds = (unsigned)pictureTime;
00090   double pictureFractionOfSecond = pictureTime - (double)pictureSeconds;
00091 
00092   fPresentationTime = fPresentationTimeBase;
00093   fPresentationTime.tv_sec += tcSecs + pictureSeconds;
00094   fPresentationTime.tv_usec += (long)(pictureFractionOfSecond*1000000.0);
00095   if (fPresentationTime.tv_usec >= 1000000) {
00096     fPresentationTime.tv_usec -= 1000000;
00097     ++fPresentationTime.tv_sec;
00098   }
00099 #ifdef DEBUG
00100   if (firstPT.tv_sec == 0 && firstPT.tv_usec == 0) firstPT = fPresentationTime;
00101   struct timeval diffPT;
00102   diffPT.tv_sec = fPresentationTime.tv_sec - firstPT.tv_sec;
00103   diffPT.tv_usec = fPresentationTime.tv_usec - firstPT.tv_usec;
00104   if (fPresentationTime.tv_usec < firstPT.tv_usec) {
00105     --diffPT.tv_sec;
00106     diffPT.tv_usec += 1000000;
00107   }
00108   fprintf(stderr, "MPEGVideoStreamFramer::computePresentationTime(%d) -> %lu.%06ld [%lu.%06ld]\n", numAdditionalPictures, fPresentationTime.tv_sec, fPresentationTime.tv_usec, diffPT.tv_sec, diffPT.tv_usec);
00109 #endif
00110 }

void MPEGVideoStreamFramer::setTimeCode	(	unsigned	hours,
		unsigned	minutes,
		unsigned	seconds,
		unsigned	pictures,
		unsigned	picturesSinceLastGOP
	)			`[protected, inherited]`

Definition at line 113 of file MPEGVideoStreamFramer.cpp.

References TimeCode::days, MPEGVideoStreamFramer::fCurGOPTimeCode, MPEGVideoStreamFramer::fFrameRate, MPEGVideoStreamFramer::fHaveSeenFirstTimeCode, MPEGVideoStreamFramer::fPicturesAdjustment, MPEGVideoStreamFramer::fPictureTimeBase, MPEGVideoStreamFramer::fPrevGOPTimeCode, MPEGVideoStreamFramer::fTcSecsBase, TimeCode::hours, TimeCode::minutes, TimeCode::pictures, TimeCode::seconds, and True.

Referenced by MPEG1or2VideoStreamParser::parseGOPHeader(), and MPEG4VideoStreamParser::parseGroupOfVideoObjectPlane().

00114                                                                 {
00115   TimeCode& tc = fCurGOPTimeCode; // abbrev
00116   unsigned days = tc.days;
00117   if (hours < tc.hours) {
00118     // Assume that the 'day' has wrapped around:
00119     ++days;
00120   }
00121   tc.days = days;
00122   tc.hours = hours;
00123   tc.minutes = minutes;
00124   tc.seconds = seconds;
00125   tc.pictures = pictures;
00126   if (!fHaveSeenFirstTimeCode) {
00127     fPictureTimeBase = fFrameRate == 0.0 ? 0.0 : tc.pictures/fFrameRate;
00128     fTcSecsBase = (((tc.days*24)+tc.hours)*60+tc.minutes)*60+tc.seconds;
00129     fHaveSeenFirstTimeCode = True;
00130   } else if (fCurGOPTimeCode == fPrevGOPTimeCode) {
00131     // The time code has not changed since last time.  Adjust for this:
00132     fPicturesAdjustment += picturesSinceLastGOP;
00133   } else {
00134     // Normal case: The time code changed since last time.
00135     fPrevGOPTimeCode = tc;
00136     fPicturesAdjustment = 0;
00137   }
00138 }

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

Definition at line 30 of file FramedFilter.hh.

References FramedFilter::fInputSource.

Referenced by AC3AudioStreamFramer::AC3AudioStreamFramer(), MediaSubsession::addFilter(), H264VideoRTPSink::auxSDPLine(), EndianSwap24::createNew(), 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(), createNew(), H263plusVideoStreamFramer::createNew(), DVVideoStreamFramer::createNew(), AC3AudioStreamFramer::createNew(), H264VideoRTPSink::doSpecialFrameHandling(), H264VideoFileServerMediaSubsession::getAuxSDPLine(), MP3AudioFileServerMediaSubsession::getBaseStreams(), MP3ADUinterleaverBase::getInputSource(), H263plusVideoStreamFramer::H263plusVideoStreamFramer(), MPEG1or2VideoStreamFramer::MPEG1or2VideoStreamFramer(), MPEG4VideoStreamFramer::MPEG4VideoStreamFramer(), H264VideoMatroskaFileServerMediaSubsession::seekStreamSource(), DVVideoFileServerMediaSubsession::seekStreamSource(), and ClientTrickPlayState::setSource().

00030 { return fInputSource; }

void FramedFilter::reassignInputSource ( FramedSource * newInputSource ) [inline, inherited]

Definition at line 32 of file FramedFilter.hh.

References FramedFilter::fInputSource.

Referenced by T140TextRTPSink::continuePlaying(), H264VideoRTPSink::continuePlaying(), and FramedFilter::detachInputSource().

00032 { fInputSource = newInputSource; }

void FramedFilter::detachInputSource ( ) [inline, inherited]

Definition at line 35 of file FramedFilter.hh.

References NULL, and FramedFilter::reassignInputSource().

Referenced by H264FUAFragmenter::~H264FUAFragmenter(), and T140IdleFilter::~T140IdleFilter().

00035 { reassignInputSource(NULL); }

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, MPEG2TransportStreamTrickModeFilter, T140IdleFilter, and QCELPDeinterleaver.

Definition at line 49 of file FramedFilter.cpp.

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

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

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

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 65 of file MediaSource.cpp.

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

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

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

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

Definition at line 41 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().

00042                                                          {
00043   resultMedium = MediaLookupTable::ourMedia(env)->lookup(mediumName);
00044   if (resultMedium == NULL) {
00045     env.setResultMsg("Medium ", mediumName, " does not exist");
00046     return False;
00047   }
00048 
00049   return True;
00050 }

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, UsageEnvironment::internalError(), 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     envir().internalError();
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 FileSink::afterGettingFrame(), StreamReplicator::deactivateStreamReplica(), QCELPDeinterleaver::doStopGettingFrames(), 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 T140IdleFilter::afterGettingFrame(), afterPlaying(), InputESSourceRecord::askForNewData(), MPEG2TransportStreamFromESSource::awaitNewBuffer(), MatroskaFileParser::continueParsing(), QuickTimeFileSink::continuePlaying(), AVIFileSink::continuePlaying(), StreamReplicator::deactivateStreamReplica(), DeviceSource::deliverFrame(), MatroskaFileParser::deliverFrameWithinBlock(), T140IdleFilter::doGetNextFrame(), QCELPDeinterleaver::doGetNextFrame(), AMRDeinterleaver::doGetNextFrame(), WAVAudioFileSource::fileReadableHandler(), ByteStreamFileSource::fileReadableHandler(), StreamReplicator::getNextFrame(), BasicUDPSource::incomingPacketHandler1(), and TCPStreamSink::processBuffer().

00060 {return fIsCurrentlyAwaitingData;}

void FramedSource::afterGetting ( FramedSource * source ) [static, 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::isDVVideoStreamFramer ( ) const [virtual, inherited]

Reimplemented in DVVideoStreamFramer.

Definition at line 55 of file MediaSource.cpp.

References False.

Referenced by DVVideoRTPSink::sourceIsCompatibleWithUs().

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

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

Reimplemented in JPEGVideoSource.

Definition at line 58 of file MediaSource.cpp.

References False.

Referenced by JPEGVideoRTPSink::sourceIsCompatibleWithUs().

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

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

Reimplemented in AMRAudioSource.

Definition at line 61 of file MediaSource.cpp.

References False.

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

00061                                             {
00062   return False; // default implementation
00063 }

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

Definition at line 52 of file Media.cpp.

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

00052                                                           {
00053   MediaLookupTable::ourMedia(env)->remove(name);
00054 }

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

Definition at line 56 of file Media.cpp.

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

00056                                  {
00057   if (medium == NULL) return;
00058 
00059   close(medium->envir(), medium->name());
00060 }

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

Definition at line 59 of file Media.hh.

References Medium::fEnviron.

00059 {return fEnviron;}

char const* Medium::name ( ) const [inline, inherited]

Definition at line 61 of file Media.hh.

References Medium::fMediumName.

Referenced by QuickTimeFileSink::addAtom_hdlr2(), Medium::close(), MP3ADUTranscoder::createNew(), MP3FromADUSource::createNew(), ADUFromMP3Source::createNew(), and MP3FileSource::initializeStream().

00061 {return fMediumName;}

Boolean Medium::isSink ( ) const [virtual, inherited]

Reimplemented in MediaSink.

Definition at line 66 of file Media.cpp.

References False.

Referenced by MediaSink::lookupByName().

00066                              {
00067   return False; // default implementation
00068 }

Boolean Medium::isRTCPInstance ( ) const [virtual, inherited]

Reimplemented in RTCPInstance.

Definition at line 70 of file Media.cpp.

References False.

Referenced by RTCPInstance::lookupByName().

00070                                      {
00071   return False; // default implementation
00072 }

Boolean Medium::isRTSPClient ( ) const [virtual, inherited]

Reimplemented in RTSPClient.

Definition at line 74 of file Media.cpp.

References False.

Referenced by RTSPClient::lookupByName().

00074                                    {
00075   return False; // default implementation
00076 }

Boolean Medium::isRTSPServer ( ) const [virtual, inherited]

Reimplemented in RTSPServer.

Definition at line 78 of file Media.cpp.

References False.

Referenced by RTSPServer::lookupByName().

00078                                    {
00079   return False; // default implementation
00080 }

Boolean Medium::isMediaSession ( ) const [virtual, inherited]

Reimplemented in MediaSession.

Definition at line 82 of file Media.cpp.

References False.

Referenced by MediaSession::lookupByName().

00082                                      {
00083   return False; // default implementation
00084 }

Boolean Medium::isServerMediaSession ( ) const [virtual, inherited]

Reimplemented in ServerMediaSession.

Definition at line 86 of file Media.cpp.

References False.

Referenced by ServerMediaSession::lookupByName().

00086                                            {
00087   return False; // default implementation
00088 }

Boolean Medium::isDarwinInjector ( ) const [virtual, inherited]

Reimplemented in DarwinInjector.

Definition at line 90 of file Media.cpp.

References False.

Referenced by DarwinInjector::lookupByName().

00090                                        {
00091   return False; // default implementation
00092 }

TaskToken& Medium::nextTask ( ) [inline, protected, inherited]

Definition at line 78 of file Media.hh.

References Medium::fNextTask.

Referenced by BasicUDPSink::afterGettingFrame1(), MPEG4VideoFileServerMediaSubsession::afterPlayingDummy1(), H264VideoFileServerMediaSubsession::afterPlayingDummy1(), MPEG4VideoFileServerMediaSubsession::checkForAuxSDPLine1(), H264VideoFileServerMediaSubsession::checkForAuxSDPLine1(), MP3FileSource::doGetNextFrame(), AMRAudioFileSource::doGetNextFrame(), ADTSAudioFileSource::doGetNextFrame(), MultiFramedRTPSource::doGetNextFrame1(), WAVAudioFileSource::doReadFromFile(), ByteStreamFileSource::doReadFromFile(), MultiFramedRTPSource::doStopGettingFrames(), FramedSource::doStopGettingFrames(), ByteStreamFileSource::doStopGettingFrames(), RTCPInstance::reschedule(), RTCPInstance::schedule(), MultiFramedRTPSink::sendPacketIfNecessary(), and MediaSink::stopPlaying().

00078                         {
00079         return fNextTask;
00080   }

friend class MPEGVideoStreamParser [friend, inherited]

Definition at line 74 of file MPEGVideoStreamFramer.hh.

friend class MediaLookupTable [friend, inherited]

Definition at line 74 of file Media.hh.

double MPEGVideoStreamFramer::fFrameRate [protected, inherited]

Definition at line 67 of file MPEGVideoStreamFramer.hh.

Referenced by MPEG1or2VideoStreamDiscreteFramer::afterGettingFrame1(), MPEG4VideoStreamParser::analyzeVOLHeader(), MPEGVideoStreamFramer::computePresentationTime(), MPEGVideoStreamFramer::continueReadProcessing(), H264VideoStreamParser::parse(), MPEG1or2VideoStreamParser::parseVideoSequenceHeader(), and MPEGVideoStreamFramer::setTimeCode().

unsigned MPEGVideoStreamFramer::fPictureCount [protected, inherited]

Definition at line 68 of file MPEGVideoStreamFramer.hh.

Referenced by MPEGVideoStreamFramer::continueReadProcessing(), H264VideoStreamParser::parse(), MPEG1or2VideoStreamParser::parseSlice(), MPEG4VideoStreamParser::parseVideoObjectPlane(), and MPEGVideoStreamFramer::reset().

Boolean MPEGVideoStreamFramer::fPictureEndMarker [protected, inherited]

Definition at line 69 of file MPEGVideoStreamFramer.hh.

Referenced by MPEG4VideoStreamDiscreteFramer::afterGettingFrame1(), MPEG1or2VideoStreamDiscreteFramer::afterGettingFrame1(), afterGettingFrame1(), H264VideoStreamParser::parse(), MPEG1or2VideoStreamParser::parseSlice(), MPEG4VideoStreamParser::parseVideoObjectPlane(), MPEG4VideoStreamParser::parseVisualObjectSequenceEndCode(), MPEGVideoStreamFramer::pictureEndMarker(), and MPEGVideoStreamFramer::reset().

struct timeval MPEGVideoStreamFramer::fPresentationTimeBase [read, protected, inherited]

Definition at line 70 of file MPEGVideoStreamFramer.hh.

Referenced by MPEGVideoStreamFramer::computePresentationTime(), and MPEGVideoStreamFramer::reset().

class MPEGVideoStreamParser* MPEGVideoStreamFramer::fParser [protected, inherited]

Definition at line 73 of file MPEGVideoStreamFramer.hh.

Referenced by MPEGVideoStreamFramer::continueReadProcessing(), MPEGVideoStreamFramer::doGetNextFrame(), MPEGVideoStreamFramer::flushInput(), MPEG1or2VideoStreamFramer::MPEG1or2VideoStreamFramer(), MPEG4VideoStreamFramer::MPEG4VideoStreamFramer(), and MPEGVideoStreamFramer::~MPEGVideoStreamFramer().

FramedSource* FramedFilter::fInputSource [protected, inherited]

Definition at line 49 of file FramedFilter.hh.

unsigned char* FramedSource::fTo [protected, inherited]

Definition at line 74 of file FramedSource.hh.

unsigned FramedSource::fMaxSize [protected, inherited]

Definition at line 75 of file FramedSource.hh.

unsigned FramedSource::fFrameSize [protected, inherited]

Definition at line 76 of file FramedSource.hh.

unsigned FramedSource::fNumTruncatedBytes [protected, inherited]

Definition at line 77 of file FramedSource.hh.

struct timeval FramedSource::fPresentationTime [read, protected, inherited]

Definition at line 78 of file FramedSource.hh.

unsigned FramedSource::fDurationInMicroseconds [protected, inherited]

Definition at line 79 of file FramedSource.hh.


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	getSPSandPPS (u_int8_t &sps, unsigned &spsSize, u_int8_t &pps, unsigned &ppsSize) const
void	setSPSandPPS (u_int8_t sps, unsigned spsSize, u_int8_t pps, unsigned ppsSize)
void	setSPSandPPS (char const *sPropParameterSetsStr)
Boolean &	pictureEndMarker ()
void	flushInput ()
FramedSource *	inputSource () const
void	reassignInputSource (FramedSource *newInputSource)
void	detachInputSource ()
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	isDVVideoStreamFramer () 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 H264VideoStreamDiscreteFramer *	createNew (UsageEnvironment &env, FramedSource *inputSource)
static H264VideoStreamFramer *	createNew (UsageEnvironment &env, FramedSource *inputSource, Boolean includeStartCodeInOutput=False)
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	afterGetting (FramedSource *source)
static void	close (UsageEnvironment &env, char const *mediumName)
static void	close (Medium *medium)
Protected Member Functions
	H264VideoStreamDiscreteFramer (UsageEnvironment &env, FramedSource *inputSource)
virtual	~H264VideoStreamDiscreteFramer ()
virtual void	doGetNextFrame ()
void	afterGettingFrame1 (unsigned frameSize, unsigned numTruncatedBytes, struct timeval presentationTime, unsigned durationInMicroseconds)
void	saveCopyOfSPS (u_int8_t *from, unsigned size)
void	saveCopyOfPPS (u_int8_t *from, unsigned size)
virtual Boolean	isH264VideoStreamFramer () const
void	computePresentationTime (unsigned numAdditionalPictures)
void	setTimeCode (unsigned hours, unsigned minutes, unsigned seconds, unsigned pictures, unsigned picturesSinceLastGOP)
virtual char const *	MIMEtype () const
virtual void	getAttributes () const
virtual void	doStopGettingFrames ()
TaskToken &	nextTask ()
Static Protected Member Functions
static void	afterGettingFrame (void *clientData, unsigned frameSize, unsigned numTruncatedBytes, struct timeval presentationTime, unsigned durationInMicroseconds)
Protected Attributes
double	fFrameRate
unsigned	fPictureCount
Boolean	fPictureEndMarker
timeval	fPresentationTimeBase
MPEGVideoStreamParser *	fParser
FramedSource *	fInputSource
unsigned char *	fTo
unsigned	fMaxSize
unsigned	fFrameSize
unsigned	fNumTruncatedBytes
timeval	fPresentationTime
unsigned	fDurationInMicroseconds
Friends
class	MPEGVideoStreamParser
class	MediaLookupTable

H264VideoStreamDiscreteFramer Class Reference

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Field Documentation