williamr@2: // Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: // This feature is documented in ICL_Design_EXIF.doc
williamr@2: // 
williamr@2: //
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2:  @file
williamr@2:  @publishedAll
williamr@2:  @released
williamr@2: */
williamr@2: 
williamr@2: #ifndef ICLEXIFIMAGEFRAME_H
williamr@2: #define ICLEXIFIMAGEFRAME_H
williamr@2: 
williamr@2: #include <imageconversion.h>
williamr@2: #include <icl/imageplugin.h>
williamr@2: #include <iclexif.h>
williamr@2: #include "imageframe.h"
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: This class provides access to an extension of the EXIF JPEG decoder that supports
williamr@2: decoding of JPEG images held either in files or in descriptors to a destination of type CImageFrame.
williamr@2: 
williamr@2: This is an addition to the features provided by CJPEGExifDecoder.
williamr@2: */
williamr@2: 
williamr@2: class CJPEGImageFrameDecoder : public CJPEGExifDecoder
williamr@2: 	{
williamr@2: public:
williamr@2: 	IMPORT_C static CJPEGImageFrameDecoder* NewL();
williamr@2: 	IMPORT_C ~CJPEGImageFrameDecoder();
williamr@2: 
williamr@2: 	IMPORT_C void ConvertFrame(TRequestStatus* aRequestStatus, CImageFrame& aDestFrame);
williamr@2: 	IMPORT_C void ConvertFrame(TRequestStatus* aRequestStatus, CImageFrame& aDestFrame, TInt aFrameNumber);
williamr@2: 	IMPORT_C void ContinueConvertFrame(TRequestStatus* aRequestStatus);
williamr@2: 
williamr@2: 	IMPORT_C TBool RecommendedBufferSize(TUid aFormatCode, TInt& bufferSize);
williamr@2: 	IMPORT_C TBool RecommendedBufferSize(TInt& bufferSize);
williamr@2: 
williamr@2: protected:
williamr@2: 	IMPORT_C CJPEGImageFrameDecoder();
williamr@2: 	};
williamr@2: 
williamr@2: /**
williamr@2: This class provides access to an extension of the EXIF JPEG encoder that supports
williamr@2: encoding JPEG images from a source of type CImageFrame to either a file or a descriptor. 
williamr@2: 
williamr@2: This is an addition to the features provided by CJPEGExifEncoder.
williamr@2: */
williamr@2: 
williamr@2: class CJPEGImageFrameEncoder : public CJPEGExifEncoder
williamr@2: 	{
williamr@2: public:
williamr@2: 	IMPORT_C static CJPEGImageFrameEncoder* NewL();
williamr@2: 	IMPORT_C ~CJPEGImageFrameEncoder();
williamr@2: 
williamr@2: 	IMPORT_C void ConvertFrame(TRequestStatus* aRequestStatus, const CImageFrame& aSrcFrame);
williamr@2: 	IMPORT_C void ConvertFrame(TRequestStatus* aRequestStatus, const CImageFrame& aSrcFrame, const CFrameImageData* aFrameImageData);
williamr@2: 
williamr@2: protected:
williamr@2: 	IMPORT_C CJPEGImageFrameEncoder();
williamr@2: 	};
williamr@2: 	
williamr@2: 
williamr@2: /**
williamr@2: This is the plugin API for Image Converter Library decoder plugins relating to CImageFrames.
williamr@2: 
williamr@2: It is an extension of the ICL EXIF decoder plugin which provides a container for specific
williamr@2: data required to decode a JPEG file or descriptor to a destination of type CImageFrame.
williamr@2: */
williamr@2: class CJPEGImageFrameDecoderPlugin : public CJPEGExifDecoderPlugin
williamr@2: 	{
williamr@2: public:
williamr@2: 	IMPORT_C ~CJPEGImageFrameDecoderPlugin();
williamr@2: 	IMPORT_C CImageFrame& DstImageFrame();
williamr@2: 	IMPORT_C TInt FrameNumber() const;
williamr@2: 	IMPORT_C TUid FormatCode() const;
williamr@2: 	IMPORT_C void SetRecommendedBufferSize(TInt aBufferSize);
williamr@2: 
williamr@2: 	void SetConvertParameters(CImageFrame& aDestFrame, TInt aFrameNumber);
williamr@2: 	void SetFormatCode(TUid aFormatCode);
williamr@2: 	TInt RecommendedBufferSize();
williamr@2: 
williamr@2: protected:
williamr@2: 	IMPORT_C CJPEGImageFrameDecoderPlugin();
williamr@2: 
williamr@2: private:
williamr@2: 	// reserved for future expansion
williamr@2: 	IMPORT_C virtual void Reserved1();
williamr@2: 	IMPORT_C virtual void Reserved2();
williamr@2: 	IMPORT_C virtual void Reserved3();
williamr@2: 	
williamr@2: private:
williamr@2: 	CImageFrame* iDstImageFrame;
williamr@2: 	TInt iFrameNumber;
williamr@2: 	TUid iFormatCode;		
williamr@2: 	TInt iRecommendedBufferSize;
williamr@2: 
williamr@2: 	TAny* iReserved;
williamr@2: 	};
williamr@2: 
williamr@2: /**
williamr@2: This is the plugin API for Image Converter Library encoder plugins relating to CImageFrames. 
williamr@2: 
williamr@2: It is an extension of the ICL EXIF encoder plugin which provides a container for specific
williamr@2: data required to encode image data from a source of type CImageFrame to a JPEG file or descriptor.
williamr@2: */
williamr@2: class CJPEGImageFrameEncoderPlugin : public CJPEGExifEncoderPlugin
williamr@2: 	{
williamr@2: public:
williamr@2: 	IMPORT_C ~CJPEGImageFrameEncoderPlugin();
williamr@2: 	IMPORT_C const CImageFrame& SrcImageFrame() const;
williamr@2: 	IMPORT_C const CFrameImageData& FrameImageData() const;
williamr@2: 
williamr@2: 	void SetConvertParameters(const CImageFrame& aSrcFrame, const CFrameImageData* aFrameImageData);
williamr@2: 
williamr@2: protected:
williamr@2: 	IMPORT_C CJPEGImageFrameEncoderPlugin();
williamr@2: 
williamr@2: private:
williamr@2: 	// reserved for future expansion
williamr@2: 	IMPORT_C virtual void Reserved1();
williamr@2: 	IMPORT_C virtual void Reserved2();
williamr@2: 	IMPORT_C virtual void Reserved3();
williamr@2: 		
williamr@2: private:
williamr@2: 	const CImageFrame* iSrcImageFrame;
williamr@2: 	const CFrameImageData* iFrameImageData;
williamr@2: 
williamr@2: 	TAny* iReserved;
williamr@2: 	};
williamr@2: 
williamr@2: #endif // ICLEXIFIMAGEFRAME_H