Merge "Added memory pool logging" into devel/master
[platform/core/uifw/dali-core.git] / dali / internal / render / common / render-item.h
index 839a1bd..0a82320 100644 (file)
@@ -1,8 +1,8 @@
-#ifndef __DALI_INTERNAL_SCENE_GRAPH_RENDER_ITEM_H__
-#define __DALI_INTERNAL_SCENE_GRAPH_RENDER_ITEM_H__
+#ifndef DALI_INTERNAL_SCENE_GRAPH_RENDER_ITEM_H
+#define DALI_INTERNAL_SCENE_GRAPH_RENDER_ITEM_H
 
 /*
- * Copyright (c) 2014 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2022 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.
  */
 
 // INTERNAL INCLUDES
-#include <dali/public-api/common/vector-wrapper.h>
+#include <dali/internal/update/nodes/node.h>
 #include <dali/public-api/actors/layer.h>
+#include <dali/public-api/common/vector-wrapper.h>
 #include <dali/public-api/math/matrix.h>
 
 namespace Dali
 {
-
 namespace Internal
 {
-
-namespace SceneGraph
+namespace Render
 {
-
 class Renderer;
-class RenderItem;
-
-typedef std::vector< RenderItem > RendererItemContainer;
+}
 
+namespace SceneGraph
+{
 /**
- * A render-item is a renderer & modelView matrix pair.
+ * A RenderItem contains all the data needed for rendering
  */
-class RenderItem
+struct RenderItem
 {
-public:
-
   /**
-   * Create a new render-item.
+   * Construct a new RenderItem
+   * @return A pointer to a new RenderItem.
    */
-  RenderItem();
+  static RenderItem* New();
 
   /**
    * Non-virtual destructor; RenderItem is not suitable as a base class.
@@ -55,72 +52,67 @@ public:
   ~RenderItem();
 
   /**
-   * Reset the render-item.
-   */
-  void Reset();
-
-  /**
-   * Retrieve the renderer.
-   * @return The renderer.
+   * Produce a 2D AABB in transformed space
+   * See below for caveats.
+   *
+   * @param[in]    transformMatrix   The matrix for converting to a different space
+   * @param[in]    position          The center position of the render item
+   * @param[in]    size              The size of the render item
    */
-  const Renderer* GetRenderer() const;
+  static ClippingBox CalculateTransformSpaceAABB(const Matrix& transformMatrix, const Vector3& position, const Vector3& size);
 
   /**
-   * Set the renderer
-   * @param[in] renderer The renderer
+   * @brief This method is an optimized calculation of a viewport-space AABB (Axis-Aligned-Bounding-Box).
+   *
+   * We use the model-view-matrix, but we do not use projection. Therefore we assume Z = 0.
+   * As the box is Axis-Aligned (in viewport space) rotations on Z axis are correctly delt with by expanding the box as necessary.
+   * Rotations on X & Y axis will resize the AABB, but it will not handle the projection error due to the new coordinates having non-zero Z values.
+   *
+   * Note: We pass in the viewport dimensions rather than allow the caller to modify the raw AABB in order to optimally generate the final result.
+   *
+   * Note: ASSUMES THAT THE VIEWPORT COVERS THE SCREEN AND THAT THE CANVAS SIZE AND VIEWPORT SIZE ARE THE SAME!!!!!  (Not the case for magnifier)
+   *
+   * @param[in]    modelViewMatrix   The model view matrix
+   * @param[in]    position          The center position of the render item
+   * @param[in]    size              The size of the render item
+   * @param[in]    viewportWidth     The width of the viewport to calculate for
+   * @param[in]    viewportHeight    The height of the viewport to calculate for
+   * @return                         The AABB coordinates in viewport-space (x, y, width, height)
    */
-  void SetRenderer( Renderer* renderer );
+  static ClippingBox CalculateViewportSpaceAABB(const Matrix& modelViewMatrix, const Vector3& position, const Vector3& size, const int viewportWidth, const int viewportHeight);
 
   /**
-   * Retrieve the modelView matrix.
-   * @return The modelView matrix.
+   * Overriden delete operator.
+   * Deletes the RenderItem from its global memory pool
+   * @param[in] A pointer to the RenderItem to delete.
    */
-  Matrix& GetModelViewMatrix();
+  void operator delete(void* ptr);
+
+  Matrix            mModelMatrix;
+  Matrix            mModelViewMatrix;
+  Vector3           mSize;
+  Vector4           mUpdateArea; ///< Update area hint is provided for damaged area calculation. (x, y, width, height)
+  Render::Renderer* mRenderer;
+  Node*             mNode;
+  const void*       mTextureSet; ///< Used for sorting only
+  int               mDepthIndex;
+  bool              mIsOpaque : 1;
+  bool              mIsUpdated : 1;
 
   /**
-   * Retrieve the modelView matrix.
-   * @return The modelView matrix.
+   * Get the capacity of the global pool.
    */
-  const Matrix& GetModelViewMatrix() const;
-
-  /**
-   * Retrieve the depth index
-   */
-  int GetDepthIndex() const
-  {
-    return mDepthIndex;
-  }
-
-  /**
-   * Set the depth index
-   */
-  void SetDepthIndex( int depthIndex );
-
-  /**
-   * Set if the RenderItem is opaque
-   * @param[in] isOpaque true if the RenderItem is opaque, false otherwise
-   */
-  void SetIsOpaque( bool isOpaque );
+  static uint32_t GetMemoryPoolCapacity();
 
+private:
   /**
-   * Check if the RenderItem is opaque
-   * @return True if it is opaque, false otherwise
+   * Private constructor. See RenderItem::New
    */
-  bool IsOpaque() const
-  {
-    return mIsOpaque;
-  }
-
-private:
+  RenderItem();
 
   // RenderItems should not be copied as they are heavy
-  RenderItem( const RenderItem& item );
-  RenderItem& operator = ( const RenderItem& item );
-
-  Matrix    mModelViewMatrix;
-  Renderer* mRenderer;
-  int       mDepthIndex;
-  bool      mIsOpaque:1;
+  RenderItem(const RenderItem& item);
+  RenderItem& operator=(const RenderItem& item);
 };
 
 } // namespace SceneGraph
@@ -129,4 +121,4 @@ private:
 
 } // namespace Dali
 
-#endif // __DALI_INTERNAL_SCENE_GRAPH_RENDER_ITEM_H__
+#endif // DALI_INTERNAL_SCENE_GRAPH_RENDER_ITEM_H