williamr@4: // Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@4: // All rights reserved.
williamr@4: // This component and the accompanying materials are made available
williamr@4: // under the terms of "Eclipse Public License v1.0"
williamr@4: // which accompanies this distribution, and is available
williamr@4: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@4: //
williamr@4: // Initial Contributors:
williamr@4: // Nokia Corporation - initial contribution.
williamr@4: //
williamr@4: // Contributors:
williamr@4: //
williamr@4: // Description:
williamr@4: //
williamr@4: 
williamr@4: /**
williamr@4:  @file
williamr@4:  @publishedAll 
williamr@4:  @released 
williamr@4: */
williamr@4: 
williamr@4: #ifndef __IMAGE_PROCESSOR_OVERLAY_H__
williamr@4: #define __IMAGE_PROCESSOR_OVERLAY_H__
williamr@4: 
williamr@4: #include <e32base.h>
williamr@4: #include <gdi.h>
williamr@4: 
williamr@4: class CFbsBitmap;
williamr@4: class CImageFrame;
williamr@4: class RFile;
williamr@4: class TMMSource;
williamr@4: 
williamr@4: namespace ImageProcessor
williamr@4: 	{
williamr@4: 
williamr@4: class CImageProcessorImpl;
williamr@4: class CImageProcessorDrmInput;
williamr@4: 	
williamr@4: namespace Plugin
williamr@4: 	{
williamr@4: 	class MOverlay;
williamr@4: 	}
williamr@4: 
williamr@4: /**
williamr@4: This class provides image overlay functionality.
williamr@4: 
williamr@4: Before overlay effects are applied, SetInputL should be called to specify the input overlay image.
williamr@4: 
williamr@4: The overlay effect can be applied by:
williamr@4: 
williamr@4: -# Begin overlay by calling BeginL(). 
williamr@4: -# Adjust overlay parameters (optional) by calling SetL(aSize, aPosition, aAngle), possibly several times.
williamr@4: -# Signal final placement of overlay by calling EndL(). 
williamr@4: 	.
williamr@4: 
williamr@4: Between step 1 and 3, no other effects or operations may be carried out i.e. the overlay has to be 
williamr@4: concluded/ended before proceeding to apply other effects.
williamr@4: 
williamr@4: @publishedAll
williamr@4: @released
williamr@4: */
williamr@4: class TOverlay
williamr@4: 	{
williamr@4: public:
williamr@4: 	IMPORT_C void SupportedInputFormatsL(RArray<TUid>& aFormats) const;
williamr@4: 	IMPORT_C void SupportedInputSubFormatsL(TUid aFormat, RArray<TUid>& aSubFormats) const;
williamr@4: 	IMPORT_C void SupportedInputImageFrameFormatsL(RArray<TUid>& aFormats) const;
williamr@4: 	IMPORT_C void SupportedInputDisplayModesL(RArray<TDisplayMode>& aDisplayModes) const;
williamr@4: 	
williamr@4: 	IMPORT_C void SetInputL(const TDesC& aFilename, const TUid& aFormat = KNullUid, const TUid& aSubFormat = KNullUid);
williamr@4: 	IMPORT_C void SetInputL(RFile& aFile, const TUid& aFormat = KNullUid, const TUid& aSubFormat = KNullUid);
williamr@4: 	IMPORT_C void SetInputL(TMMSource& aDrmFile, const TUid& aFormat = KNullUid, const TUid& aSubFormat = KNullUid);
williamr@4: 	IMPORT_C void SetInputL(const TDesC8& aBuffer, const TUid& aFormat = KNullUid, const TUid& aSubFormat = KNullUid);
williamr@4: 	IMPORT_C void SetInputL(const CFbsBitmap& aBitmap, const CFbsBitmap* aMask = NULL);
williamr@4: 	IMPORT_C void SetInputL(const CImageFrame& aPixelBuffer);
williamr@4: 
williamr@4: 	IMPORT_C void BeginL();
williamr@4: 	IMPORT_C void SetL(const TSize &aSize, const TPoint &aPosition = TPoint(0,0), TReal32 aAngle = 0);
williamr@4: 	IMPORT_C void SetL(TReal32 aScaleX = 1.0, TReal32 aScaleY = 1.0, const TPoint &aPosition = TPoint(0,0), TReal32 aAngle = 0);
williamr@4: 	IMPORT_C void EndL();
williamr@4: 	IMPORT_C void ResetL();
williamr@4: 	
williamr@4: 	IMPORT_C TPoint	PositionL() const;
williamr@4: 	IMPORT_C TSize	SizeL() const;
williamr@4: 	IMPORT_C TReal32 AngleL() const;
williamr@4: 	IMPORT_C void GetScaleL(TReal32& aScaleX, TReal32& aScaleY) const;
williamr@4: 		
williamr@4: private:
williamr@4: 	friend class CImageProcessorImpl;
williamr@4: 	TOverlay(Plugin::MOverlay& aOverlayImpl, CImageProcessorImpl& aImageProcessorImpl);
williamr@4: 	
williamr@4: 	TBool iIsActive;
williamr@4: 	TBool iIsInputSet;
williamr@4: 
williamr@4: 	CImageProcessorImpl& iImageProcessorImpl;
williamr@4: 	Plugin::MOverlay& iOverlayImpl;
williamr@4: 	TInt iReserved; // future proof
williamr@4: 	};
williamr@4: 
williamr@4: 	}
williamr@4: 
williamr@4: #endif //__IMAGE_PROCESSOR_PREVIEW_H__