dali-toolkit/internal/visuals/visual-url.h

   1 #ifndef DALI_TOOLKIT_INTERNAL_VISUAL_URL_H
   2 #define DALI_TOOLKIT_INTERNAL_VISUAL_URL_H
   3
   4 /*
   5  * Copyright (c) 2021 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 #include <string>
  21
  22 namespace Dali
  23 {
  24 namespace Toolkit
  25 {
  26 namespace Internal
  27 {
  28 class VisualUrl
  29 {
  30 public:
  31   /**
  32    * The type of the URL based on the string contents
  33    */
  34   enum Type
  35   {
  36     REGULAR_IMAGE,
  37     N_PATCH,
  38     SVG,
  39     GIF,
  40     WEBP,
  41     JSON,
  42     TVG
  43   };
  44
  45   enum ProtocolType
  46   {
  47     LOCAL,   ///< file in local file system
  48     TEXTURE, ///< texture uploaded to texture manager
  49     REMOTE,  ///< remote image
  50     BUFFER   ///< encoded image buffer
  51   };
  52
  53   /**
  54    * Default Constructor.
  55    * Resulting URL is not valid
  56    */
  57   VisualUrl();
  58
  59   /**
  60    * Default Destructor.
  61    * Delete an external texture if if protocolType is TEXTURE.
  62    */
  63   ~VisualUrl();
  64
  65   /**
  66    * Constructor.
  67    * Determines type of visual and whether the url is local or remote
  68    * Notify that it is using an external texture if if protocolType is TEXTURE.
  69    *
  70    * @param[in] url The URL to store and resolve
  71    */
  72   VisualUrl(const std::string& url);
  73
  74   /**
  75    * Copy constructor
  76    * @param[in] url The VisualUrl to copy
  77    */
  78   VisualUrl(const VisualUrl& url);
  79
  80   /**
  81    * Assignment operator
  82    * @param[in] url The VisualUrl to copy
  83    */
  84   VisualUrl& operator=(const VisualUrl& url);
  85
  86   /**
  87    * Get the full URL
  88    * @return The url
  89    */
  90   const std::string& GetUrl() const;
  91
  92   /**
  93    * Get the visual type of the URL
  94    * @return The visual type of the URL
  95    */
  96   Type GetType() const;
  97
  98   /**
  99    * Is the URL is local to the device, or remote?
 100    * @return the location of the resource
 101    */
 102   ProtocolType GetProtocolType() const;
 103
 104   /**
 105    * Is the URL valid?
 106    * @return true if the URL has length
 107    */
 108   bool IsValid() const;
 109
 110   /**
 111    * @return true if the location is LOCAL, i.e. is loadable from local file system
 112    */
 113   bool IsLocalResource() const;
 114
 115   /**
 116    * @return true if the location is BUFFER, i.e. may contain EncodedImageBuffer
 117    */
 118   bool IsBufferResource() const;
 119
 120   /**
 121    * @return the location part of the url
 122    */
 123   std::string GetLocation() const;
 124
 125   /**
 126    * Helper to create a URL of type TEXTURE
 127    * @param location the location of the texture
 128    * @return the Url
 129    */
 130   static std::string CreateTextureUrl(const std::string& location);
 131
 132   /**
 133    * Helper to create a URL of type BUFFER
 134    * @param location the location of the texture
 135    * @return the Url
 136    */
 137   static std::string CreateBufferUrl(const std::string& location);
 138
 139   /**
 140    * Helper to get a ProtocolType from url
 141    * @param url the url of the texture
 142    * @return the protocol type
 143    */
 144   static VisualUrl::ProtocolType GetProtocolType(const std::string& url);
 145
 146   /**
 147    * Helper to get a location from url
 148    * @param url the location of the texture
 149    * @return the location
 150    */
 151   static std::string GetLocation(const std::string& url);
 152
 153 private:
 154   std::string  mUrl;
 155   Type         mType;
 156   ProtocolType mLocation;
 157 };
 158
 159 } // namespace Internal
 160
 161 } // namespace Toolkit
 162
 163 } // namespace Dali
 164
 165 #endif /* DALI_TOOLKIT_INTERNAL_VISUAL_URL_H */