/*
* 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:  Pure virtual interface for file based external jpg image class.
*              : This class acts as a window into single image or animation
*              : in one physical file. Note that file will be locked as long
*              : as instance of this class is present.
*
*/


#ifndef MIHLFILEIMAGEEXTJPG_H
#define MIHLFILEIMAGEEXTJPG_H

// INCLUDES
#include <MIHLFileImage.h>
#include <gdi.h>

// FORWARD DECLARATION
class MIHLBitmap;
class MIHLFilter;
class CVisualFrame;

// CLASS DECLARATION
/**
*  MIHLFileImageExtJpg
*
*  Pure virtual interface for file based image class that uses IclExtJpegApi.
*  This class acts as a window into single image or animation
*  in one physical file. Note that file will be locked as long
*  as instance of this class is present.
*
*  If interface needs to be pushed into CleanupStack,
*  remember to use CleanupDeletePushL() function!
*  DO NOT USE CleanupStack::PushL()!!
*
*  @lib IHL.lib
*  @since 3.0
*/
class MIHLFileImageExtJpg : public MIHLFileImage
    {
	public:

        /**
        * Virtual destructor.
		*/
		virtual ~MIHLFileImageExtJpg() {}

	public:
		/**
        * Load part of the image into bitmap.	
        * @since 3.0
        * @param aSrcRect Part of the picture to be loaded
        * @param aStatus Load request status reference.
		* @param aDestination Destination bitmap reference.
		* @param aFrameIndex frame index for loading single frame from image
		* @return Return system wide error codes:
		*         KerrArgument if given bitmap is not created or it's size is incorrect.
		*         KErrBusy image has load request pending already.
		*/
		virtual TInt Load( TRect aSrcRect, TRequestStatus& aStatus, MIHLBitmap& aDestination, TInt aFrameIndex = 0 ) = 0;
	
	public:	//CExtJpegDecoder wrapper, see IclExtJpegApi.h
	
		virtual void SetCroppingL( TRect aCropRect ) = 0;

        virtual void SetStreamingL( TSize& aMacroBlockSize ) = 0;

        virtual void SetRotationL( TInt aDegree ) = 0;

        virtual void SetFlippingL() = 0;

        virtual void SetMirroringL() = 0;
        
        virtual void SetDctDecodingL() = 0;
        
        virtual void ConvertL( 
                        TRequestStatus* aRequestStatus, 
                        const CVisualFrame* aDestinationFrame, 
                        TInt& aNoOfDecodedMBlocks,
                        TInt aFrameNumber = 0 ) = 0;

        virtual void ContinueConvertL( 
                        TRequestStatus* aRequestStatus, 
                        const CVisualFrame* aDestinationFrame, 
                        TInt& aNoOfDecodedMBlocks,
                        TInt aFrameNumber = 0 ) = 0;

        virtual TInt SupportedFormatsL() = 0;

        virtual TInt CapabilitiesL() = 0;


	};
#endif