MatroskaFileParser Class Reference

#include <MatroskaFileParser.hh>

Inheritance diagram for MatroskaFileParser:

Collaboration diagram for MatroskaFileParser:

Public Member Functions
	MatroskaFileParser (MatroskaFile &ourFile, FramedSource *inputSource, FramedSource::onCloseFunc *onEndFunc, void *onEndClientData, MatroskaDemux *ourDemux=NULL)
virtual	~MatroskaFileParser ()
void	seekToTime (double &seekNPT)
void	pause ()
void	stopAnyDeliveryForTrack (unsigned trackNumber)
void	continueParsing ()
virtual void	flushInput ()

Static Public Member Functions
static void	continueParsing (void *clientData, unsigned char *ptr, unsigned size, struct timeval presentationTime)

Protected Types
typedef void()	clientContinueFunc(void *clientData, unsigned char *ptr, unsigned size, struct timeval presentationTime)

Protected Member Functions
void	saveParserState ()
u_int32_t	get4Bytes ()
u_int32_t	test4Bytes ()
u_int16_t	get2Bytes ()
u_int16_t	test2Bytes ()
u_int8_t	get1Byte ()
u_int8_t	test1Byte ()
void	getBytes (u_int8_t *to, unsigned numBytes)
void	testBytes (u_int8_t *to, unsigned numBytes)
void	skipBytes (unsigned numBytes)
void	skipBits (unsigned numBits)
unsigned	getBits (unsigned numBits)
unsigned	curOffset () const
unsigned &	totNumValidBytes ()
Boolean	haveSeenEOF () const
unsigned	bankSize () const

Private Member Functions
Boolean	parse ()
Boolean	parseStartOfFile ()
void	lookForNextTrack ()
Boolean	parseTrack ()
Boolean	parseCues ()
void	lookForNextBlock ()
void	parseBlock ()
Boolean	deliverFrameWithinBlock ()
void	deliverFrameBytes ()
void	getCommonFrameBytes (MatroskaTrack *track, u_int8_t *to, unsigned numBytesToGet, unsigned numBytesToSkip)
Boolean	parseEBMLNumber (EBMLNumber &num)
Boolean	parseEBMLIdAndSize (EBMLId &id, EBMLDataSize &size)
Boolean	parseEBMLVal_unsigned64 (EBMLDataSize &size, u_int64_t &result)
Boolean	parseEBMLVal_unsigned (EBMLDataSize &size, unsigned &result)
Boolean	parseEBMLVal_float (EBMLDataSize &size, float &result)
Boolean	parseEBMLVal_string (EBMLDataSize &size, char *&result)
Boolean	parseEBMLVal_binary (EBMLDataSize &size, u_int8_t *&result)
void	skipHeader (EBMLDataSize const &size)
void	skipRemainingHeaderBytes (Boolean isContinuation)
void	setParseState ()
void	seekToFilePosition (u_int64_t offsetInFile)
void	seekToEndOfFile ()
void	resetStateAfterSeeking ()
void	resetPresentationTimes ()
virtual void	restoreSavedParserState ()
unsigned char *	curBank ()
unsigned char *	nextToParse ()
unsigned char *	lastParsed ()
void	ensureValidBytes (unsigned numBytesNeeded)
void	ensureValidBytes1 (unsigned numBytesNeeded)
void	afterGettingBytes1 (unsigned numBytesRead, struct timeval presentationTime)
void	onInputClosure1 ()

Static Private Member Functions
static void	afterGettingBytes (void *clientData, unsigned numBytesRead, unsigned numTruncatedBytes, struct timeval presentationTime, unsigned durationInMicroseconds)
static void	onInputClosure (void *clientData)

Private Attributes
MatroskaFile &	fOurFile
FramedSource *	fInputSource
FramedSource::onCloseFunc *	fOnEndFunc
void *	fOnEndClientData
MatroskaDemux *	fOurDemux
MatroskaParseState	fCurrentParseState
u_int64_t	fCurOffsetInFile
u_int64_t	fSavedCurOffsetInFile
u_int64_t	fLimitOffsetInFile
u_int64_t	fNumHeaderBytesToSkip
EBMLId	fLastSeekId
unsigned	fClusterTimecode
unsigned	fBlockSize
unsigned	fBlockTrackNumber
short	fBlockTimecode
unsigned	fNumFramesInBlock
unsigned *	fFrameSizesWithinBlock
double	fPresentationTimeOffset
unsigned	fNextFrameNumberToDeliver
unsigned	fCurOffsetWithinFrame
unsigned	fSavedCurOffsetWithinFrame
u_int8_t *	fCurFrameTo
unsigned	fCurFrameNumBytesToGet
unsigned	fCurFrameNumBytesToSkip
FramedSource::onCloseFunc *	fClientOnInputCloseFunc
void *	fClientOnInputCloseClientData
clientContinueFunc *	fClientContinueFunc
void *	fClientContinueClientData
unsigned char *	fBank [2]
unsigned char	fCurBankNum
unsigned char *	fCurBank
unsigned	fSavedParserIndex
unsigned char	fSavedRemainingUnparsedBits
unsigned	fCurParserIndex
unsigned char	fRemainingUnparsedBits
unsigned	fTotNumValidBytes
Boolean	fHaveSeenEOF
struct timeval	fLastSeenPresentationTime

Detailed Description

Definition at line 46 of file MatroskaFileParser.hh.

Member Typedef Documentation

clientContinueFunc

typedef void() StreamParser::clientContinueFunc(void *clientData, unsigned char *ptr, unsigned size, struct timeval presentationTime)

protectedinherited

Definition at line 33 of file StreamParser.hh.

Constructor & Destructor Documentation

MatroskaFileParser()

MatroskaFileParser::MatroskaFileParser	(	MatroskaFile &	ourFile,
		FramedSource *	inputSource,
		FramedSource::onCloseFunc *	onEndFunc,
		void *	onEndClientData,
		MatroskaDemux *	ourDemux = NULL
	)

~MatroskaFileParser()

virtual MatroskaFileParser::~MatroskaFileParser ( )

virtual

Member Function Documentation

afterGettingBytes()

static void StreamParser::afterGettingBytes ( void *  clientData, unsigned  numBytesRead, unsigned  numTruncatedBytes, struct timeval  presentationTime, unsigned  durationInMicroseconds  )

staticprivateinherited

afterGettingBytes1()

void StreamParser::afterGettingBytes1 ( unsigned  numBytesRead, struct timeval  presentationTime  )

privateinherited

bankSize()

unsigned StreamParser::bankSize ( ) const

protectedinherited

continueParsing() [1/2]

void MatroskaFileParser::continueParsing

(

)

continueParsing() [2/2]

static void MatroskaFileParser::continueParsing ( void *  clientData, unsigned char *  ptr, unsigned  size, struct timeval  presentationTime  )

static

curBank()

unsigned char * StreamParser::curBank ( )

inlineprivateinherited

Definition at line 116 of file StreamParser.hh.

{ return fCurBank; }

References StreamParser::fCurBank.

Referenced by StreamParser::get1Byte(), StreamParser::lastParsed(), and StreamParser::nextToParse().

curOffset()

unsigned StreamParser::curOffset ( ) const

inlineprotectedinherited

Definition at line 107 of file StreamParser.hh.

{ return fCurParserIndex; }

References StreamParser::fCurParserIndex.

deliverFrameBytes()

void MatroskaFileParser::deliverFrameBytes ( )

private

deliverFrameWithinBlock()

Boolean MatroskaFileParser::deliverFrameWithinBlock ( )

private

ensureValidBytes()

void StreamParser::ensureValidBytes ( unsigned  numBytesNeeded )

inlineprivateinherited

Definition at line 121 of file StreamParser.hh.

                                                 {
    // common case: inlined:
    if (fCurParserIndex + numBytesNeeded <= fTotNumValidBytes) return;
 
    ensureValidBytes1(numBytesNeeded);
  }

References StreamParser::ensureValidBytes1(), StreamParser::fCurParserIndex, and StreamParser::fTotNumValidBytes.

Referenced by StreamParser::get1Byte(), StreamParser::get2Bytes(), StreamParser::skipBytes(), StreamParser::test1Byte(), StreamParser::test2Bytes(), StreamParser::test4Bytes(), and StreamParser::testBytes().

ensureValidBytes1()

void StreamParser::ensureValidBytes1 ( unsigned  numBytesNeeded )

privateinherited

Referenced by StreamParser::ensureValidBytes().

flushInput()

virtual void StreamParser::flushInput ( )

virtualinherited

get1Byte()

u_int8_t StreamParser::get1Byte ( )

inlineprotectedinherited

Definition at line 79 of file StreamParser.hh.

                      { // byte-aligned
    ensureValidBytes(1);
    fRemainingUnparsedBits = 0;
    return curBank()[fCurParserIndex++];
  }

References StreamParser::curBank(), StreamParser::ensureValidBytes(), StreamParser::fCurParserIndex, and StreamParser::fRemainingUnparsedBits.

Referenced by MPEGVideoStreamParser::saveToNextCode(), and MPEGVideoStreamParser::skipToNextCode().

get2Bytes()

u_int16_t StreamParser::get2Bytes ( )

inlineprotectedinherited

Definition at line 60 of file StreamParser.hh.

                        {
    ensureValidBytes(2);
 
    unsigned char const* ptr = nextToParse();
    u_int16_t result = (ptr[0]<<8)|ptr[1];
 
    fCurParserIndex += 2;
    fRemainingUnparsedBits = 0;
 
    return result;
  }

References StreamParser::ensureValidBytes(), StreamParser::fCurParserIndex, StreamParser::fRemainingUnparsedBits, and StreamParser::nextToParse().

get4Bytes()

u_int32_t StreamParser::get4Bytes ( )

inlineprotectedinherited

Definition at line 46 of file StreamParser.hh.

                        { // byte-aligned; returned in big-endian order
    u_int32_t result = test4Bytes();
    fCurParserIndex += 4;
    fRemainingUnparsedBits = 0;
 
    return result;
  }

References StreamParser::fCurParserIndex, StreamParser::fRemainingUnparsedBits, and StreamParser::test4Bytes().

Referenced by MPEGVideoStreamParser::saveToNextCode(), and MPEGVideoStreamParser::skipToNextCode().

getBits()

unsigned StreamParser::getBits ( unsigned  numBits )

protectedinherited

getBytes()

void StreamParser::getBytes ( u_int8_t *  to, unsigned  numBytes  )

inlineprotectedinherited

Definition at line 89 of file StreamParser.hh.

                                                 {
    testBytes(to, numBytes);
    fCurParserIndex += numBytes;
    fRemainingUnparsedBits = 0;
  }

References StreamParser::fCurParserIndex, StreamParser::fRemainingUnparsedBits, and StreamParser::testBytes().

getCommonFrameBytes()

void MatroskaFileParser::getCommonFrameBytes ( MatroskaTrack *  track, u_int8_t *  to, unsigned  numBytesToGet, unsigned  numBytesToSkip  )

private

haveSeenEOF()

Boolean StreamParser::haveSeenEOF ( ) const

inlineprotectedinherited

Definition at line 111 of file StreamParser.hh.

{ return fHaveSeenEOF; }

References StreamParser::fHaveSeenEOF.

lastParsed()

unsigned char * StreamParser::lastParsed ( )

inlineprivateinherited

Definition at line 118 of file StreamParser.hh.

{ return &curBank()[fCurParserIndex-1]; }

References StreamParser::curBank(), and StreamParser::fCurParserIndex.

lookForNextBlock()

void MatroskaFileParser::lookForNextBlock ( )

private

lookForNextTrack()

void MatroskaFileParser::lookForNextTrack ( )

private

nextToParse()

unsigned char * StreamParser::nextToParse ( )

inlineprivateinherited

Definition at line 117 of file StreamParser.hh.

{ return &curBank()[fCurParserIndex]; }

References StreamParser::curBank(), and StreamParser::fCurParserIndex.

Referenced by StreamParser::get2Bytes(), StreamParser::test1Byte(), StreamParser::test2Bytes(), StreamParser::test4Bytes(), and StreamParser::testBytes().

onInputClosure()

static void StreamParser::onInputClosure ( void *  clientData )

staticprivateinherited

onInputClosure1()

void StreamParser::onInputClosure1 ( )

privateinherited

parse()

Boolean MatroskaFileParser::parse ( )

private

parseBlock()

void MatroskaFileParser::parseBlock ( )

private

parseCues()

Boolean MatroskaFileParser::parseCues ( )

private

parseEBMLIdAndSize()

Boolean MatroskaFileParser::parseEBMLIdAndSize ( EBMLId &  id, EBMLDataSize &  size  )

private

parseEBMLNumber()

Boolean MatroskaFileParser::parseEBMLNumber ( EBMLNumber &  num )

private

parseEBMLVal_binary()

Boolean MatroskaFileParser::parseEBMLVal_binary ( EBMLDataSize &  size, u_int8_t *&  result  )

private

parseEBMLVal_float()

Boolean MatroskaFileParser::parseEBMLVal_float ( EBMLDataSize &  size, float &  result  )

private

parseEBMLVal_string()

Boolean MatroskaFileParser::parseEBMLVal_string ( EBMLDataSize &  size, char *&  result  )

private

parseEBMLVal_unsigned()

Boolean MatroskaFileParser::parseEBMLVal_unsigned ( EBMLDataSize &  size, unsigned &  result  )

private

parseEBMLVal_unsigned64()

Boolean MatroskaFileParser::parseEBMLVal_unsigned64 ( EBMLDataSize &  size, u_int64_t &  result  )

private

parseStartOfFile()

Boolean MatroskaFileParser::parseStartOfFile ( )

private

parseTrack()

Boolean MatroskaFileParser::parseTrack ( )

private

pause()

void MatroskaFileParser::pause

(

)

resetPresentationTimes()

void MatroskaFileParser::resetPresentationTimes ( )

private

resetStateAfterSeeking()

void MatroskaFileParser::resetStateAfterSeeking ( )

private

restoreSavedParserState()

virtual void MatroskaFileParser::restoreSavedParserState ( )

privatevirtual

Reimplemented from StreamParser.

saveParserState()

void StreamParser::saveParserState ( )

protectedinherited

Referenced by MPEGVideoStreamParser::setParseState().

seekToEndOfFile()

void MatroskaFileParser::seekToEndOfFile ( )

private

seekToFilePosition()

void MatroskaFileParser::seekToFilePosition ( u_int64_t  offsetInFile )

private

seekToTime()

void MatroskaFileParser::seekToTime

(

double &

seekNPT

)

setParseState()

void MatroskaFileParser::setParseState ( )

private

skipBits()

void StreamParser::skipBits ( unsigned  numBits )

protectedinherited

skipBytes()

void StreamParser::skipBytes ( unsigned  numBytes )

inlineprotectedinherited

Definition at line 98 of file StreamParser.hh.

                                    {
    ensureValidBytes(numBytes);
    fCurParserIndex += numBytes;
  }

References StreamParser::ensureValidBytes(), and StreamParser::fCurParserIndex.

skipHeader()

void MatroskaFileParser::skipHeader ( EBMLDataSize const &  size )

private

skipRemainingHeaderBytes()

void MatroskaFileParser::skipRemainingHeaderBytes ( Boolean  isContinuation )

private

stopAnyDeliveryForTrack()

void MatroskaFileParser::stopAnyDeliveryForTrack

(

unsigned

trackNumber

)

test1Byte()

u_int8_t StreamParser::test1Byte ( )

inlineprotectedinherited

Definition at line 84 of file StreamParser.hh.

                       { // as above, but doesn't advance ptr
    ensureValidBytes(1);
    return nextToParse()[0];
  }

References StreamParser::ensureValidBytes(), and StreamParser::nextToParse().

test2Bytes()

u_int16_t StreamParser::test2Bytes ( )

inlineprotectedinherited

Definition at line 71 of file StreamParser.hh.

                         {
    ensureValidBytes(2);
 
    unsigned char const* ptr = nextToParse();
    return (ptr[0]<<8)|ptr[1];
  }

References StreamParser::ensureValidBytes(), and StreamParser::nextToParse().

test4Bytes()

u_int32_t StreamParser::test4Bytes ( )

inlineprotectedinherited

Definition at line 53 of file StreamParser.hh.

                         { // as above, but doesn't advance ptr
    ensureValidBytes(4);
 
    unsigned char const* ptr = nextToParse();
    return (ptr[0]<<24)|(ptr[1]<<16)|(ptr[2]<<8)|ptr[3];
  }

References StreamParser::ensureValidBytes(), and StreamParser::nextToParse().

Referenced by StreamParser::get4Bytes().

testBytes()

void StreamParser::testBytes ( u_int8_t *  to, unsigned  numBytes  )

inlineprotectedinherited

Definition at line 94 of file StreamParser.hh.

                                                  { // as above, but doesn't advance ptr
    ensureValidBytes(numBytes);
    memmove(to, nextToParse(), numBytes);
  }

References StreamParser::ensureValidBytes(), and StreamParser::nextToParse().

Referenced by StreamParser::getBytes().

totNumValidBytes()

unsigned & StreamParser::totNumValidBytes ( )

inlineprotectedinherited

Definition at line 109 of file StreamParser.hh.

{ return fTotNumValidBytes; }

References StreamParser::fTotNumValidBytes.

Field Documentation

fBank

unsigned char* StreamParser::fBank[2]

privateinherited

Definition at line 146 of file StreamParser.hh.

fBlockSize

unsigned MatroskaFileParser::fBlockSize

private

Definition at line 124 of file MatroskaFileParser.hh.

fBlockTimecode

short MatroskaFileParser::fBlockTimecode

private

Definition at line 126 of file MatroskaFileParser.hh.

fBlockTrackNumber

unsigned MatroskaFileParser::fBlockTrackNumber

private

Definition at line 125 of file MatroskaFileParser.hh.

fClientContinueClientData

void* StreamParser::fClientContinueClientData

privateinherited

Definition at line 143 of file StreamParser.hh.

fClientContinueFunc

clientContinueFunc* StreamParser::fClientContinueFunc

privateinherited

Definition at line 142 of file StreamParser.hh.

fClientOnInputCloseClientData

void* StreamParser::fClientOnInputCloseClientData

privateinherited

Definition at line 141 of file StreamParser.hh.

fClientOnInputCloseFunc

FramedSource::onCloseFunc* StreamParser::fClientOnInputCloseFunc

privateinherited

Definition at line 140 of file StreamParser.hh.

fClusterTimecode

unsigned MatroskaFileParser::fClusterTimecode

private

Definition at line 121 of file MatroskaFileParser.hh.

fCurBank

unsigned char* StreamParser::fCurBank

privateinherited

Definition at line 148 of file StreamParser.hh.

Referenced by StreamParser::curBank().

fCurBankNum

unsigned char StreamParser::fCurBankNum

privateinherited

Definition at line 147 of file StreamParser.hh.

fCurFrameNumBytesToGet

unsigned MatroskaFileParser::fCurFrameNumBytesToGet

private

Definition at line 137 of file MatroskaFileParser.hh.

fCurFrameNumBytesToSkip

unsigned MatroskaFileParser::fCurFrameNumBytesToSkip

private

Definition at line 138 of file MatroskaFileParser.hh.

fCurFrameTo

u_int8_t* MatroskaFileParser::fCurFrameTo

private

Definition at line 136 of file MatroskaFileParser.hh.

fCurOffsetInFile

u_int64_t MatroskaFileParser::fCurOffsetInFile

private

Definition at line 112 of file MatroskaFileParser.hh.

fCurOffsetWithinFrame

unsigned MatroskaFileParser::fCurOffsetWithinFrame

private

Definition at line 133 of file MatroskaFileParser.hh.

fCurParserIndex

unsigned StreamParser::fCurParserIndex

privateinherited

Definition at line 155 of file StreamParser.hh.

Referenced by StreamParser::curOffset(), StreamParser::ensureValidBytes(), StreamParser::get1Byte(), StreamParser::get2Bytes(), StreamParser::get4Bytes(), StreamParser::getBytes(), StreamParser::lastParsed(), StreamParser::nextToParse(), and StreamParser::skipBytes().

fCurrentParseState

MatroskaParseState MatroskaFileParser::fCurrentParseState

private

Definition at line 111 of file MatroskaFileParser.hh.

fFrameSizesWithinBlock

unsigned* MatroskaFileParser::fFrameSizesWithinBlock

private

Definition at line 128 of file MatroskaFileParser.hh.

fHaveSeenEOF

Boolean StreamParser::fHaveSeenEOF

privateinherited

Definition at line 162 of file StreamParser.hh.

Referenced by StreamParser::haveSeenEOF().

fInputSource

FramedSource* MatroskaFileParser::fInputSource

private

Definition at line 107 of file MatroskaFileParser.hh.

fLastSeekId

EBMLId MatroskaFileParser::fLastSeekId

private

Definition at line 118 of file MatroskaFileParser.hh.

fLastSeenPresentationTime

struct timeval StreamParser::fLastSeenPresentationTime

privateinherited

Definition at line 164 of file StreamParser.hh.

fLimitOffsetInFile

u_int64_t MatroskaFileParser::fLimitOffsetInFile

private

Definition at line 112 of file MatroskaFileParser.hh.

fNextFrameNumberToDeliver

unsigned MatroskaFileParser::fNextFrameNumberToDeliver

private

Definition at line 132 of file MatroskaFileParser.hh.

fNumFramesInBlock

unsigned MatroskaFileParser::fNumFramesInBlock

private

Definition at line 127 of file MatroskaFileParser.hh.

fNumHeaderBytesToSkip

u_int64_t MatroskaFileParser::fNumHeaderBytesToSkip

private

Definition at line 115 of file MatroskaFileParser.hh.

fOnEndClientData

void* MatroskaFileParser::fOnEndClientData

private

Definition at line 109 of file MatroskaFileParser.hh.

fOnEndFunc

FramedSource::onCloseFunc* MatroskaFileParser::fOnEndFunc

private

Definition at line 108 of file MatroskaFileParser.hh.

fOurDemux

MatroskaDemux* MatroskaFileParser::fOurDemux

private

Definition at line 110 of file MatroskaFileParser.hh.

fOurFile

MatroskaFile& MatroskaFileParser::fOurFile

private

Definition at line 106 of file MatroskaFileParser.hh.

fPresentationTimeOffset

double MatroskaFileParser::fPresentationTimeOffset

private

Definition at line 131 of file MatroskaFileParser.hh.

fRemainingUnparsedBits

unsigned char StreamParser::fRemainingUnparsedBits

privateinherited

Definition at line 156 of file StreamParser.hh.

Referenced by StreamParser::get1Byte(), StreamParser::get2Bytes(), StreamParser::get4Bytes(), and StreamParser::getBytes().

fSavedCurOffsetInFile

u_int64_t MatroskaFileParser::fSavedCurOffsetInFile

private

Definition at line 112 of file MatroskaFileParser.hh.

fSavedCurOffsetWithinFrame

unsigned MatroskaFileParser::fSavedCurOffsetWithinFrame

private

Definition at line 133 of file MatroskaFileParser.hh.

fSavedParserIndex

unsigned StreamParser::fSavedParserIndex

privateinherited

Definition at line 151 of file StreamParser.hh.

fSavedRemainingUnparsedBits

unsigned char StreamParser::fSavedRemainingUnparsedBits

privateinherited

Definition at line 152 of file StreamParser.hh.

fTotNumValidBytes

unsigned StreamParser::fTotNumValidBytes

privateinherited

Definition at line 159 of file StreamParser.hh.

Referenced by StreamParser::ensureValidBytes(), and StreamParser::totNumValidBytes().

---

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

• liveMedia/MatroskaFileParser.hh