videocollection/videocollectionwrapper/tsrc/testvideothumbnaildata_p/stub/inc/videothumbnailfetcher.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 14 May 2010 15:53:50 +0300
changeset 20 b9e04db066d4
parent 15 cf5481c2bc0b
permissions -rw-r--r--
Revision: 201017 Kit: 201019

/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "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: VideoThumbnailFetcher class definition
*
*/

#ifndef __VIDEOTHUMBNAILDATAFETCHER_H__
#define __VIDEOTHUMBNAILDATAFETCHER_H__

// INCLUDES
#include <qobject.h>
#include <qicon.h>
#include <qlist.h>
#include <qhash.h>
#include <qmap.h>
#include <qpixmap.h>
#include <mpxitemid.h>

// FORWARD DECLARATIONS


class ThumbnailFetchData
{
    public:
        QString mFileName;
        int mPriority;
        void *mInternal;
        TMPXItemId mediaId;
};

class VideoThumbnailFetcher : public QObject
{
    /**
     * defined to be able to use signals and slots
     */
    Q_OBJECT

public:

    /**
     * Default constructor
     */
    VideoThumbnailFetcher();
    
    /**
     * Desctructor
     */
    ~VideoThumbnailFetcher();

    /**
     * Adds thumbnail fetch to the fetch list. pauseFetching should be called 
     * before adding fetches for performance reasons. After all fetches have
     * been added, call continueFetching to start the fetch process which passes 
     * the internal data to thumbnail manager. Signal thumbnailReady is emitted 
     * when fetch is complete. 
     * 
     * @param fileName path to the media.
     * @param mediaId mpx id for the media.
     * @param priority priority for the fetch.
     * 
     */
    void addFetch(const QString fileName, const TMPXItemId &mediaId, int priority);    
    
    /**
     * Empties fetch list. This does not cancel the possible ongoing fetch on
     * thumbnail manager side.
     * 
     */
    void cancelFetches();
    
    /**
     * Returns count of the fetches.
     * 
     */
    int fetchCount();
    
    /**
     * Pauses thumbnail fetching process. This does not pause the possible 
     * ongoing fetch on thumbnail manager side. 
     * 
     */
    void pauseFetching();
    
    /**
     * Continues the fetching process. All fetches added with addFetch are 
     * started without create thumbnail flag. If there's not any of those, 
     * starts creating thumbnails for fetches that have no thumbnail yet. 
     * Signal allThumbnailsFetched is emitted if there's nothing to do.
     * 
     */
    void continueFetching(bool cancelOngoingFetches);
    
    /**
     * Enables or disables the thumbnail creation for videos that do  
     * not have thumbnail already in the database.
     * 
     * @param enable true enables thumbnail creation, false disables. 
     * 
     */
    void enableThumbnailCreation(bool enable);
    
// Test helper methods
public:
    
    void emitThumbnailReady(QPixmap pixmap, const TMPXItemId &mediaId, int error);
    
    void emitAllThumbnailsFetched();

signals:

    /**
     * Signaled after signal from thumbnail manager has been processed and
     * thumbnail fetch process is complete.
     *
     * @param tnData thumbnail
     * @param mediaId mpx id for the media. 
     * @param error possible error code from thumbnail manager ( 0 == ok )
     * 
     */
    void thumbnailReady(QPixmap tnData, const TMPXItemId &mediaId, int error);

    /**
     * Signaled when all the fetches have been done.
     * 
     */
    void allThumbnailsFetched();
    
public:

    struct TnRequest
    {
       QString name;
       TMPXItemId id;
       int priority;
       bool cancelled;

       TnRequest(QString name, const TMPXItemId &id, int priority, bool cancelled) {
           this->name = name;
           this->id = id;
           this->priority = priority;
           this->cancelled = cancelled;
       }

       TnRequest() {
           name = QString("");
           priority = -1;
           cancelled = false;
       }
    };

    static QMap<int, TnRequest> mRequests;
    
public: // Data
    
    static int mConstructorCallCount;
    static int mDestructorCallCount;
    static int mAddFetchCallCount;
    static int mCancelFetchesCallCount;
    static int mFetchCountCallCount;
    static int mPauseFetchingCallCount;
    static int mContinueFetchingCallCount;
    static int mEnableThumbnailCreationCallCount;
    
    static bool mAddFetchFails;
    static int mThumbnailReadyError;
        
    /*
    static int mxxxCallCount;
    static int mxxxCallCount;
    static int mxxxCallCount;
    static int mxxxCallCount;
    static int mxxxCallCount;
    static int mxxxCallCount;*/
};

#endif // __VIDEOTHUMBNAILDATAFETCHER_H__