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 const &size, u_int64_t &result)
Boolean	parseEBMLVal_unsigned (EBMLDataSize const &size, unsigned &result)
Boolean	parseEBMLVal_float (EBMLDataSize const &size, float &result)
Boolean	parseEBMLVal_string (EBMLDataSize const &size, char *&result)
Boolean	parseEBMLVal_binary (EBMLDataSize const &size, u_int8_t *&result)
Boolean	parseEBMLVal_binary_constrainSize (EBMLDataSize const &size, u_int32_t &length, 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 )

References NULL.

~MatroskaFileParser()

virtual MatroskaFileParser::~MatroskaFileParser ( )

virtual

Member Function Documentation

afterGettingBytes()

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]

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 fCurBank.

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

curOffset()

unsigned StreamParser::curOffset ( ) const

inlineprotectedinherited

Definition at line 107 of file StreamParser.hh.

{ return fCurParserIndex; }

References 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 ensureValidBytes1(), fCurParserIndex, and fTotNumValidBytes.

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

ensureValidBytes1()

void StreamParser::ensureValidBytes1 ( unsigned numBytesNeeded )

privateinherited

Referenced by 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 curBank(), ensureValidBytes(), fCurParserIndex, and 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 ensureValidBytes(), fCurParserIndex, fRemainingUnparsedBits, and 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 fCurParserIndex, fRemainingUnparsedBits, and 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 fCurParserIndex, fRemainingUnparsedBits, and 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 fHaveSeenEOF.

lastParsed()

unsigned char * StreamParser::lastParsed ( )

inlineprivateinherited

Definition at line 118 of file StreamParser.hh.

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

References curBank(), and 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 curBank(), and fCurParserIndex.

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

onInputClosure()

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 const & size, u_int8_t *& result )

private

parseEBMLVal_binary_constrainSize()

Boolean MatroskaFileParser::parseEBMLVal_binary_constrainSize ( EBMLDataSize const & size, u_int32_t & length, u_int8_t *& result )

private

parseEBMLVal_float()

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

private

parseEBMLVal_string()

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

private

parseEBMLVal_unsigned()

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

private

parseEBMLVal_unsigned64()

Boolean MatroskaFileParser::parseEBMLVal_unsigned64 ( EBMLDataSize const & 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 ensureValidBytes(), and 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 ensureValidBytes(), and 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 ensureValidBytes(), and 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 ensureValidBytes(), and nextToParse().

Referenced by 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 ensureValidBytes(), and nextToParse().

Referenced by getBytes().

totNumValidBytes()

unsigned & StreamParser::totNumValidBytes ( )

inlineprotectedinherited

Definition at line 109 of file StreamParser.hh.

{ return fTotNumValidBytes; }

References 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 128 of file MatroskaFileParser.hh.

fBlockTimecode

short MatroskaFileParser::fBlockTimecode

private

Definition at line 130 of file MatroskaFileParser.hh.

fBlockTrackNumber

unsigned MatroskaFileParser::fBlockTrackNumber

private

Definition at line 129 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 125 of file MatroskaFileParser.hh.

fCurBank

unsigned char* StreamParser::fCurBank

privateinherited

Definition at line 148 of file StreamParser.hh.

Referenced by curBank().

fCurBankNum

unsigned char StreamParser::fCurBankNum

privateinherited

Definition at line 147 of file StreamParser.hh.

fCurFrameNumBytesToGet

unsigned MatroskaFileParser::fCurFrameNumBytesToGet

private

Definition at line 141 of file MatroskaFileParser.hh.

fCurFrameNumBytesToSkip

unsigned MatroskaFileParser::fCurFrameNumBytesToSkip

private

Definition at line 142 of file MatroskaFileParser.hh.

fCurFrameTo

u_int8_t* MatroskaFileParser::fCurFrameTo

private

Definition at line 140 of file MatroskaFileParser.hh.

fCurOffsetInFile

u_int64_t MatroskaFileParser::fCurOffsetInFile

private

Definition at line 116 of file MatroskaFileParser.hh.

fCurOffsetWithinFrame

unsigned MatroskaFileParser::fCurOffsetWithinFrame

private

Definition at line 137 of file MatroskaFileParser.hh.

fCurParserIndex

unsigned StreamParser::fCurParserIndex

privateinherited

Definition at line 155 of file StreamParser.hh.

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

fCurrentParseState

MatroskaParseState MatroskaFileParser::fCurrentParseState

private

Definition at line 115 of file MatroskaFileParser.hh.

fFrameSizesWithinBlock

unsigned* MatroskaFileParser::fFrameSizesWithinBlock

private

Definition at line 132 of file MatroskaFileParser.hh.

fHaveSeenEOF

Boolean StreamParser::fHaveSeenEOF

privateinherited

Definition at line 162 of file StreamParser.hh.

Referenced by haveSeenEOF().

fInputSource

FramedSource* MatroskaFileParser::fInputSource

private

Definition at line 111 of file MatroskaFileParser.hh.

fLastSeekId

EBMLId MatroskaFileParser::fLastSeekId

private

Definition at line 122 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 116 of file MatroskaFileParser.hh.

fNextFrameNumberToDeliver

unsigned MatroskaFileParser::fNextFrameNumberToDeliver

private

Definition at line 136 of file MatroskaFileParser.hh.

fNumFramesInBlock

unsigned MatroskaFileParser::fNumFramesInBlock

private

Definition at line 131 of file MatroskaFileParser.hh.

fNumHeaderBytesToSkip

u_int64_t MatroskaFileParser::fNumHeaderBytesToSkip

private

Definition at line 119 of file MatroskaFileParser.hh.

fOnEndClientData

void* MatroskaFileParser::fOnEndClientData

private

Definition at line 113 of file MatroskaFileParser.hh.

fOnEndFunc

FramedSource::onCloseFunc* MatroskaFileParser::fOnEndFunc

private

Definition at line 112 of file MatroskaFileParser.hh.

fOurDemux

MatroskaDemux* MatroskaFileParser::fOurDemux

private

Definition at line 114 of file MatroskaFileParser.hh.

fOurFile

MatroskaFile& MatroskaFileParser::fOurFile

private

Definition at line 110 of file MatroskaFileParser.hh.

fPresentationTimeOffset

double MatroskaFileParser::fPresentationTimeOffset

private

Definition at line 135 of file MatroskaFileParser.hh.

fRemainingUnparsedBits

unsigned char StreamParser::fRemainingUnparsedBits

privateinherited

Definition at line 156 of file StreamParser.hh.

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

fSavedCurOffsetInFile

u_int64_t MatroskaFileParser::fSavedCurOffsetInFile

private

Definition at line 116 of file MatroskaFileParser.hh.

fSavedCurOffsetWithinFrame

unsigned MatroskaFileParser::fSavedCurOffsetWithinFrame

private

Definition at line 137 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 ensureValidBytes(), and totNumValidBytes().

---

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

• liveMedia/MatroskaFileParser.hh