videocollection/hgmyvideos/inc/vcxhgmyvideosvideodataupdater.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 12 Mar 2010 15:43:00 +0200
branchRCL_3
changeset 10 ce5ada96ab30
parent 0 96612d01cf9f
child 11 5294c000a26d
permissions -rw-r--r--
Revision: 201007 Kit: 201008

/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:   CVcxHgMyVideosVideoData class definition*
*/




#ifndef VCXHGMYVIDEOSVIDEODATAUPDATER_H
#define VCXHGMYVIDEOSVIDEODATAUPDATER_H

// INCLUDE FILES
#include <coemain.h>
 
#include <thumbnailmanager.h>
#include <thumbnailmanagerobserver.h>
#include "vcxhgmyvideosvideodata.h"

// FORWARD DECLARATIONS
class CVcxHgMyVideosModel;
class CHgScroller;
class CMPXMediaArray;
class CThumbnailManager;
class CVcxHgMyVideosVideoList;
class CPeriodic;

// CLASS DECLARATION

/**
 *
 * @lib vcxhgmyvideos.lib
 */
NONSHARABLE_CLASS( CVcxHgMyVideosVideoDataUpdater ) :
        public CActive,
        public MThumbnailManagerObserver 
    {
    public:

        /**
         * Two-phased constructor.
         * 
         * @param aModel Reference to component model.
         * @param aScroller Reference to Hg list control.
         * @param aVideoArray Reference to video array.
         * @return New object.
         */
        static CVcxHgMyVideosVideoDataUpdater* NewL( 
                CVcxHgMyVideosModel& aModel,
                CHgScroller& aScroller,
                CVcxHgMyVideosVideoList& aVideoArray );

        /**
         * Two-phased constructor.
         * 
         * @param aModel Reference to component model.
         * @param aScroller Reference to Hg list control.
         * @param aVideoArray Reference to video array.
         * @return New object. 
         */
        static CVcxHgMyVideosVideoDataUpdater* NewLC( 
                CVcxHgMyVideosModel& aModel,
                CHgScroller& aScroller,
                CVcxHgMyVideosVideoList& aVideoArray );

        /**
         * Destructor.
         */
        virtual ~CVcxHgMyVideosVideoDataUpdater();

        /**
         * Sets data updater to pause or normal mode.
         * 
         * @param aPaused If ETrue, updater is paused.
         */
        void SetPausedL( TBool aPaused );

        /**
         * Called to inform video data updater that info array has changed.
         * Causes re-setting of all data as info array is the bases for fetched
         * additional video data.  
         */
        void InfoArrayChanged();        

        /**
         * Called by video list implementation when new data is needed.
         * Appends data item into buffer and flushes it to start fetching.
         * 
         * @param aMPXItemId MPX item id of video data.
         */
        void RequestDataL( TMPXItemId aMPXItemId );

        /**
         * Called by video list implementation when new data is needed.
         * Appends data item into buffer that needs to be flushed using 
         * FlushRequestBufferL() to start fetching.
         * 
         * @param aMPXItemId MPX item id of video data.
         */
        void AddToRequestBufferL( TMPXItemId aMPXItemId );

        /**
         * Called by video list implementation when new data is needed.
         * Flushes fetch requests from buffer.
         */
        void FlushRequestBufferL();

        /**
         * Called by video list implementation when data is not needed anymore.
         * Removes data item from buffer.
         * 
         * @param aMPXItemId MPX item id of video data.
         */
        void ReleaseData( TMPXItemId aMPXItemId );
        
    public: // From MThumbnailManagerObserver
        
        /**
         * Preview thumbnail generation or loading is complete.
         *
         * @param aThumbnail An object representing the resulting thumbnail.
         * @param aId Request ID for the operation
         */
        void ThumbnailPreviewReady( MThumbnailData& aThumbnail, TThumbnailRequestId aId );
    
        /**
         * Final thumbnail bitmap generation or loading is complete.
         *
         * @param aError         Error code.
         * @param aThumbnail     An object representing the resulting thumbnail.
         * @param aId            Request ID for the operation.
         */
        void ThumbnailReady( TInt aError, MThumbnailData& aThumbnail, TThumbnailRequestId aId );
                
    public: // From CActive

        /**
         * From CActive.
         */
        void RunL();

        /**
         * From CActive. 
         * 
         * @param aError Error code.
         * @return KErrNone if continuing is ok.
         */        
        TInt RunError( TInt aError );
        
        /**
         * From CActive.
         */        
        void DoCancel();

    protected:    
        
        /**
         * Default constructor
         *
         * @param aModel Reference to component model.
         * @param aScroller Reference to Hg list control.
         * @param aVideoArray Reference to video array.
         */
        CVcxHgMyVideosVideoDataUpdater( 
                CVcxHgMyVideosModel& aModel,
                CHgScroller& aScroller,
                CVcxHgMyVideosVideoList& aVideoArray );
    
        /**
         * 2nd phase constructor.
         */
        void ConstructL();
		
		/**
         * Returns index of fetch array based on MPX Item Id.
         * 
         * @param aMpxItemId MPX Item Id.
         * @return Index of array or KErrNotFound.
         */
        TInt IndexByMPXItemId( TMPXItemId aMpxItemId );
        
        /**
         * Selects next index to be fetched.
         * @param aSelectForPeekOnly  
         */
        void SelectNextIndexL( TBool aSelectForPeekOnly );
        
        /**
         * Removes item from fetch array.
         * 
         * @param aIndex Index of fetch array.
         */
        void RemoveItem( TInt aIndex );
                
        /**
         * Cancels possibly ongoing activities (thumbnail generation, DRM check).
         *
         * @param aIndex Index of fetch array.
         */
        void CancelActivities( TInt aIndex );
                
        /**
         * Adds item into fetch array. 
         * 
         * @param aMPXItemId MPX item id.
         */
        void AddItemToFetchArrayL( TMPXItemId aMPXItemId );
        
        /**
         * Cancels any on-going video data operations and deletes fetch array.
         */
        void CancelAndDeleteFetchArray();
        
        /**
         * Makes sure that video data fetching continues.
         */
        void ContinueVideoDataFetchingL();
        
        /**
         * Updates fetched video data to UI.
         */
        void UpdateVideoDataToUiL( CVcxHgMyVideosVideoData& aVideoData );
        
        /**
         * Checks if list refreshing is needed.
		 * 
		 * @param aIndex The item index on the Ganes list that was modified last.
         * @return ETrue if refreshing is needed, otherwise EFalse.
		 */
        TBool ListRefreshNeeded( TInt aIndex );
        
        /**
         * Callback method for RefreshTimer.  
         */
        static TInt RefreshTimerCallBack( TAny* aAny );
        
        /**
         * Refreshes the ganes list.
         */
        void RefreshScreen();

        /**
         * Checks DRM properties
         */
        void CheckDrmL( CVcxHgMyVideosVideoData& aVideoData );

        /**
         * Gets active request count
         */
        void GetActiveRequestCount( TInt& aPeekRequests, TInt& aGetRequests );

        /**
         * Starts thumbnail fetch
         */
        void StartThumbnailL( CVcxHgMyVideosVideoData& aItem, TBool aPeek );

    protected:

        /**
         * Reference to component's model.
         * Not own.
         */
        CVcxHgMyVideosModel& iModel;
        
        /**
         * Hg list component.
         * Not own.
         */
        CHgScroller& iScroller;
        
        /**
         * Array of videos that need data fetching.
         * Own
         */
        RPointerArray<CVcxHgMyVideosVideoData> iFetchArray; 
        
        /**
         * Reference to video array.
         * Not own.
         */
        CVcxHgMyVideosVideoList& iVideoArray; 
                        
        /** 
         * Used for indicating that list needs to be refreshed.         
         * Own.
         */ 
        CPeriodic* iRefreshTimer;
        
        /**
         * Flag for pause state.
         */
        TBool iPaused;
                
        /**
         * Flag indicates that list refresh is delayed. 
         */
        TBool iListRefreshIsDelayed;
    };

#endif // VCXHGMYVIDEOSVIDEODATAUPDATER_H