Apply premultiply in animated image visual
[platform/core/uifw/dali-toolkit.git] / dali-toolkit / internal / image-loader / image-load-thread.h
index c7d5d06..319f750 100644 (file)
@@ -2,7 +2,7 @@
 #define DALI_TOOLKIT_IMAGE_LOAD_THREAD_H
 
 /*
- * Copyright (c) 2020 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2021 Samsung Electronics Co., Ltd.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  */
 
 // EXTERNAL INCLUDES
-#include <dali/public-api/common/dali-vector.h>
-#include <dali/public-api/object/ref-object.h>
-#include <dali/public-api/images/image-operations.h>
+#include <dali-toolkit/devel-api/image-loader/async-image-loader-devel.h>
+#include <dali-toolkit/internal/visuals/visual-url.h>
+#include <dali/devel-api/adaptor-framework/event-thread-callback.h>
+#include <dali/devel-api/adaptor-framework/pixel-buffer.h>
 #include <dali/devel-api/threading/conditional-wait.h>
 #include <dali/devel-api/threading/mutex.h>
 #include <dali/devel-api/threading/thread.h>
-#include <dali/devel-api/adaptor-framework/event-thread-callback.h>
-#include <dali/devel-api/adaptor-framework/pixel-buffer.h>
-#include <dali-toolkit/internal/visuals/visual-url.h>
-#include <dali-toolkit/devel-api/image-loader/async-image-loader-devel.h>
 #include <dali/integration-api/adaptor-framework/log-factory-interface.h>
+#include <dali/public-api/common/dali-vector.h>
+#include <dali/public-api/images/image-operations.h>
+#include <dali/public-api/object/ref-object.h>
+#include <dali/public-api/adaptor-framework/encoded-image-buffer.h>
 
 namespace Dali
 {
-
 namespace Toolkit
 {
-
 namespace Internal
 {
-
 /**
  * The task of loading and packing an image into the atlas.
  */
@@ -49,10 +47,12 @@ struct LoadingTask
    * @param [in] id of the task
    * @param [in] animatedImageLoading The AnimatedImageLoading to load animated image
    * @param [in] frameIndex The frame index of a frame to be loaded frame
+   * @param [in] preMultiplyOnLoad ON if the image's color should be multiplied by it's alpha. Set to OFF if there is no alpha or if the image need to be applied alpha mask.
    */
-  LoadingTask( uint32_t id,
-               Dali::AnimatedImageLoading animatedImageLoading,
-               uint32_t frameIndex );
+  LoadingTask(uint32_t                                 id,
+              Dali::AnimatedImageLoading               animatedImageLoading,
+              uint32_t                                 frameIndex,
+              DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad);
 
   /**
    * Constructor.
@@ -64,13 +64,31 @@ struct LoadingTask
    * @param [in] orientationCorrection Reorient the image to respect any orientation metadata in its header.
    * @param [in] preMultiplyOnLoad ON if the image's color should be multiplied by it's alpha. Set to OFF if there is no alpha or if the image need to be applied alpha mask.
    */
-  LoadingTask( uint32_t id,
-               const VisualUrl& url,
-               ImageDimensions dimensions,
-               FittingMode::Type fittingMode,
-               SamplingMode::Type samplingMode,
-               bool orientationCorrection,
-               DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad );
+  LoadingTask(uint32_t                                 id,
+              const VisualUrl&                         url,
+              ImageDimensions                          dimensions,
+              FittingMode::Type                        fittingMode,
+              SamplingMode::Type                       samplingMode,
+              bool                                     orientationCorrection,
+              DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad);
+
+  /**
+   * Constructor.
+   * @param [in] id of the task
+   * @param [in] encodedImageBuffer The encoded buffer of the image to load.
+   * @param [in] size The width and height to fit the loaded image to, 0.0 means whole image
+   * @param [in] fittingMode The method used to fit the shape of the image before loading to the shape defined by the size parameter.
+   * @param [in] samplingMode The filtering method used when sampling pixels from the input image while fitting it to desired size.
+   * @param [in] orientationCorrection Reorient the image to respect any orientation metadata in its header.
+   * @param [in] preMultiplyOnLoad ON if the image's color should be multiplied by it's alpha. Set to OFF if there is no alpha or if the image need to be applied alpha mask.
+   */
+  LoadingTask(uint32_t                                 id,
+              const EncodedImageBuffer&                encodedImageBuffer,
+              ImageDimensions                          dimensions,
+              FittingMode::Type                        fittingMode,
+              SamplingMode::Type                       samplingMode,
+              bool                                     orientationCorrection,
+              DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad);
 
   /**
    * Constructor.
@@ -81,12 +99,12 @@ struct LoadingTask
    * @param [in] cropToMask Whether to crop the content to the mask size
    * @param [in] preMultiplyOnLoad ON if the image's color should be multiplied by it's alpha. Set to OFF if there is no alpha.
    */
-  LoadingTask( uint32_t id,
-               Devel::PixelBuffer pixelBuffer,
-               Devel::PixelBuffer maskPixelBuffer,
-               float contentScale,
-               bool cropToMask,
-               DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad );
+  LoadingTask(uint32_t                                 id,
+              Devel::PixelBuffer                       pixelBuffer,
+              Devel::PixelBuffer                       maskPixelBuffer,
+              float                                    contentScale,
+              bool                                     cropToMask,
+              DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad);
 
   /**
    * Load the image
@@ -104,47 +122,44 @@ struct LoadingTask
   void MultiplyAlpha();
 
 private:
-
   // Undefined
-  LoadingTask( const LoadingTask& queue );
+  LoadingTask(const LoadingTask& queue);
 
   // Undefined
-  LoadingTask& operator=( const LoadingTask& queue );
+  LoadingTask& operator=(const LoadingTask& queue);
 
 public:
-
-  Devel::PixelBuffer pixelBuffer;   ///< pixelBuffer handle after successful load
-                                    ///< or pixelBuffer to be masked image in the mask task
-  VisualUrl          url;           ///< url of the image to load
-  uint32_t           id;            ///< The unique id associated with this task.
-  ImageDimensions    dimensions;    ///< dimensions to load
-  FittingMode::Type  fittingMode;   ///< fitting options
-  SamplingMode::Type samplingMode;  ///< sampling options
-  bool               orientationCorrection:1; ///< if orientation correction is needed
-  DevelAsyncImageLoader::PreMultiplyOnLoad            preMultiplyOnLoad; //< if the image's color should be multiplied by it's alpha
-
-  bool isMaskTask;                  ///< whether this task is for mask or not
-  Devel::PixelBuffer maskPixelBuffer; ///< pixelBuffer of mask image
-  float contentScale;               ///< The factor to scale the content
-  bool cropToMask;                  ///< Whether to crop the content to the mask size
+  Devel::PixelBuffer pixelBuffer;                                     ///< pixelBuffer handle after successful load
+                                                                      ///< or pixelBuffer to be masked image in the mask task
+  VisualUrl                                url;                       ///< url of the image to load
+  EncodedImageBuffer                       encodedImageBuffer;        ///< encoded buffer of the image to load
+  uint32_t                                 id;                        ///< The unique id associated with this task.
+  ImageDimensions                          dimensions;                ///< dimensions to load
+  FittingMode::Type                        fittingMode;               ///< fitting options
+  SamplingMode::Type                       samplingMode;              ///< sampling options
+  bool                                     orientationCorrection : 1; ///< if orientation correction is needed
+  DevelAsyncImageLoader::PreMultiplyOnLoad preMultiplyOnLoad;         //< if the image's color should be multiplied by it's alpha
+
+  bool                       isMaskTask;      ///< whether this task is for mask or not
+  Devel::PixelBuffer         maskPixelBuffer; ///< pixelBuffer of mask image
+  float                      contentScale;    ///< The factor to scale the content
+  bool                       cropToMask;      ///< Whether to crop the content to the mask size
   Dali::AnimatedImageLoading animatedImageLoading;
-  uint32_t frameIndex;
+  uint32_t                   frameIndex;
 };
 
-
 /**
  * The worker thread for image loading.
  */
 class ImageLoadThread : public Thread
 {
 public:
-
   /**
    * Constructor.
    *
    * @param[in] mTrigger The trigger to wake up the main thread.
    */
-  ImageLoadThread( EventThreadCallback* mTrigger );
+  ImageLoadThread(EventThreadCallback* mTrigger);
 
   /**
    * Destructor.
@@ -158,7 +173,7 @@ public:
    *
    * @note This class takes ownership of the task object
    */
-  void AddTask( LoadingTask* task );
+  void AddTask(LoadingTask* task);
 
   /**
    * Pop the next task out from the completed queue.
@@ -170,7 +185,7 @@ public:
   /**
    * Remove the loading task from the waiting queue.
    */
-  bool CancelTask( uint32_t loadingTaskId );
+  bool CancelTask(uint32_t loadingTaskId);
 
   /**
    * Remove all the loading tasks in the waiting queue.
@@ -178,7 +193,6 @@ public:
   void CancelAll();
 
 private:
-
   /**
    * Pop the next loading task out from the queue to process.
    *
@@ -191,10 +205,9 @@ private:
    *
    * @param[in] task The task added to the queue.
    */
-  void AddCompletedTask( LoadingTask* task );
+  void AddCompletedTask(LoadingTask* task);
 
 protected:
-
   /**
    * The entry function of the worker thread.
    * It fetches loading task from the loadQueue, loads the image and adds to the completeQueue.
@@ -202,22 +215,20 @@ protected:
   void Run() override;
 
 private:
-
   // Undefined
-  ImageLoadThread( const ImageLoadThread& thread );
+  ImageLoadThread(const ImageLoadThread& thread);
 
   // Undefined
-  ImageLoadThread& operator=( const ImageLoadThread& thread );
+  ImageLoadThread& operator=(const ImageLoadThread& thread);
 
 private:
-
-  Vector< LoadingTask* > mLoadQueue;     ///<The task queue with images for loading.
-  Vector< LoadingTask* > mCompleteQueue; ///<The task queue with images loaded.
-  EventThreadCallback*   mTrigger;
+  Vector<LoadingTask*>             mLoadQueue;     ///<The task queue with images for loading.
+  Vector<LoadingTask*>             mCompleteQueue; ///<The task queue with images loaded.
+  EventThreadCallback*             mTrigger;
   const Dali::LogFactoryInterface& mLogFactory; ///< The log factory
 
-  ConditionalWait        mConditionalWait;
-  Dali::Mutex            mMutex;
+  ConditionalWait mConditionalWait;
+  Dali::Mutex     mMutex;
 };
 
 } // namespace Internal