/*

* Copyright (c) 2006 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:  Implementation of ImageFile class.

*

*/

#ifndef CIHLFILEIMAGEEXTJPG_H

#define CIHLFILEIMAGEEXTJPG_H

// INCLUDES

#include <e32base.h>

#include <imageconversion.h> // TFrameInfo

#include <gdi.h> // TDisplayMode

#include "MIHLFileImageExtJpg.h"

// FORWARD DECLARATIONS

class MIHLBitmap;

class CIHLBitmap;

class CExtJpegDecoder;

class CVisualFrame;

// CLASS DECLARATION

/**

*  CIHLFileImageExtJpg

*

*  Implementation of file based ext jpg image class.

*  @lib IHL.lib

*  @since 3.0

*/

NONSHARABLE_CLASS( CIHLFileImageExtJpg ) : public CActive, public MIHLFileImageExtJpg

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CIHLFileImageExtJpg* NewL( RFs& aFs, const TDesC8& aDataBuf,

                                    TInt aImageIndex, const TUint32 aOptions );

		static CIHLFileImageExtJpg* NewL( RFs& aFs, const TDesC& aFilename,

                                    TInt aImageIndex, const TUint32 aOptions );

        /*

        * Virtual destructor.

        */

        virtual ~CIHLFileImageExtJpg();

	public: // From base class MIHLImage

		TIHLInterfaceType Type() const;        

	public: // From base class MIHLFileImage

		/*

        * From MIHLFileImage, see base class header.

        */

		const TUid& ImageType() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		const TUid& ImageSubType() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TInt ImageIndex() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TInt ImageCount() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TSize Size() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TDisplayMode DisplayMode() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TDisplayMode MaskDisplayMode() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TRgb BackgroundColor() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		const RArray<TSize>& CustomLoadSizeArray() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TBool IsFullyScaleable() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TBool IsAnimation() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TInt AnimationFrameCount() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TTimeIntervalMicroSeconds32 AnimationFrameDelay( TInt aAnimationFrameIndex ) const;

        /*

        * From MIHLFileImage, see base class header.

        */

		TInt Load( TRequestStatus& aStatus, MIHLBitmap& aDestination, TInt aFrameIndex = 0 );

        /*

        * From MIHLFileImage, see base class header.

        */

		TInt LoadAnimation( TRequestStatus& aStatus, MIHLBitmap& aDestination, TInt aAnimationFrameIndex );

        /*

        * From MIHLFileImage, see base class header.

        */

		TBool IsBusy() const;

        /*

        * From MIHLFileImage, see base class header.

        */

		void CancelLoad();

        /*

        * From MIHLFileImage, see base class header.

        */

		void SetFilter( MIHLFilter* aFilter );

	public: // From MIHLFileImageExtJpg

		/*

        * From MIHLFileImageExtJpg, see base class header.

        */

		TInt Load( TRect aSrcRect, TRequestStatus& aStatus, MIHLBitmap& aDestination, TInt aFrameIndex = 0 );

		/*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void SetCroppingL( TRect aCropRect );

		/*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void SetStreamingL( TSize& aMacroBlockSize );

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void SetRotationL( TInt aDegree );

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void SetFlippingL();

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void SetMirroringL();

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void SetDctDecodingL();

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void ConvertL( 

                        TRequestStatus* aRequestStatus, 

                        const CVisualFrame* aDestinationFrame, 

                        TInt& aNoOfDecodedMBlocks,

                        TInt aFrameNumber = 0 );

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        void ContinueConvertL( 

                        TRequestStatus* aRequestStatus, 

                        const CVisualFrame* aDestinationFrame, 

                        TInt& aNoOfDecodedMBlocks,

                        TInt aFrameNumber = 0 );

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        TInt SupportedFormatsL();

        /*

        * From MIHLFileImageExtJpg, see base class header.

        */

        TInt CapabilitiesL();

	private: // From base class CActive

        /*

        * From CActive, see base class header.

        */

		void DoCancel();

        /*

        * From CActive, see base class header.

        */

		void RunL();

        /*

        * From CActive, see base class header.

        */

		TInt RunError( TInt aError );

	public: // Internal interface

        /**

        * Return reference to used CExtJpegDecoder instance.

		* For internal use.

        * @since 3.0

		* @return Reference to used CExtJpegDecoder instance.

		*/

		const CExtJpegDecoder& Decoder() const;

	private: // Private methods

        /*

        * Request load and start ActiveScheduler.

        * Called from Load() and LoadAnimation() methods.

        */

		TInt LoadRequest( TRequestStatus& aStatus, MIHLBitmap& aDestination, TInt aFrameIndex );

        /*

        * Start loading from file. Checks if image is still or animation.

        * Called by ActiveSheduler when state is EStartLoad.

        */

		void StartLoadL();

        /*

        * Loading complete. Build possible animation and notify client.

        * Called by ActiveSheduler when state is ECompleteLoad.

        */

		void CompleteLoadL();

        /*

        * Error cleanup. Called if error occurs during load.

        */

		void ErrorCleanup();

        /*

        * Complete dummy request. This causes RunL() method to be called.

        * Needed by state machine.

        */

		void SelfComplete();

        /*

        * Complete client load request.

        * This causes client RunL() method to be called.

        */

		void RequestComplete( TInt aReason );

	private: // Private constructors

        CIHLFileImageExtJpg( TInt aImageIndex );

        void ConstructL( RFs& aFs, const TDesC& aFilename, const TUint32 aOptions );

        void ConstructL( RFs& aFs, const TDesC8& aDataBuf, const TUint32 aOptions );

        void ConstructCommonL();

	private: // Private data types

		enum TImageState

			{

			EInactive,

			EStartLoad,

			ECompleteLoad,

			};

	private: // Data

		// Ref: Image status & state

		TRequestStatus* iImageStatus;

		TImageState iImageState;

		// Own: Image decoder

		CExtJpegDecoder* iDecoder;

		// Image information

		TUid iImageType;

		TUid iImageSubType;

		TInt iImageIndex;

		TInt iImageCount;

		TBool iFullyScaleable;

		TFrameInfo iFrameInfo;

		TBool iAnimation;

		TInt iAnimationFrameCount;

		// Ref: Destination bitmap

		CIHLBitmap* iDestination;

		TInt iFrameIndex;

		RArray<TSize> iLoadSizeArray;

    };

#endif   // CIHLFILEIMAGEEXTJPG_H

// End of File