/*

* Copyright (c) 2006-2007 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:  Image thumbnail decoder.

 *

*/

#ifndef THUMBNAILIMAGEDECODERV3_H

#define THUMBNAILIMAGEDECODERV3_H

#include "thumbnailprovider.h"

class CImageDecoder;

class CFbsBitmap;

// Size of buffer to load from file start to get EXIF thumbnail

const TInt KJpegLoadBufferSize = 64 * 1024;

/**

 *  Image thumbnail decoder.

 *

 *  @since S60 v5.0

 */

class CThumbnailImageDecoderv3: public CActive

    {

public:

    /**

     * C++ default constructor

     *

     * @since S60 v5.0

     * @param aFs File server session

     * @return New image thumbnail decoder instance.

     */

    CThumbnailImageDecoderv3( RFs& aFs );

    /**

     * Destructor

     *

     * @since S60 v5.0

     */

    virtual ~CThumbnailImageDecoderv3();

    /**

     * Creates a decoder from the given image buffer and gets image

     * information

     *

     * @since S60 v5.0

     * @param aBuffer Source image buffer.

     * @param aObserver Observer to relay notifications about completed

     *                  operations.

     * @param aFlags Decoding option flags.

     * @param aMimeType Mime-type of image to be decoded.

     * @param aSize desired size of thumbnail.

     */    

    void CreateL( const TDesC8* aBuffer, MThumbnailProviderObserver&

        aObserver, const CThumbnailManager::TThumbnailFlags aFlags, const

        TDataType& aMimeType, const TSize& aSize );    

    /**

     * Decode image.

     *

     * @since S60 v5.0

     * @param aDisplayMode Preferred display mode.

     */

    void DecodeL( const TDisplayMode aDisplayMode );

    /**

     * Returns the size of original image.

     *

     * @since S60 v5.0

     * @return Size of original image.

     */

    const TSize& OriginalSize()const;

private:

    /**

     * Used to release reserved resources.

     *

     * @since S60 v5.0

     */

    void Release();

    /**

     * Implements cancellation of an outstanding request.

     *

     * @since S60 v5.0

     */

    void DoCancel();

    /**

     * Handles an active object's request completion event.

     *

     * @since S60 v5.0

     */

    void RunL();

    /**

     * Creates image decoder to be used.

     *

     * @since S60 v5.0

     */

    void CreateDecoderL();

private:

    // data

    /**

     * Requested size.

     */

    TSize iSize;

    /**

     * Image decoder.

     * Own.

     */

    CImageDecoder* iDecoder;

    /**

     * Decoded bitmap.

     * Own.

     */

    CFbsBitmap* iBitmap;

    /**

     * Image info flags (from TFrameInfo)

     */

    TUint32 iFrameInfoFlags;

    /**

     * Original size of the image in pixels.

     */

    TSize iOriginalSize;

    /**

     * Used fileserver.

     */

    RFs& iFs;

    /**

     * Buffer from which thumbnail is to be created.

     */    

    const TDesC8* iBuffer;

    /**

     * Observer.

     */

    MThumbnailProviderObserver* iObserver; // not own

    /**

     * Mime-type.

     */

    TDataType iMimeType;

};

#endif // THUMBNAILIMAGEDECODERV3_H