qttrkmgr.h

来自「symbian 下的helix player源代码」· C头文件 代码 · 共 213 行

/* ***** BEGIN LICENSE BLOCK ***** 
 * Version: RCSL 1.0/RPSL 1.0 
 *  
 * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
 *      
 * The contents of this file, and the files included with this file, are 
 * subject to the current version of the RealNetworks Public Source License 
 * Version 1.0 (the "RPSL") available at 
 * http://www.helixcommunity.org/content/rpsl unless you have licensed 
 * the file under the RealNetworks Community Source License Version 1.0 
 * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
 * in which case the RCSL will apply. You may also obtain the license terms 
 * directly from RealNetworks.  You may not use this file except in 
 * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
 * applicable to this file, the RCSL.  Please see the applicable RPSL or 
 * RCSL for the rights, obligations and limitations governing use of the 
 * contents of the file.  
 *  
 * This file is part of the Helix DNA Technology. RealNetworks is the 
 * developer of the Original Code and owns the copyrights in the portions 
 * it created. 
 *  
 * This file, and the files included with this file, is distributed and made 
 * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
 * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
 * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
 * 
 * Technology Compatibility Kit Test Suite(s) Location: 
 *    http://www.helixcommunity.org/content/tck 
 * 
 * Contributor(s): 
 *  
 * ***** END LICENSE BLOCK ***** */ 

#ifndef _QTTRKMGR_H_
#define _QTTRKMGR_H_

/****************************************************************************
 *  Includes
 */
#include "qtatoms.h"

class CQTFileFormat;
class CQTPacketAssembler;
class CQTTrack;
class CQTPacketizerFactory;

/****************************************************************************
 *  Globals
 */
typedef enum
{
    QT_FTYPE_UNKNOWN,
    QT_FTYPE_QT,
    QT_FTYPE_MP4,
    QT_FTYPE_EMC
} QT_FTYPE;

typedef enum
{
    QT_ETYPE_UNKNOWN,
    QT_ETYPE_SERVER,
    QT_ETYPE_CLIENT
} QT_ETYPE;

/****************************************************************************
 * 
 *  Class:
 *	CTrackManager
 *
 *  Purpose:
 *	Provides mapping of tracks to streams and maintains
 *  collective information about the tracks including the
 * tracks themselves.
 */
class CQTTrackManager
{
public:
    /*
     *	Constructor/Destructor
     */
    CQTTrackManager(void);

    ~CQTTrackManager();

    /*
     *	Main Interface
     */
    HX_RESULT ManageTracks(CQTAtom *pRootAtom);
    HX_RESULT ReadyTracks(BOOL bIgnoreHintTracks = FALSE,
			  BOOL bFallbackToTracks = FALSE);
    HX_RESULT InitTracks(CQTFileFormat *pFileFormat,
			 CQTPacketAssembler *pPacketAssembler,

			 CQTPacketizerFactory* pPacketizerFactory,
			 const char* pProtocol = NULL);
    HX_RESULT AddStreamToGroup(UINT16 uStreamNumber,
			       UINT16 uGroup, 
			       ULONG32 ulBitrate);
    HX_RESULT SubscribeDefault(void);
    HX_RESULT Subscribe(UINT16 uStreamNum);
    HX_RESULT Unsubscribe(UINT16 uStreamNum);
    HX_RESULT RemoveInactiveStreams(BOOL bLeaveReferences = FALSE);

    void CloseTracks(void);
    void ResetTracks(void);

    UINT16  GetNumStreams(void)    { return m_uNumStreams; }
    UINT16  GetNumTracks(void)     { return m_uNumTracks; }
    UINT16  GetNumActiveStreams(void);
    
    CQTTrack* GetTrack(UINT16 uTrackIndex)
    {
	return m_pTrackTable[uTrackIndex].m_pTrack;
    }
    CQTTrack* GetStreamTrack(UINT16 uStreamNumber)
    {
	return m_pStreamToTrackMap[uStreamNumber].m_pQTTrack;
    }
    CQTTrack* GetTrackById(ULONG32 ulTrackID);
    CQTAtom* GetTrackAtomById(ULONG32 ulTrackID);
    BOOL IsStreamTrack(CQTTrack* pTrack);

    BOOL IsStreamTrackActive(UINT16 uStreamNumber)
    {
	return m_pStreamToTrackMap[uStreamNumber].m_bActive;
    }

    QT_FTYPE GetFType(void)	{ return m_FType; }
    QT_ETYPE GetEType(void)	{ return m_EType; }
    void SetEType(QT_ETYPE eEType)  { m_EType = eEType; }
    BOOL IsHintsEnabled(void)	{ return m_bHintTracksActive; }
    BOOL IsHinted(void)		{ return m_bHinted; }

    static CQT_hdlr_Atom* GetTrackAtomHdlr(CQT_trak_Atom* pTrakAtom);
    static CQT_stbl_Atom* GetTrackAtomStbl(CQT_trak_Atom* pTrakAtom);
    static BOOL IsHintTrackAtom(CQT_trak_Atom* pTrakAtom);
    static BOOL IsNonEmptyTrackAtom(CQT_trak_Atom* pTrakAtom);
    
private:
    class CQTTrackTable
    {
    public:
	CQTTrackTable(void)
	    : m_uRefCount(0)
	    , m_pTrack(NULL)
	    , m_pTrackAtom(NULL)
	{
	    ;
	}

	~CQTTrackTable();

	CQTTrack* m_pTrack;
	CQTAtom* m_pTrackAtom;
	UINT16 m_uRefCount;
    };

    class CQTStream
    {
    public:
	CQTStream(void)
	    : m_pQTTrack(NULL)
	    , m_bActive(FALSE)
	    , m_bGroupped(FALSE)
	    , m_uGroup(0)
	    , m_ulBitrate(0)
	{
	    ;
	}

	CQTTrack* m_pQTTrack;
	BOOL	m_bActive;
	BOOL	m_bGroupped;
	UINT16	m_uGroup;
	ULONG32 m_ulBitrate;
    };

    void DecideHintTrackActivation(BOOL bFallbackToTracks);
    HX_RESULT CreateHintTrack(CQTAtom* pTrackAtom, 
			      UINT16 uTrackIdx,
			      UINT16& uStreamTrackCount);

    void ReleaseTrack(CQTTrack* pQTTrack);
    void AddTracks(CQTAtom* pRootAtom);
    void DeleteTrackAtomList(void);
    void Clear(void);    

    UINT16 GetTrackStreamNum(CQTTrack* pTrack);

    UINT16 m_uNumTracks;
    UINT16 m_uNumStreams;

    BOOL m_bHinted;
    BOOL m_bHintTracksActive;
    QT_FTYPE m_FType;
    QT_ETYPE m_EType;

    BOOL m_bSubscriptionWindowClosed;

    CQTTrackTable* m_pTrackTable;
    CQTStream* m_pStreamToTrackMap;

    CHXSimpleList* m_pTrackAtomList;
    CHXSimpleList* m_pHintTrackIdxList;

    CQT_iods_Atom* m_pIodsAtom;
    CQT_ftyp_Atom* m_pFtypAtom;
};

#endif  // _QTTRKMGR_H_