/*

* 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:   VideoFileDetailsViewPlugin class definition

* 

*/

#ifndef VIDEOFILEDETAILSPLUGIN_H

#define VIDEOFILEDETAILSPLUGIN_H

// INCLUDES

#include <qobject>

#include <mpxviewpluginqt.h>

#include <hbdocumentloader.h>

#include <qpixmap.h>

class VideoSortFilterProxyModel;

class QModelIndex;

class HbAction;

class HbMarqueeItem;

class ThumbnailManager;

class VideoServices;

class VideoCollectionWrapper;

class VideoFileDetailsViewPlugin : public MpxViewPlugin

	{

    Q_OBJECT

public: // Constructor / destructor

    /**

     * Contructor.

     *

     */ 

    VideoFileDetailsViewPlugin();

    /**

     * Destructor.

     *

     */ 

    virtual ~VideoFileDetailsViewPlugin();

public: // from QViewPlugin

    /**

     * Initializes view creation.

     *

     */

    void createView();

    /**

     * Deallocates view and it's objects.

     */

    void destroyView();

    /**

     * Activates view

     *

     */

    void activateView();

    /**

     * Deactivates view

     *

     */

    void deactivateView();

    /**

     * Returns a pointer to the view read from the XML

     *

     * @return QGraphicsWidget*

     */

    QGraphicsWidget* getView();

signals:

    /**

     * Command signal, plugin user shoulf connect this in case it wants

     * to receive commands emitted from the view.

     *

     * @param command id

     */

    void command( int );

    /**

     * Signals the URI of the current video to VideoServices

     *

     * @param URI of the video

     */

    void fileUri(const QString&);

public slots: // from QViewPlugin

    /**

     * Plugin user can notify orientation changes by connecting into this slot

     * ti it's signal. In normal cases, view handles orientation chages itself.

     *

     * @param orientation new orientation

     */

    void orientationChange( Qt::Orientation orientation );

    /**

     * Plugin user can notify oback button changes by connecting into this slot

     *

     */

    void back();

private slots:

    /**

     * Signaled when attach button is clicked, only when started as a service.

	 * Gets the URI of the current video

     *

     */

	void getFileUri();

    /**

     * Signaled when short details are ready.

     * 

     * @param index Index of the clip, needed when getting the data from model.

     */

    void shortDetailsReadySlot(int index);

    /**

     * Signaled when full details are ready.

     * 

     * @param index Index of the clip, needed when getting the data from model.

     */

    void fullDetailsReadySlot(int index);

    /**

     * Slot that receives signal from play button to start playback.

     */

    void startPlaybackSlot();

    /**

     * Slot that receives signal from send button

     */

    void sendVideoSlot();

    /**

     * Slot that receives signal from delete button

     */

    void deleteVideoSlot();

    /**

     * Slot that receives signal when video(s) removed. 

     * If video to be removed is the one whose details

     * are visible, this view is deactivated and collection 

     * list view is put back on.

     * 

     * @param parent parent item index (not used at the moment)

     * @param first first item to remove

     * @param last last item to remove

     */

    void rowsRemovedSlot(const QModelIndex &parent, int first, int last);

    /**

     * Slot is connected into videocollection wrapper's asyncStatus -signal

     *

     * Handles possible collection error; usually by just showing error msg

     *

     * @param errorCode error code

     * @param additional additional data gotten from the error 

     */

    void handleErrorSlot(int errorCode, QVariant &additional);

    /**

     * Slot that is connected to thumbnailReady signal in tnwrapper, which

     * signals when thumbnail loading has been completed.

     *

     * @param pixmap     An object representing the resulting thumbnail.

     * @param clientData Client data

     * @param id         Request ID for the operation

     * @param errorCode  error code

     */

    void thumbnailReadySlot(QPixmap pixmap, void * clientData, int id, int errorCode);

private:

    /**

     * Pre-creates the view and thumbnailmanager.

     *

     */

    void preCreateView();

    /**

     * Allocates view and rest of it's objects to be ready to 

     * be activated.

     *

     */

    void finalizeCreateView();

    /**

     * Signaled for one item deletion.

     *

     */

    void deleteItem(QModelIndex index);

    /**

     * Starts fetching the large thumbnail with tnwrapper.

     */

    void startFetchingThumbnail();

    /**

     * Finds and return the widget from document loader with the given name. Casts

     * to templated type.

     * 

     * @param name Name of the widget

     * @return The widget.

     */

    template<class T> 

    T* findWidget(QString name);

    template<class T>

    T* findObject(QString name);

private:

    /**

     * Details view create status

     */

    enum TViewStatus

    {

        ENotCreated,

        EPreCreated,

        EFinalized

    };

    /**

     * Document loader that holds the view object

     */

    HbDocumentLoader mView;

    /**

     * Pointer to the model that holds video details. Not owned.

     */

    VideoSortFilterProxyModel* mModel;

    /**

     * pointer to videoservices instance

     */

    VideoServices* mVideoServices;

    /**

     * Activated flag. Set as true when view is properly activated.

     * If flag is false, no operations can be do to the view.

     */

    bool mActivated;

    /**

     * Boolean for knowing when the app was started as a service.

     */

    bool mIsService;

    /**

     * Details view create status,

     * if ENotCreated, view has not been created,

     * if EPreCreated, view has been pre created

     * if EFinalized, view creation has been finalised

     */

    TViewStatus mCreated;

    /**

     * Index of the video clip in the model.

     */

    int mVideoIndex;

    /**

     * Defined action to be set to top right button, when view is activated

     */

    HbAction *mSecSkAction;

    /**

     * Title animation widget

     */

    HbMarqueeItem *mTitleAnim;

    /**

     * Thumbnail manager.

     */

    ThumbnailManager* mThumbnailManager;

    /**

     * Collection wrapper.

     */

    VideoCollectionWrapper *mCollectionWrapper;

    };

#endif  // VIDEOFILEDETAILSPLUGIN_H

// End of File