fileindextable.cpp

著名的 helix realplayer 基于手机 symbian 系统的 播放器全套源代码

/* ***** 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 ***** */

/****************************************************************************
 *  Defines
 */

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

#include "fileindextable.h"


/****************************************************************************
 *  Class CFileIndexTable
 */
/****************************************************************************
 *  Constructor/Destructor
 */
CFileIndexTable::CFileIndexTable(void)
    : m_uNumStreams(0)
    , m_pStreamIndexTable(NULL)
{
    ;
}

CFileIndexTable::~CFileIndexTable()
{
    _Close();
}

/****************************************************************************
 *  Main Interface
 */
/****************************************************************************
 *  Init
 */
HX_RESULT CFileIndexTable::Init(UINT16 uNumStreams,
				UINT32 ulTimeGranularity,
				UINT32 ulMaxEntries,
				BOOL bUseAuxData)
{
    UINT32 ulIdx;
    HX_RESULT retVal = HXR_OK;

    _Close();

    m_uNumStreams = uNumStreams;

    if (m_uNumStreams != 0)
    {
	m_pStreamIndexTable = new CStreamIndexTable [m_uNumStreams];
	retVal = HXR_OUTOFMEMORY;
	if (m_pStreamIndexTable)
	{
	    retVal = HXR_OK;
	}
    }

    for (ulIdx = 0; SUCCEEDED(retVal) && (ulIdx < uNumStreams); ulIdx++)
    {
	retVal = m_pStreamIndexTable[ulIdx].Init(ulTimeGranularity,
						 ulMaxEntries,
						 bUseAuxData);
    }
	
    return retVal;
}


/****************************************************************************
 *  SetIndex
 */
HX_RESULT CFileIndexTable::SetIndex(UINT16 uStreamNumber,
				    UINT32 ulTime,
				    UINT32 ulOffset,
				    void* pAuxData)
{
    if (uStreamNumber >= m_uNumStreams)
    {
	return HXR_FAIL;
    }

    return m_pStreamIndexTable[uStreamNumber].SetIndex(ulTime,
						       ulOffset,
						       pAuxData);
}


/****************************************************************************
 *  GetIndex
 */
HX_RESULT CFileIndexTable::GetIndex(UINT16 uStreamNumber,
				    UINT32& ulTime,
				    UINT32& ulOffset,
				    void** ppAuxData)
{
    if (uStreamNumber >= m_uNumStreams)
    {
	return HXR_FAIL;
    }

    return m_pStreamIndexTable[uStreamNumber].GetIndex(ulTime,
						       ulOffset,
						       ppAuxData);
}

/****************************************************************************
 *  HasIndex
 */
BOOL CFileIndexTable::HasIndex(UINT16 uStreamNumber,
			       UINT32 ulTime)
{
    if (uStreamNumber >= m_uNumStreams)
    {
	return FALSE;
    }

    return m_pStreamIndexTable[uStreamNumber].HasIndex(ulTime);
}


/****************************************************************************
 *  UpdateGranularity
 */
void CFileIndexTable::UpdateGranularity(UINT32 ulTimeGranularity)
{
    UINT16 ulIdx;

    for (ulIdx = 0; ulIdx < m_uNumStreams; ulIdx++)
    {
	m_pStreamIndexTable[ulIdx].UpdateGranularity(ulTimeGranularity);
    }
}


/****************************************************************************
 *  UpdateTimeRange
 */
void CFileIndexTable::UpdateTimeRange(UINT16 uStreamNumber, UINT32 ulTime)
{
    if (uStreamNumber < m_uNumStreams)
    {
	m_pStreamIndexTable[uStreamNumber].UpdateTimeRange(ulTime);
    }
}


/****************************************************************************
 *  Close
 */
void CFileIndexTable::Close(void)
{
    _Close();
}


/****************************************************************************
 *  Private Methods
 */
/****************************************************************************
 *  _Close
 */
void CFileIndexTable::_Close(void)
{
    m_uNumStreams = 0;
        
    HX_VECTOR_DELETE(m_pStreamIndexTable);
}


/****************************************************************************
 *  Class CStreamIndexTable
 */
/****************************************************************************
 *  Constructor/Destructor
 */
CStreamIndexTable::CStreamIndexTable(void)
    : m_pIndexTable(NULL)
    , m_pAuxDataTable(NULL)
    , m_ulMaxEntries(0)
    , m_ulTimeGranulairty(0)
    , m_ulLastTime(0)
    , m_ulRangeTime(0)
{
    ;
}

CStreamIndexTable::~CStreamIndexTable()
{
    _Close();
}


/****************************************************************************
 *  Main Interface
 */
/****************************************************************************
 *  Init
 */
HX_RESULT CStreamIndexTable::Init(UINT32 ulTimeGranularity,
				  UINT32 ulMaxEntries,
				  BOOL bUseAuxData)
{
    HX_RESULT retVal = HXR_OK;

    _Close();

    m_ulMaxEntries = ulMaxEntries;
    m_ulTimeGranulairty = ulTimeGranularity;

    if (m_ulMaxEntries != 0)
    {	
	m_pIndexTable = new IndexEntry [m_ulMaxEntries];
	retVal = HXR_OUTOFMEMORY;
	if (m_pIndexTable)
	{
	    retVal = HXR_OK;
	}
	
	if (SUCCEEDED(retVal) && bUseAuxData)
	{
	    m_pAuxDataTable = new void* [m_ulMaxEntries];
	    retVal = HXR_OUTOFMEMORY;
	    if (m_pAuxDataTable)
	    {
		retVal = HXR_OK;
	    }
	}
    }

    return retVal;
}


/****************************************************************************
 *  SetIndex
 */
HX_RESULT CStreamIndexTable::SetIndex(UINT32 ulTime,
				      UINT32 ulOffset,
				      void* pAuxData)
{
    HX_RESULT retVal = HXR_FAIL;

    if (m_ulNumEntries >= m_ulMaxEntries)
    {
	return HXR_FAIL;
    }

    if ((m_ulNumEntries == 0) ||
	((ulTime > m_ulLastTime) &&
	 ((ulTime - m_ulLastTime) >= m_ulTimeGranulairty)))
    {
	m_ulLastTime = ulTime;
	if (m_ulLastTime > m_ulRangeTime)
	{
	    m_ulRangeTime = m_ulLastTime;
	}
	m_pIndexTable[m_ulNumEntries].m_ulTime = ulTime;
	m_pIndexTable[m_ulNumEntries].m_ulOffset = ulOffset;
	if (m_pAuxDataTable)
	{
	    m_pAuxDataTable[m_ulNumEntries] = pAuxData;
	}
	m_ulNumEntries++;

	retVal = HXR_OK;
    }

    return retVal;
}

/****************************************************************************
 *  GetIndex
 */
HX_RESULT CStreamIndexTable::GetIndex(UINT32& ulTime,
				      UINT32& ulOffset,
				      void** ppAuxData)
{
    HX_RESULT retVal = HXR_OK;
    ULONG32 ulTargetTime = ulTime;
    ULONG32 ulTableIdx;
    
    // Estimate Table Index to search from
    ulTableIdx = ulTargetTime / m_ulTimeGranulairty;

    if (m_ulNumEntries == 0)
    {
	retVal = HXR_FAIL;
    }

    if (ulTableIdx >= m_ulNumEntries)
    {
	ulTableIdx = m_ulNumEntries - 1;
    }

    // Scan Forward
    while (((ulTableIdx + 1) < (m_ulNumEntries - 1)) &&
	   (m_pIndexTable[ulTableIdx + 1].m_ulTime < ulTargetTime))
    {
	ulTableIdx++;
    }
    // Scan Backwards
    while ((ulTableIdx > 0) &&
	   (m_pIndexTable[ulTableIdx].m_ulTime > ulTargetTime))
    {
	ulTableIdx--;
    }

    // Report results
    ulTime = m_pIndexTable[ulTableIdx].m_ulTime;
    ulOffset = m_pIndexTable[ulTableIdx].m_ulOffset;
    if (m_pAuxDataTable)
    {
	if (ppAuxData)
	{
	    *ppAuxData = m_pAuxDataTable[ulTableIdx];
	}
    }
    
    retVal = (m_ulRangeTime < ulTargetTime) ? HXR_AT_END : HXR_OK;

    return retVal;
}


/****************************************************************************
 *  HasIndex
 */
BOOL CStreamIndexTable::HasIndex(UINT32 ulTime)
{
    return (ulTime <= m_ulLastTime);
}


/****************************************************************************
 *  UpdateGranularity
 */
void CStreamIndexTable::UpdateGranularity(UINT32 ulTimeGranularity)
{
    m_ulTimeGranulairty = ulTimeGranularity;
}


/****************************************************************************
 *  UpdateTimeRange
 */
void CStreamIndexTable::UpdateTimeRange(UINT32 ulTime)
{
    if (m_ulRangeTime < ulTime)
    {
	m_ulRangeTime = ulTime;
    }
}


/****************************************************************************
 *  Close
 */
void CStreamIndexTable::Close(void)
{
    _Close();
}


/****************************************************************************
 *  Private Methods
 */
/****************************************************************************
 *  _Close
 */
void CStreamIndexTable::_Close(void)
{
    m_ulNumEntries = 0;
    m_ulMaxEntries = 0;
    m_ulLastTime = 0;
    m_ulRangeTime = 0;
        
    HX_VECTOR_DELETE(m_pIndexTable);
    HX_VECTOR_DELETE(m_pAuxDataTable);
}