imagehandlingutilities/thumbnailmanager/thumbnailserver/inc/thumbnailgeneratetask.h
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/imagehandlingutilities/thumbnailmanager/thumbnailserver/inc/thumbnailgeneratetask.h Tue Jan 26 15:18:05 2010 +0200
@@ -0,0 +1,233 @@
+/*
+* Copyright (c) 2006-2007 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: Task for generating new thumbnails
+*
+*/
+
+
+#ifndef THUMBNAILGENERATETASK_H
+#define THUMBNAILGENERATETASK_H
+
+#include <apmstd.h>
+
+#include "thumbnailtask.h"
+#include "thumbnailprovider.h"
+#include "thumbnailstore.h" // TThumbnailPersistentSize
+
+class CThumbnailServer;
+
+/**
+ * Task for generating new thumbnails.
+ *
+ * @since S60 v5.0
+ */
+class CThumbnailGenerateTask: public CThumbnailTask,
+ public MThumbnailProviderObserver
+ {
+public:
+
+ /**
+ * C++ default constructor
+ *
+ * @since S60 v5.0
+ * @param aProcessor Processor object for running tasks.
+ * @param aServer Thumbnail server in use.
+ * @param aFile File from which the thumbnail is to be created.
+ * @param aFlags Flags that control the creation of thumbnail.
+ * @param aSize Requested size of thumbnail.
+ * @param aDisplayMode Display mode.
+ * @param aPriority Priority of the request.
+ * @return New CThumbnailGenerateTask object.
+ */
+ CThumbnailGenerateTask( CThumbnailTaskProcessor& aProcessor, CThumbnailServer& aServer,
+ RFile64* aFile, TDesC8* aBuffer, const TDataType* aMimeType,
+ CThumbnailManager::TThumbnailFlags aFlags, const TSize& aSize,
+ TDisplayMode aDisplayMode, TInt aPriority,
+ RArray < TThumbnailPersistentSize >* aMissingSizes, const TDesC& aTargetUri,
+ TThumbnailSize aThumbnailSize, const TThumbnailId aThumbnailId,
+ const CThumbnailManager::TThumbnailQualityPreference aQualityPreference );
+
+ /**
+ * Destructor.
+ *
+ * @since S60 v5.0
+ */
+ virtual ~CThumbnailGenerateTask();
+
+ /**
+ * StartL
+ *
+ * @since S60 v5.0
+ */
+ void StartL();
+
+ /**
+ * Handles an active object's request completion event.
+ *
+ * @since S60 v5.0
+ */
+ void RunL();
+
+ /**
+ * Implements cancellation of an outstanding request.
+ *
+ * @since S60 v5.0
+ */
+ void DoCancel();
+
+ /**
+ * Defines if scaled bitmaps needs to be added to pool.
+ *
+ * @since S60 v5.0
+ * @param aBool boolean
+ */
+ void ScaledBitmapToPool(TBool aBool);
+
+private:
+
+ /**
+ * Calculate the largest non-cropped size and largest cropped size and
+ * let the provider know.
+ *
+ * @since S60 v5.0
+ * @param aEffectiveTargetSize Effective target size.
+ * @param aCroppedTargetSize Cropped target size.
+ */
+ void CalculateTargetSizesL( TSize& aEffectiveTargetSize, TSize&
+ aCroppedTargetSize );
+
+ /**
+ * For notifying when task has been finished.
+ *
+ * @since S60 v5.0
+ * @param aError Error code.
+ * @param aBitmap Thumbnail image.
+ * @param aOriginalSize Original image size.
+ * @param aEXIF is origin EXIF.
+ */
+ void ThumbnailProviderReady( const TInt aError, CFbsBitmap* aBitmap, const
+ TSize& aOriginalSize, const TBool aEXIF, const TBool aPortrait );
+
+ /**
+ * For creating scaling task.
+ *
+ * @since S60 v5.0
+ * @param aBitmap Bitmap image.
+ * @param aEXIF is origin EXIF.
+ */
+ void CreateScaleTasksL( CFbsBitmap* aBitmap );
+
+ /**
+ * For creating blacklisted thumbnail.
+ *
+ * @param aOriginalSize Original size of bitmap.
+ */
+ void CreateBlackListedL( const TSize& aOriginalSize );
+
+private:
+ // Data
+
+ /**
+ * Server.
+ */
+ CThumbnailServer& iServer;
+
+ /**
+ * Imagefile from which the thumbnail is to be created.
+ */
+ RFile64 iFile;
+
+ /**
+ * Image buffer
+ */
+ TDesC8* iBuffer;
+
+ /**
+ * Mime type of the original image.
+ */
+ TDataType iMimeType;
+
+ /**
+ * Filename of the image from which the thumbnail is to be created.
+ */
+ TFileName iFilename;
+
+ /**
+ * Flags
+ */
+ CThumbnailManager::TThumbnailFlags iFlags;
+ /**
+ * Requested size of thumbnail.
+ */
+ TSize iSize;
+
+ /**
+ * Display mode.
+ */
+ TDisplayMode iDisplayMode;
+
+ /**
+ * Only missing persistent sized thumbnails will be created
+ */
+ RArray < TThumbnailPersistentSize >* iMissingSizes;
+
+ /**
+ * Uri of the target object
+ */
+ TFileName iTargetUri;
+
+ /**
+ * Relative thumbnail size
+ */
+ TThumbnailSize iThumbnailSize;
+
+
+ /**
+ * Size of the original image.
+ */
+ TSize iOriginalSize;
+
+ /**
+ * Refers to a bitmap in the bitmap pool owned by server. Must be deleted
+ * using CThumbnailServer::DeleteBitmapFromPool() to make reference
+ * counting work.
+ * Not own.
+ */
+ CFbsBitmap* iBitmap;
+
+ /**
+ * Thumbnail provider implementation.
+ * Not own.
+ */
+ CThumbnailProvider* iProvider;
+
+ TThumbnailId iThumbnailId;
+
+ TBool iScaledBitmapToPool;
+
+#ifdef _DEBUG
+ TTime aStart, aStop;
+#endif
+
+ CThumbnailManager::TThumbnailQualityPreference iQualityPreference;
+
+ TBool iEXIF;
+
+ /**
+ * Target rect rotated (portrait image)
+ */
+ TBool iPortrait;
+};
+
+#endif // THUMBNAILGENERATETASK_H