CascadeMPEGFile.h

Go to the documentation of this file.

//
// CascadeMPEGFile.h - header file for class CascadeMPEGFile
//
// Copyright (c) 2003, Roku, LLC.  All rights reserved.
//

#ifndef _ROKU_INCLUDE_CASCADE_AV_CASCADEMPEGFILE_H
#define _ROKU_INCLUDE_CASCADE_AV_CASCADEMPEGFILE_H

#include <cascade/util/CascadeStream.h>
#include <cascade/util/CascadeArray.h>


class CascadeMPEGFile : public CascadeObject
{
public:
        CascadeMPEGFile();
        virtual ~CascadeMPEGFile();
public:
    enum MPEGFileType
    {
        kUnknownMPEGFileType = 0,
        kMPEG1ProgramStream = 1,
        kMPEG2ProgramStream,
        kMPEG2TransportStream,
    };

    enum AudioStreamType
    {
        kUnknownAudioStreamType = 0,
        kAC3 = 1,
        kPCM,
        kMPEG1Layer1,
        kMPEG1Layer2,
        kMPEG1Layer3,
    };

    class Program
    {
    public:
        u32     m_nProgramID;
        u32     m_nPCRPID;
    };

    class AudioStream
    {
    public:
        u32             m_nPIDorStreamID;
        u32             m_nSSID;            /* program streams with ac3 only! */
        AudioStreamType m_streamType;
        char            m_language[4];      /* null-terminated ISO 639-2/B - 3 letter bibliographic language code */
    };

    class VideoStream
    {
    public: 
        u32             m_nPIDorStreamID;
        u32             m_nPictureWidth;
        u32             m_nPictureHeight;
    };

public:
    bool SetStream(CascadeStream & stream);
        // SetStream() will read from the stream at the current position and leave the stream read from
        // i.e. It won't reset the seek position in the stream

    bool SelectProgram(u32 nProgram, s32 nVideoStreamIndex, s32 nAudioStreamIndex);
        // -1 on a stream means no stream
    bool Serialize(u32 & nSizeToSet, void * & pSerializedDataToSet);
        // Serialize serializes the mpeg file info to a format suitable for inclusion
        // in a wormhole message.  pDataToSet is only valid for while this CascadeMPEGFile
        // refers to the data that has been serialized with a call to serialize.  (e.g. until
        // this is destructed or until SetFile has been called on another file or until SelectProgram()
        // has been called to select another program.  Clients should copy the data returned
        // by Serialize() right away for maximum safety.
    bool Deserialize(u32 nSize, void * pSerializedData);
        // Deserialize deserializes the serialized mpeg file info passed in and makes this
        // refer to the mpeg file identified by the serialized info passed in.
public:
    MPEGFileType GetMPEGFileType() { return m_fileType; }
    const char * GetMPEGStreamURL() { return m_pStreamURL; }
    void GetSelectedProgram(u32 & nProgramToSet, s32 & nVideoStreamIndexToSet, s32 & nAudioStreamIndexToSet);
        // -1 on a stream means no stream

    u32 GetNumPrograms();
    u32 GetNumVideoStreams(u32 nProgramIndex);
    u32 GetNumAudioStreams(u32 nProgramIndex);

    Program     GetProgramAt(u32 nProgramIndex);
    AudioStream GetAudioStreamAt(u32 nProgramIndex, u32 nIndex);
    VideoStream GetVideoStreamAt(u32 nProgramIndex, u32 nIndex);

    void Dump();

private:
    class ProgramRecord
    {
    public:
        Program m_program;
        CascadeTemplateArray<AudioStream> m_audioStreams;
        CascadeTemplateArray<VideoStream> m_videoStreams;
    };

private:
    void Nullify();
    ProgramRecord * GetProgramRecordAt(u32 nProgram);
    void Parse(class ParseData & parseData);
    bool ParseAsTransportStream(class ParseData & parseData);
    bool ParseAsProgramStream2(class ParseData & parseData);
    bool ParseAsProgramStream1(class ParseData & parseData);
    static void StaticPATParseCB(void *, void *);
    static void StaticPMTParseCB(void *, void *);

        bool ExistPacketStartPrefix(u8 * pPacket);
        bool ExistSystemHeaderStartCode(u8 * pPacket);
        u16 ProgramStreamPackHeader(class ParseData & parseData, u8 * pPacket, u8 bVideoStreamId[], u16 * pnVideoStreamId, u8 bAudioStreamId[], u8 bAudioSubStreamId[], u8 bAudioStreamType[], u16 * pnAudioStreamId);
        u16 ProgramStreamPESPacket(class ParseData & parseData, u8 * pPacket, u8 bVideoStreamId[], u16 * pnVideoStreamId, u8 bAudioStreamId[], u8 bAudioSubStreamId[], u8 bAudioStreamType[], u16 * pnAudioStreamId);

private:
    CascadeTemplateArray<ProgramRecord *> m_programs;
    MPEGFileType m_fileType;
    char * m_pStreamURL;

    u32 m_nSelectedProgram;
    s32 m_nSelectedVideoStreamIndex;
    s32 m_nSelectedAudioStreamIndex;

    u32 * m_pSerializedData;
};

#endif // #ifndef _ROKU_INCLUDE_CASCADE_AV_CASCADEMPEGFILE_H

//  LOG
//  02-Nov-03   dwoodward       created
//  17-Aug-04   dwoodward   added SSID to AudioStream and change language to
//                          iso 639-2/B code instead of enum
//  19-Aug-04   hinamura    support for PS parsing
//  13-May-05   dwoodward   replaced SetFile() with SetStream()

---