dali-toolkit/internal/visuals/animated-image/image-cache.h

   1 #ifndef DALI_TOOLKIT_INTERNAL_IMAGE_CACHE_H
   2 #define DALI_TOOLKIT_INTERNAL_IMAGE_CACHE_H
   3
   4 /*
   5  * Copyright (c) 2022 Samsung Electronics Co., Ltd.
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  * http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  */
  19
  20 // EXTERNAL INCLUDES
  21 #include <dali-toolkit/internal/texture-manager/texture-manager-impl.h>
  22 #include <dali-toolkit/internal/texture-manager/texture-upload-observer.h>
  23
  24 namespace Dali
  25 {
  26 namespace Toolkit
  27 {
  28 namespace Internal
  29 {
  30 class ImageCache : public TextureManager::LifecycleObserver
  31 {
  32 public:
  33   /**
  34    * Observer class to inform when the next image is ready
  35    */
  36   class FrameReadyObserver
  37   {
  38   public:
  39     /**
  40      * @brief Informs observer when the next texture set is ready to display
  41      * @param[in] textureSet The ready texture set
  42      * @param[in] interval interval(ms) for the frame
  43      */
  44     virtual void FrameReady(TextureSet textureSet, uint32_t interval) = 0;
  45   };
  46
  47   struct UrlStore
  48   {
  49     TextureManager::TextureId mTextureId = TextureManager::INVALID_TEXTURE_ID;
  50     std::string               mUrl;
  51   };
  52
  53   /**
  54    * List of URLs
  55    */
  56   typedef std::vector<UrlStore> UrlList;
  57
  58 public:
  59   /**
  60    * @brief Constructor.
  61    * @param[in] textureManager The texture manager
  62    * @param[in] urlList List of urls to cache
  63    * @param[in] observer FrameReady observer
  64    * @param[in] batchSize The size of a batch to load
  65    * @param[in] interval Time interval(ms) between each frame
  66    *
  67    * This will start loading textures immediately, according to the
  68    * batch and cache sizes. The cache is as large as the number of urls.
  69    */
  70   ImageCache(TextureManager&                 textureManager,
  71              ImageCache::FrameReadyObserver& observer,
  72              uint32_t                        batchSize,
  73              uint32_t                        interval);
  74
  75   virtual ~ImageCache();
  76
  77   /**
  78    * @brief Get the first frame. If it's not ready, this will trigger the
  79    * sending of FrameReady() when the image becomes ready.
  80    *
  81    * @return TextureSet of the first frame.
  82    */
  83   virtual TextureSet FirstFrame() = 0;
  84
  85   /**
  86    * @brief Get the Nth frame. If it's not ready, this will trigger the
  87    * sending of FrameReady() when the image becomes ready.
  88    *
  89    * @param[in] frameIndex required frame index to be returned.
  90    * @return TextureSet of the frame index.
  91    */
  92   virtual TextureSet Frame(uint32_t frameIndex) = 0;
  93
  94   /**
  95    * @brief Get the interval(ms) of Nth frame.
  96    *
  97    * @param[in] frameIndex frame index to get frame interval.
  98    * @return Time interval in millisecond between frames of frameIndex and frameIndex + 1.
  99    */
 100   virtual uint32_t GetFrameInterval(uint32_t frameIndex) const = 0;
 101
 102   /**
 103    * @brief Get the current rendered frame index.
 104    * If there isn't any loaded frame, returns -1.
 105    *
 106    * @return Frame index of currently showing frame.
 107    */
 108   virtual int32_t GetCurrentFrameIndex() const = 0;
 109
 110   /**
 111    * @brief Get total frame count of the animated image file.
 112    *
 113    * @return Total frame count of the animated image file.
 114    */
 115   virtual int32_t GetTotalFrameCount() const = 0;
 116
 117   /**
 118    * @brief Clears animated image cache and remove loaded textures.
 119    */
 120   virtual void ClearCache() = 0;
 121
 122   /**
 123    * @brief Set default interval(ms) between each frame.
 124    *
 125    * @param[in] interval time interval in millisecond to be used as default interval.
 126    */
 127   virtual void SetInterval(uint32_t interval);
 128
 129 private:
 130   /**
 131    * @brief Called before the texture manager is destroyed.
 132    */
 133   void TextureManagerDestroyed() final;
 134
 135 protected:
 136   TextureManager&           mTextureManager;
 137   FrameReadyObserver&       mObserver;
 138   uint32_t                  mBatchSize;
 139   uint32_t                  mInterval;
 140   TextureManager::LoadState mLoadState;
 141   bool                      mRequestingLoad : 1;
 142   bool                      mTextureManagerAlive : 1;
 143 };
 144
 145 } //namespace Internal
 146 } //namespace Toolkit
 147 } //namespace Dali
 148
 149 #endif // DALI_TOOLKIT_INTERNAL_IMAGE_CACHE_H