/*
* Copyright (c) 2002 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:  Still Image Decoder for Camera Application Engine
*
*/



#ifndef CAESTILLDECODER_H
#define CAESTILLDECODER_H

// INCLUDES
#include <e32base.h>
#include <s32file.h>
#include <imageconversion.h>
#include <ecam.h>


// CLASS DECLARATION

/**
*  Still decoder observer class.
*  User of CCaeStillDecoder class must derive from this interface.
*
* @lib CAESTILLCONVERTER.LIB
* @since 2.1
*/
class MCaeStillDecoderObserver
    {
    public:
        /**
        * Called back by CCaeStillDecoder when it completes conversion (decoding) to CFbsBitmap image.
        * @since 2.1
        * @param aImageData Source image (as JPEG)
        * @param aBitmap Converted Symbian OS bitmap image
        * @param aError Error code KErrNone to indicate success or a standard Symbian OS error code
        * @param aImageSize Decoded image size
        * @return void
        */
        virtual void McaesdoCFbsBitmapImageReady( 
            HBufC8* aImageData, 
            CFbsBitmap* aBitmap, 
            TInt aError,
            TInt aImageSize ) = 0;
    };


// CLASS DECLARATION

/**
* Still Decoder class.
* Implements still image decoding for Camera Application Engine 
* using Symbian Image Conversion Library (ICL)
*
* @lib CAESTILLCONVERTER.LIB
* @since 2.1
*/
NONSHARABLE_CLASS( CCaeStillDecoder ) : public CCaeStillConverter
    {
    public:  // Constructor and destructor    
        /**
        * Two-phased constructor.
        */
        IMPORT_C static CCaeStillDecoder* NewL();

        /**
        * Destructor.
        */
        IMPORT_C virtual ~CCaeStillDecoder();

    public: // From CCaeStillConverter:

        void SetImageCodecL( 
        	TUid aCodecUid );
        	
    public: // New functions
        /**
        * Sets Still Decoder observer.
        * @since 2.1
        * @param aObserver Still Decoder observer
        * @return void
        */
        IMPORT_C void SetObserver( 
            MCaeStillDecoderObserver* aObserver );

        /** 
        * Creates the CImageItem object, places it in the internal queue and 
        * starts the memory image conversion where the memory image (e.g. JPEG) 
        * is converted to bitmap. 
        * @param aImageBuffer Memory image to convert. Ownership is given.
        * @param aTargetBitmapMode Target/destination bitmap color mode
        * @param aTargetBitmapSize Target/destination bitmap size without free scaling decoder
        * @param aFullyScaledTargetBitmapSize Target/destination bitmap size with free scaling decoder
        * @return void
        */
        IMPORT_C void ConvertHBufC8ToCFbsBitmapL( 
            HBufC8* aImageBuffer,
            TDisplayMode aTargetBitmapMode,
            const TSize& aTargetBitmapSize,
            const TSize& aFullyScaledTargetBitmapSize = TSize( 0, 0 ) );

        /**
        * Destroys all allocations for decoding, as the images from the queue.
        * @return void
        */
        IMPORT_C void Cleanup();

    protected: // Constructors
        /**
        * C++ constructor.
        */
        CCaeStillDecoder();

        /**
        * Symbian 2nd phase constructor that can leave.
        */
        void ConstructL();

    private: // From CCaeStillConverter:
        
        /**
        * From CActive, implements cancellation of an outstanding request.
        * @return void
        */
        void DoCancel();

    protected: // From CCaeStillConverter
        
        void ConvertL();
   
        void ConversionComplete( 
            TInt aError );

    private: // Data

        // Still Decoder observer.
        MCaeStillDecoderObserver* iObserver;

        // Pointer to ICL decoder object.
        CImageDecoder* iDecoder;

        // Pointer to decoded image.
        CFbsBitmap* iDecodedImage;

        // Class wide file server handle for file operations
        RFs iFs;
    };


#endif // CAESTILLDECODER_H   


// End of File