/*
* 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 Image Viewer class.
*
*/


#ifndef CIHLIMAGEVIEWEREXTJPG_H
#define CIHLIMAGEVIEWEREXTJPG_H

// INCLUDES
#include "MIHLImageViewer.h"
#include <e32base.h>

//FORWARD DECLARATIONS
class MIHLFileImageExtJpg;
class MIHLBitmap;
class MIHLViewerObserver;
class CIHLBitmap;
class CIHLBitmapProcessor;

// CLASS DECLARATION
/**
*  CIHLImageViewer
*
*  Image Viewer implementation class.
*  @lib IHL.lib
*  @since 3.0
*/
NONSHARABLE_CLASS( CIHLImageViewerExtJpg ) : public CTimer, public MIHLImageViewer
    {
    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
        */
        static CIHLImageViewerExtJpg* NewL( const TSize& aViewerSize,
									  MIHLFileImageExtJpg& aSource,
									  MIHLBitmap& aDestination,
									  MIHLViewerObserver& aObserver,
									  const TUint32 aOptions );

        /*
        * Virtual destructor.
        */
        virtual ~CIHLImageViewerExtJpg();

	public: // From base class MIHLViewer
		
		  /*
        * From MIHLViewer, see base class header.
        */
		TIHLInterfaceType Type() const;
		
	public:
	
		/*
        * From MIHLImageViewer, see base class header.
        */
		TBool IsAnimation() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		void Play();

        /*
        * From MIHLImageViewer, see base class header.
        */
		void Stop();

        /*
        * From MIHLImageViewer, see base class header.
        */
		TBool IsPlaying() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt AnimationFrameCount() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt AnimationFrame() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetAnimationFrame( TInt aFrameIndex );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetViewerSize( const TSize& aViewerSize, TInt srcBitmapScaleFactor = 1 );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TSize ViewerSize() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt MoveSourceRect( TInt aDx, TInt aDy );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetSourceRectPosition( const TPoint& aPosition );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TRect SourceRect() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TSize SourceSize() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetZoomRatio( TReal aZoomRatio );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TReal ZoomRatio() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TReal ZoomToFitRatio() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt RotateClockwise();

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt RotateCounterClockwise();

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetRotationAngle( TInt aRotationAngle );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt RotationAngle() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetVerticalMirroring( TBool aValue );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TBool VerticalMirroring() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		TInt SetHorizontalMirroring( TBool aValue );

        /*
        * From MIHLImageViewer, see base class header.
        */
		TBool HorizontalMirroring() const;

        /*
        * From MIHLImageViewer, see base class header.
        */
		void SetFilter( MIHLFilter* aFilter );

	public: 

      

	public: // From base class CTimer
		
		/*
        * From CTimer, see base class header.
        */
		void DoCancel();

        /*
        * From CTimer, see base class header.
        */
		void RunL();

        /*
        * From CTimer, see base class header.
        */
		TInt RunError( TInt aError );
      

	private: // Private methods

        /*
        * Start asynchronous processing with new settings.
        * This is needed always when settings are changed.
        */
		TInt ApplySettings();

        /*
        * Start load process source bitmap.
        */
		TInt AsyncLoad();

        /*
        * Finish processing and notify client.
        */
		TInt Finish();

        /*
        * Complete dummy request. This causes RunL() method to be called.
        * Needed by state machine.
        */
		void SelfComplete();

        /*
        * Calculate source bitmap rectangle needed by processor.
        * Rectangle is affected by rotating and mirroring settings etc.
        */
		TRect CalculateProcessSourceRect( const TSize& aSourceCacheSize );

        /*
        * Calculate destination bitmap rectangle needed by processor.
        * Rectangle is affected by rotating and mirroring settings etc.
        */
		TRect CalculateProcessDestinationRect();

        /*
        * Calculate needed zoomratio for "fit-to-screen" zooming.
        */
		void CalculateZoomToFitRatio();

        /*
        * Calculate source bitmap rectangle and destination bitmap size.
        * These values needs to be recalculated when rectangle setting is changed.
        */
		void CalculateSourceRectAndDestinationSize();

        /*
        * Assert if source bitmap rectangle and destination bitmpa size are valid.
        * This method is called by CalculateSourceRectAndDestinationSize()
        */
#ifdef _DEBUG
		void AssertSourceRectAndDestinationSize();
#endif

	private: // Private constructors

        void ConstructL();
        CIHLImageViewerExtJpg( const TSize& aViewerSize,
						 MIHLFileImageExtJpg& aSource,
						 MIHLBitmap& aDestination,
						 MIHLViewerObserver& aObserver,
						 const TUint32 aOptions );

	private: // Private data types

		enum TViewerState
			{
			EInactive,
			ELoad,
			EProcess
			};

	private: // Data

		// Viewer state
		TViewerState iViewerState;

		// Ref: Observers
		MIHLViewerObserver& iObserver;

		// Ref: Viewer source image
		MIHLFileImageExtJpg& iSource;
		TSize iSourceSize;
		TRect iSourceRect;

		// Ref: Viewer destination bitmap
		MIHLBitmap& iDestination;
		TSize iDestinationSize;

		// Viewing settings
		const TUint32 iOptions;
		TSize iViewerSize;
		TReal iZoomRatio;
		TReal iZoomToFitRatio;
		TInt iRotationAngle;
		TBool iVerticalMirroring;
		TBool iHorizontalMirroring;

		// Decoder capabilities
		TInt iCapabilities;
		
		// Internal processor flag
		TBool iInternalProcessingNeeded;
	
		// Own: Bitmap caches
		CIHLBitmap* iCacheSource;
		CIHLBitmap* iCacheDestination;
		// Own: Bitmap processor
		CIHLBitmapProcessor* iProcessor;
		// src bitmap scale factor
		TInt iSrcBitmapScaleFactor;

    };

#endif // CIHLIMAGEVIEWEREXTJPG_H

// End of File