imagehandlingutilities/thumbnailmanager/thumbnailserver/inc/thumbnailgeneratetask.h
changeset 0 2014ca87e772
child 5 82749d516180
child 14 2edacbf5d3f9
--- /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