Merge "(Partial Update) Mark as not rendered if the node is transparent or culled...

[platform/core/uifw/dali-core.git] / dali / internal / render / renderers / render-texture.h

diff --git a/dali/internal/render/renderers/render-texture.h b/dali/internal/render/renderers/render-texture.h
index c7d80d9..ea8cd13 100644 (file)
--- a/dali/internal/render/renderers/render-texture.h
+++ b/dali/internal/render/renderers/render-texture.h
@@ -2,7 +2,7 @@
 #define DALI_INTERNAL_RENDER_TEXTURE_H
 
 /*
- * Copyright (c) 2015 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.
@@ -18,11 +18,20 @@
  */
 
 // EXTERNAL INCLUDES
+#include <cstdint> // uint16_t, uint32_t
 #include <string>
 
 // INTERNAL INCLUDES
-#include <dali/devel-api/rendering/sampler.h>
-#include <dali/integration-api/resource-declarations.h>
+#include <dali/public-api/images/image-operations.h> // Dali::ImageDimensions
+#include <dali/public-api/rendering/sampler.h>
+#include <dali/public-api/rendering/texture.h>
+
+#include <dali/graphics-api/graphics-controller.h>
+#include <dali/graphics-api/graphics-texture-create-info.h>
+#include <dali/graphics-api/graphics-texture.h>
+#include <dali/graphics-api/graphics-types.h>
+#include <dali/internal/event/rendering/texture-impl.h>
+#include <dali/internal/render/renderers/render-sampler.h>
 
 namespace Dali
 {
@@ -30,69 +39,117 @@ namespace Internal
 {
 namespace Render
 {
-class Sampler;
+struct Sampler;
 
-/**
- * This class is the mapping between texture id, sampler and sampler uniform name
- */
 class Texture
 {
 public:
+  using Type = Dali::TextureType::Type;
 
   /**
-   * Enumeration to tell that this sampler does not have a unique index yet
+   * Constructor
+   * @param[in] type The type of the texture
+   * @param[in] format The format of the pixel data
+   * @param[in] size The size of the texture
    */
-  enum
-  {
-    NOT_INITIALIZED = -1
-  };
+  Texture(Type type, Pixel::Format format, ImageDimensions size);
 
   /**
-   * Constructor
+   * Constructor from native image
+   * @param[in] nativeImageInterface The native image
    */
-  Texture()
-  : mSampler( 0 ),
-    mTextureId( Integration::InvalidResourceId )
-  {}
+  explicit Texture(NativeImageInterfacePtr nativeImageInterface);
 
   /**
-   * Constructor
+   * Destructor
    */
-  Texture( Integration::ResourceId textureId, Render::Sampler* sampler )
-  : mSampler( sampler ),
-    mTextureId( textureId)
-  {}
+  ~Texture();
 
   /**
-   * Destructor
+   * Stores the graphics controller for use when required.
+   *
+   * @param[in] graphicsController The graphics controller to use
    */
-  ~Texture()
-  {}
+  void Initialize(Graphics::Controller& graphicsController);
 
-  /*
-   * Get the Render::Sampler used by the texture
-   * @Return The Render::Sampler being used or 0 if using the default
+  /**
+   * Create the texture without a buffer
+   * @param[in] usage How texture will be used
    */
-  inline const Render::Sampler* GetSampler() const
+  void Create(Graphics::TextureUsageFlags usage);
+
+  /**
+   * Create a texture with a buffer if non-null
+   * @param[in] usage How texture will be used
+   * @param[in] buffer Buffer to copy
+   */
+  void CreateWithData(Graphics::TextureUsageFlags usage, uint8_t* buffer, uint32_t bufferSize);
+
+  /**
+   * Deletes the texture from the GPU
+   */
+  void Destroy();
+
+  /**
+   * Uploads data to the texture.
+   * @param[in] pixelData A pixel data object
+   * @param[in] params Upload parameters. See UploadParams
+   */
+  void Upload(PixelDataPtr pixelData, const Internal::Texture::UploadParams& params);
+
+  /**
+   * Auto generates mipmaps for the texture
+   */
+  void GenerateMipmaps();
+
+  /**
+   * Retrieve whether the texture has an alpha channel
+   * @return True if the texture has alpha channel, false otherwise
+   */
+  [[nodiscard]] bool HasAlphaChannel() const;
+
+  /**
+   * Get the graphics object associated with this texture
+   */
+  [[nodiscard]] Graphics::Texture* GetGraphicsObject() const;
+
+  /**
+   * Get the type of the texture
+   * @return Type of the texture
+   */
+  [[nodiscard]] Type GetType() const
   {
-    return mSampler;
+    return mType;
   }
 
-public: // called from RenderThread
-
   /**
-   * Get the texture ID
-   * @return the id of the associated texture
+   * Check if the texture is a native image
+   * @return if the texture is a native image
    */
-  inline Integration::ResourceId GetTextureId() const
+  [[nodiscard]] bool IsNativeImage() const
   {
-    return mTextureId;
+    return static_cast<bool>(mNativeImage);
   }
 
 private:
+  /**
+   * Helper method to apply a sampler to the texture
+   * @param[in] sampler The sampler
+   */
+  void ApplySampler(Render::Sampler* sampler);
 
-  Render::Sampler*        mSampler;
-  Integration::ResourceId mTextureId;
+private:
+  Graphics::Controller*                  mGraphicsController;
+  Graphics::UniquePtr<Graphics::Texture> mGraphicsTexture;
+
+  NativeImageInterfacePtr mNativeImage; ///< Pointer to native image
+  Render::Sampler         mSampler;     ///< The current sampler state
+
+  Pixel::Format mPixelFormat;  ///< Pixel format of the texture
+  uint16_t      mWidth;        ///< Width of the texture
+  uint16_t      mHeight;       ///< Height of the texture
+  Type          mType : 3;     ///< Type of the texture
+  bool          mHasAlpha : 1; ///< Whether the format has an alpha channel
 };
 
 } // namespace Render
@@ -101,5 +158,4 @@ private:
 
 } // namespace Dali
 
-
 #endif //  DALI_INTERNAL_RENDER_TEXTURE_H