DeinterleavingFrames Class Reference

Collaboration diagram for DeinterleavingFrames:

[legend]

Public Member Functions
	DeinterleavingFrames ()
virtual	~DeinterleavingFrames ()
Boolean	haveReleaseableFrame ()
void	getIncomingFrameParams (unsigned char *&dataPtr, unsigned &bytesAvailable)
void	getIncomingFrameParamsAfter (unsigned frameSize, struct timeval presentationTime, unsigned durationInMicroseconds, unsigned char &icc, unsigned char &ii)
void	getReleasingFrameParams (unsigned char *&dataPtr, unsigned &bytesInUse, struct timeval &presentationTime, unsigned &durationInMicroseconds)
void	moveIncomingFrameIntoPlace ()
void	releaseNext ()
void	startNewCycle ()
Private Attributes
unsigned	fNextIndexToRelease
Boolean	fHaveEndedCycle
unsigned	fIIlastSeen
unsigned	fMinIndexSeen
unsigned	fMaxIndexSeen
DeinterleavingFrameDescriptor *	fDescriptors

---

Detailed Description

Definition at line 187 of file MP3ADUinterleaving.cpp.

---

Constructor & Destructor Documentation

DeinterleavingFrames::DeinterleavingFrames

(

)

Definition at line 404 of file MP3ADUinterleaving.cpp.

  : fNextIndexToRelease(0), fHaveEndedCycle(False),
    fMinIndexSeen(MAX_CYCLE_SIZE), fMaxIndexSeen(0),
    fDescriptors(new DeinterleavingFrameDescriptor[MAX_CYCLE_SIZE+1]) {
}

DeinterleavingFrames::~DeinterleavingFrames

(

)

[virtual]

Definition at line 409 of file MP3ADUinterleaving.cpp.

References fDescriptors.

                                            {
  delete[] fDescriptors;
}

---

Member Function Documentation

Boolean DeinterleavingFrames::haveReleaseableFrame

(

)

Definition at line 413 of file MP3ADUinterleaving.cpp.

References False, fDescriptors, fHaveEndedCycle, fMaxIndexSeen, fMinIndexSeen, fNextIndexToRelease, DeinterleavingFrameDescriptor::frameDataSize, MAX_CYCLE_SIZE, moveIncomingFrameIntoPlace(), and True.

Referenced by MP3ADUdeinterleaver::doGetNextFrame().

                                                   {
  if (!fHaveEndedCycle) {
    // Check just the next frame in the sequence
    return fDescriptors[fNextIndexToRelease].frameDataSize > 0;
  } else {
    // We've just ended a cycle, so we can skip over frames that didn't
    // get filled in (due to packet loss):
    if (fNextIndexToRelease < fMinIndexSeen) {
      fNextIndexToRelease = fMinIndexSeen;
    }
    while (fNextIndexToRelease < fMaxIndexSeen
           && fDescriptors[fNextIndexToRelease].frameDataSize == 0) {
      ++fNextIndexToRelease;
    }
    if (fNextIndexToRelease >= fMaxIndexSeen) {
      // No more frames are available from the cycle that we just ended, so
      // clear out all previously stored frames, then make available
      // the last-read frame, and return false for now:
      for (unsigned i = fMinIndexSeen; i < fMaxIndexSeen; ++i) {
        fDescriptors[i].frameDataSize = 0;
      }

      fMinIndexSeen = MAX_CYCLE_SIZE; fMaxIndexSeen = 0;
      moveIncomingFrameIntoPlace();

      fHaveEndedCycle = False;
      fNextIndexToRelease = 0;
      return False;
    }

    return True;
  }
}

void DeinterleavingFrames::getIncomingFrameParams	(	unsigned char *&	dataPtr,
		unsigned &	bytesAvailable
	)

Definition at line 447 of file MP3ADUinterleaving.cpp.

References fDescriptors, DeinterleavingFrameDescriptor::frameData, MAX_CYCLE_SIZE, MAX_FRAME_SIZE, and NULL.

Referenced by MP3ADUdeinterleaver::doGetNextFrame().

                                                                            {
  // Use fDescriptors[MAX_CYCLE_SIZE] to store the incoming frame,
  // prior to figuring out its real position:
  DeinterleavingFrameDescriptor& desc = fDescriptors[MAX_CYCLE_SIZE];
  if (desc.frameData == NULL) {
    // There's no buffer yet, so allocate a new one:
    desc.frameData = new unsigned char[MAX_FRAME_SIZE];
  }
  dataPtr = desc.frameData;
  bytesAvailable = MAX_FRAME_SIZE;
}

void DeinterleavingFrames::getIncomingFrameParamsAfter	(	unsigned	frameSize,
		struct timeval	presentationTime,
		unsigned	durationInMicroseconds,
		unsigned char &	icc,
		unsigned char &	ii
	)

Definition at line 461 of file MP3ADUinterleaving.cpp.

References DeinterleavingFrameDescriptor::durationInMicroseconds, fDescriptors, fIIlastSeen, DeinterleavingFrameDescriptor::frameData, DeinterleavingFrameDescriptor::frameDataSize, ADUdescriptor::getRemainingFrameSize(), MAX_CYCLE_SIZE, and DeinterleavingFrameDescriptor::presentationTime.

Referenced by MP3ADUdeinterleaver::afterGettingFrame().

                                                                     {
  DeinterleavingFrameDescriptor& desc = fDescriptors[MAX_CYCLE_SIZE];
  desc.frameDataSize = frameSize;
  desc.presentationTime = presentationTime;
  desc.durationInMicroseconds = durationInMicroseconds;

  // Advance over the ADU descriptor, to get to the MPEG 'syncword':
  unsigned char* ptr = desc.frameData;
  (void)ADUdescriptor::getRemainingFrameSize(ptr);

  // Read the next 11 bits into (ii,icc), and replace them with all-1s:
  fIIlastSeen = ii = *ptr; *ptr++ = 0xFF;
  icc = (*ptr&0xE0)>>5; *ptr |= 0xE0;
}

void DeinterleavingFrames::getReleasingFrameParams	(	unsigned char *&	dataPtr,
		unsigned &	bytesInUse,
		struct timeval &	presentationTime,
		unsigned &	durationInMicroseconds
	)

Definition at line 479 of file MP3ADUinterleaving.cpp.

References DeinterleavingFrameDescriptor::durationInMicroseconds, fDescriptors, fNextIndexToRelease, DeinterleavingFrameDescriptor::frameData, DeinterleavingFrameDescriptor::frameDataSize, and DeinterleavingFrameDescriptor::presentationTime.

Referenced by MP3ADUdeinterleaver::releaseOutgoingFrame().

                                                                                     {
  DeinterleavingFrameDescriptor& desc = fDescriptors[fNextIndexToRelease];
  dataPtr = desc.frameData;
  bytesInUse = desc.frameDataSize;
  presentationTime = desc.presentationTime;
  durationInMicroseconds = desc.durationInMicroseconds;
}

void DeinterleavingFrames::moveIncomingFrameIntoPlace

(

)

Definition at line 490 of file MP3ADUinterleaving.cpp.

References fDescriptors, fIIlastSeen, fMaxIndexSeen, fMinIndexSeen, DeinterleavingFrameDescriptor::frameData, DeinterleavingFrameDescriptor::frameDataSize, MAX_CYCLE_SIZE, and DeinterleavingFrameDescriptor::presentationTime.

Referenced by MP3ADUdeinterleaver::afterGettingFrame(), and haveReleaseableFrame().

                                                      {
  DeinterleavingFrameDescriptor& fromDesc = fDescriptors[MAX_CYCLE_SIZE];
  DeinterleavingFrameDescriptor& toDesc = fDescriptors[fIIlastSeen];

  toDesc.frameDataSize = fromDesc.frameDataSize;
  toDesc.presentationTime = fromDesc.presentationTime;

  // Move the data pointer into place by swapping the data pointers:
  unsigned char* tmp = toDesc.frameData;
  toDesc.frameData = fromDesc.frameData;
  fromDesc.frameData = tmp;

  if (fIIlastSeen < fMinIndexSeen) {
    fMinIndexSeen = fIIlastSeen;
  }
  if (fIIlastSeen + 1 > fMaxIndexSeen) {
    fMaxIndexSeen = fIIlastSeen + 1;
  }
}

void DeinterleavingFrames::releaseNext

(

)

Definition at line 510 of file MP3ADUinterleaving.cpp.

References fDescriptors, fNextIndexToRelease, DeinterleavingFrameDescriptor::frameDataSize, and MAX_CYCLE_SIZE.

Referenced by MP3ADUdeinterleaver::releaseOutgoingFrame().

                                       {
  fDescriptors[fNextIndexToRelease].frameDataSize = 0;
  fNextIndexToRelease = (fNextIndexToRelease+1)%MAX_CYCLE_SIZE;
}

void DeinterleavingFrames::startNewCycle

(

)

Definition at line 515 of file MP3ADUinterleaving.cpp.

References fHaveEndedCycle, and True.

Referenced by MP3ADUdeinterleaver::afterGettingFrame().

                                         {
  fHaveEndedCycle = True;
}

---

Field Documentation

unsigned DeinterleavingFrames::fNextIndexToRelease [private]

Definition at line 208 of file MP3ADUinterleaving.cpp.

Referenced by getReleasingFrameParams(), haveReleaseableFrame(), and releaseNext().

Boolean DeinterleavingFrames::fHaveEndedCycle [private]

Definition at line 209 of file MP3ADUinterleaving.cpp.

Referenced by haveReleaseableFrame(), and startNewCycle().

unsigned DeinterleavingFrames::fIIlastSeen [private]

Definition at line 210 of file MP3ADUinterleaving.cpp.

Referenced by getIncomingFrameParamsAfter(), and moveIncomingFrameIntoPlace().

unsigned DeinterleavingFrames::fMinIndexSeen [private]

Definition at line 211 of file MP3ADUinterleaving.cpp.

Referenced by haveReleaseableFrame(), and moveIncomingFrameIntoPlace().

unsigned DeinterleavingFrames::fMaxIndexSeen [private]

Definition at line 211 of file MP3ADUinterleaving.cpp.

Referenced by haveReleaseableFrame(), and moveIncomingFrameIntoPlace().

class DeinterleavingFrameDescriptor* DeinterleavingFrames::fDescriptors [private]

Definition at line 212 of file MP3ADUinterleaving.cpp.

Referenced by getIncomingFrameParams(), getIncomingFrameParamsAfter(), getReleasingFrameParams(), haveReleaseableFrame(), moveIncomingFrameIntoPlace(), releaseNext(), and ~DeinterleavingFrames().

---

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

• liveMedia/MP3ADUinterleaving.cpp

---