live
Public Member Functions | Static Public Member Functions | Protected Types | Protected Member Functions | Private Member Functions | Static Private Member Functions | Private Attributes
MatroskaFileParser Class Reference

#include <MatroskaFileParser.hh>

Inheritance diagram for MatroskaFileParser:
Inheritance graph
[legend]
Collaboration diagram for MatroskaFileParser:
Collaboration graph
[legend]

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

MatroskaFilefOurFile
 
FramedSourcefInputSource
 
FramedSource::onCloseFuncfOnEndFunc
 
void * fOnEndClientData
 
MatroskaDemuxfOurDemux
 
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::onCloseFuncfClientOnInputCloseFunc
 
void * fClientOnInputCloseClientData
 
clientContinueFuncfClientContinueFunc
 
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.

116{ return fCurBank; }
unsigned char * 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.

107{ return fCurParserIndex; }
unsigned fCurParserIndex

References StreamParser::fCurParserIndex.

◆ deliverFrameBytes()

void MatroskaFileParser::deliverFrameBytes ( )
private

◆ deliverFrameWithinBlock()

Boolean MatroskaFileParser::deliverFrameWithinBlock ( )
private

◆ ensureValidBytes()

void StreamParser::ensureValidBytes ( unsigned  numBytesNeeded)
inlineprivateinherited

◆ ensureValidBytes1()

void StreamParser::ensureValidBytes1 ( unsigned  numBytesNeeded)
privateinherited

◆ flushInput()

virtual void StreamParser::flushInput ( )
virtualinherited

◆ get1Byte()

u_int8_t StreamParser::get1Byte ( )
inlineprotectedinherited

Definition at line 79 of file StreamParser.hh.

79 { // byte-aligned
82 return curBank()[fCurParserIndex++];
83 }
void ensureValidBytes(unsigned numBytesNeeded)
unsigned char fRemainingUnparsedBits
unsigned char * curBank()

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.

60 {
62
63 unsigned char const* ptr = nextToParse();
64 u_int16_t result = (ptr[0]<<8)|ptr[1];
65
66 fCurParserIndex += 2;
68
69 return result;
70 }
unsigned char * nextToParse()

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.

46 { // byte-aligned; returned in big-endian order
47 u_int32_t result = test4Bytes();
48 fCurParserIndex += 4;
50
51 return result;
52 }
u_int32_t test4Bytes()
Definition: StreamParser.hh:53

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.

89 {
90 testBytes(to, numBytes);
91 fCurParserIndex += numBytes;
93 }
void testBytes(u_int8_t *to, unsigned numBytes)
Definition: StreamParser.hh:94

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.

111{ return fHaveSeenEOF; }
Boolean fHaveSeenEOF

References StreamParser::fHaveSeenEOF.

◆ lastParsed()

unsigned char * StreamParser::lastParsed ( )
inlineprivateinherited

Definition at line 118 of file StreamParser.hh.

118{ 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

◆ 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

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

98 {
99 ensureValidBytes(numBytes);
100 fCurParserIndex += numBytes;
101 }

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.

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

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

◆ test2Bytes()

u_int16_t StreamParser::test2Bytes ( )
inlineprotectedinherited

Definition at line 71 of file StreamParser.hh.

71 {
73
74 unsigned char const* ptr = nextToParse();
75 return (ptr[0]<<8)|ptr[1];
76 }

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

◆ test4Bytes()

u_int32_t StreamParser::test4Bytes ( )
inlineprotectedinherited

Definition at line 53 of file StreamParser.hh.

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

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.

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

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

Referenced by StreamParser::getBytes().

◆ totNumValidBytes()

unsigned & StreamParser::totNumValidBytes ( )
inlineprotectedinherited

Definition at line 109 of file StreamParser.hh.

109{ 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

◆ 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

◆ 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

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