dali/internal/render/renderers/render-texture.h

   1 #ifndef DALI_INTERNAL_RENDER_TEXTURE_H
   2 #define DALI_INTERNAL_RENDER_TEXTURE_H
   3
   4 /*
   5  * Copyright (c) 2017 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 <string>
  22
  23 // INTERNAL INCLUDES
  24 #include <dali/public-api/images/image-operations.h> // Dali::ImageDimensions
  25 #include <dali/public-api/rendering/sampler.h>
  26 #include <dali/public-api/rendering/texture.h>
  27 #include <dali/internal/event/rendering/texture-impl.h>
  28 #include <dali/internal/render/gl-resources/context.h>
  29 #include <dali/internal/render/renderers/render-sampler.h>
  30 #include <dali/integration-api/gl-defines.h>
  31
  32 namespace Dali
  33 {
  34 namespace Internal
  35 {
  36 namespace Render
  37 {
  38 struct Sampler;
  39
  40 class Texture
  41 {
  42 public:
  43
  44   typedef Dali::TextureType::Type Type;
  45
  46   /**
  47    * Constructor
  48    * @param[in] type The type of the texture
  49    * @param[in] format The format of the pixel data
  50    * @param[in] size The size of the texture
  51    */
  52   Texture( Type type, Pixel::Format format, ImageDimensions size );
  53
  54   /**
  55    * Constructor from native image
  56    * @param[in] nativeImageInterface The native image
  57    */
  58   Texture( NativeImageInterfacePtr nativeImageInterface );
  59
  60   /**
  61    * Destructor
  62    */
  63   ~Texture();
  64
  65   /**
  66    * Creates the texture in the GPU.
  67    * Creates the texture and reserves memory for the first mipmap level
  68    * @param[in] context The GL context
  69    */
  70   void Initialize( Context& context );
  71
  72   /**
  73    * Deletes the texture from the GPU
  74    * @param[in] context The GL context
  75    */
  76   void Destroy( Context& context );
  77
  78   /**
  79    * Called by RenderManager to inform the texture that the context has been destroyed
  80    */
  81   void GlContextDestroyed();
  82
  83   /**
  84    * Uploads data to the texture.
  85    * @param[in] context The GL context
  86    * @param[in] pixelData A pixel data object
  87    * @param[in] params Upload parameters. See UploadParams
  88    */
  89   void Upload( Context& context, PixelDataPtr pixelData, const Internal::Texture::UploadParams& params );
  90
  91   /**
  92    * Bind the texture to the given texture unit and applies the given sampler
  93    * @param[in] context The GL context
  94    * @param[in] textureUnit the texture unit
  95    * @param[in] sampler The sampler to be used with the texture
  96    * @return true if the bind succeeded, false otherwise
  97    */
  98   bool Bind( Context& context, unsigned int textureUnit, Render::Sampler* sampler );
  99
 100   /**
 101    * Auto generates mipmaps for the texture
 102    * @param[in] context The GL context
 103    */
 104   void GenerateMipmaps( Context& context );
 105
 106   /**
 107    * Retrieve wheter the texture has an alpha channel
 108    * @return True if the texture has alpha channel, false otherwise
 109    */
 110   bool HasAlphaChannel();
 111
 112   /**
 113    * Get the id of the texture
 114    * @return Id of the texture
 115    */
 116   GLuint GetId()
 117   {
 118     return mId;
 119   }
 120
 121   /**
 122    * Get the type of the texture
 123    * @return Type of the texture
 124    */
 125   Type GetType() const
 126   {
 127     return mType;
 128   }
 129
 130   /**
 131    * Check if the texture is a native image
 132    * @return if the texture is a native image
 133    */
 134   bool IsNativeImage() const
 135   {
 136     return mNativeImage;
 137   }
 138
 139 private:
 140
 141   /**
 142    * Helper method to apply a sampler to the texture
 143    * @param[in] context The GL context
 144    * @param[in] sampler The sampler
 145    */
 146   void ApplySampler( Context& context, Render::Sampler* sampler );
 147
 148   NativeImageInterfacePtr mNativeImage; ///< Pointer to native image
 149   Render::Sampler mSampler;             ///< The current sampler state
 150   GLuint mId;                           ///< Id of the texture
 151   GLuint mTarget;                       ///< Specifies the target to which the texture is bound.
 152   GLint mGlInternalFormat;              ///< The gl internal format of the pixel data
 153   GLenum mGlFormat;                     ///< The gl format of the pixel data
 154   GLenum mPixelDataType;                ///< The data type of the pixel data
 155   uint16_t mWidth;                      ///< Width of the texture
 156   uint16_t mHeight;                     ///< Height of the texture
 157   uint16_t mMaxMipMapLevel;             ///< Maximum mipmap level
 158   Type mType:2;                         ///< Type of the texture
 159   bool mHasAlpha : 1;                   ///< Whether the format has an alpha channel
 160   bool mIsCompressed : 1;               ///< Whether the format is compressed
 161
 162 };
 163
 164
 165 } // namespace Render
 166
 167 } // namespace Internal
 168
 169 } // namespace Dali
 170
 171
 172 #endif //  DALI_INTERNAL_RENDER_TEXTURE_H