X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali%2Finternal%2Frender%2Fcommon%2Frender-manager.h;h=9b899591341950f96bd90ebf821ef3fed404a288;hb=79881246746f65474b24ea4fe14151ccef8df3f4;hp=3c86f3a3c664f4ffd4c9abe83f4a003c649932df;hpb=9d825be196fa6565a6dabc8647fe4867f5e9a89a;p=platform%2Fcore%2Fuifw%2Fdali-core.git diff --git a/dali/internal/render/common/render-manager.h b/dali/internal/render/common/render-manager.h index 3c86f3a..9b89959 100644 --- a/dali/internal/render/common/render-manager.h +++ b/dali/internal/render/common/render-manager.h @@ -1,8 +1,8 @@ -#ifndef __DALI_INTERNAL_SCENE_GRAPH_RENDER_MANAGER_H__ -#define __DALI_INTERNAL_SCENE_GRAPH_RENDER_MANAGER_H__ +#ifndef DALI_INTERNAL_SCENE_GRAPH_RENDER_MANAGER_H +#define DALI_INTERNAL_SCENE_GRAPH_RENDER_MANAGER_H /* - * Copyright (c) 2014 Samsung Electronics Co., Ltd. + * Copyright (c) 2020 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. @@ -20,8 +20,11 @@ // INTERNAL INCLUDES #include -#include -#include +#include +#include +#include +#include +#include namespace Dali { @@ -29,7 +32,10 @@ namespace Dali namespace Integration { class GlAbstraction; +class GlSyncAbstraction; +class GlContextHelperAbstraction; class RenderStatus; +class Scene; } struct Vector4; @@ -38,31 +44,48 @@ namespace Internal { class Context; class ProgramCache; +class ShaderSaver; -namespace SceneGraph +namespace Render { +class FrameBuffer; class Renderer; +struct Sampler; +class RenderTracker; +class Geometry; +class Texture; +} + +namespace SceneGraph +{ class RenderQueue; -class TextureCache; class RenderInstruction; class RenderInstructionContainer; -class RenderTracker; class Shader; +class PropertyBufferDataProvider; +class Scene; /** * RenderManager is responsible for rendering the result of the previous "update", which * is provided in a RenderCommand during UpdateManager::Update(). */ -class RenderManager : public PostProcessResourceDispatcher +class RenderManager { public: /** * Construct a new RenderManager. - * @param[in] glAbstraction The GL abstraction used for rendering. - * @param[out] resourcePostProcessQueue A queue for sending rendered texture ids to the update-thread. + * @param[in] glAbstraction The GL abstraction used for rendering. + * @param[in] glSyncAbstraction The GL sync abstraction used fence sync creation/deletion. + * @param[in] glContextHelperAbstraction The GL context helper abstraction for accessing GL context. + * @param[in] depthBufferAvailable Whether the depth buffer is available + * @param[in] stencilBufferAvailable Whether the stencil buffer is available */ - static RenderManager* New( Dali::Integration::GlAbstraction& glAbstraction, ResourcePostProcessList& resourcePostProcessQueue ); + static RenderManager* New( Integration::GlAbstraction& glAbstraction, + Integration::GlSyncAbstraction& glSyncAbstraction, + Integration::GlContextHelperAbstraction& glContextHelperAbstraction, + Integration::DepthBufferAvailable depthBufferAvailable, + Integration::StencilBufferAvailable stencilBufferAvailable ); /** * Non-virtual destructor; not intended as a base class @@ -76,13 +99,6 @@ public: RenderQueue& GetRenderQueue(); /** - * Retrieve the texture cache. Messages should only be sent to this from the update thread, - * accessor methods should only be used from the render thread. - * @return The texture cache - */ - TextureCache& GetTextureCache(); - - /** * @copydoc Dali::Integration::Core::ContextCreated() */ void ContextCreated(); @@ -93,25 +109,15 @@ public: void ContextDestroyed(); /** - * Dispatch requests onto the postProcessResourcesQueue - * @param[in] request The request to dispatch - */ - virtual void DispatchPostProcessRequest(ResourcePostProcessRequest& request); - - /** - * Retrieve the render instructions; these should be set during each "update" traversal. - * @return The render instruction container. + * Set the upstream interface for compiled shader binaries to be sent back to for eventual + * caching and saving. + * @param[in] upstream The abstract interface to send any received ShaderDatas onwards to.. + * @note This should be called during core initialisation if shader binaries are to be used. */ - RenderInstructionContainer& GetRenderInstructionContainer(); + void SetShaderSaver( ShaderSaver& upstream ); // The following methods should be called via RenderQueue messages - /** - * Set the background color i.e. the glClear color used at the beginning of each frame. - * @param[in] color The new background color. - */ - void SetBackgroundColor( const Vector4& color ); - /* * Set the frame time delta (time elapsed since the last frame. * @param[in] deltaTime the delta time @@ -129,14 +135,180 @@ public: * @param[in] renderer The renderer to add. * @post renderer is owned by RenderManager */ - void AddRenderer( Renderer* renderer ); + void AddRenderer( OwnerPointer< Render::Renderer >& renderer ); /** * Remove a Renderer from the render manager. * @param[in] renderer The renderer to remove. * @post renderer is destroyed. */ - void RemoveRenderer( Renderer* renderer ); + void RemoveRenderer( Render::Renderer* renderer ); + + /** + * Add a sampler to the render manager. + * @param[in] sampler The sampler to add. + * @post sampler is owned by RenderManager + */ + void AddSampler( OwnerPointer< Render::Sampler >& sampler ); + + /** + * Remove a sampler from the render manager. + * @param[in] sampler The sampler to remove. + * @post sampler is destroyed. + */ + void RemoveSampler( Render::Sampler* sampler ); + + /** + * Set minification and magnification filter modes for a sampler + * @param[in] minFilterMode Filter mode to use when the texture is minificated + * @param[in] magFilterMode Filter mode to use when the texture is magnified + */ + void SetFilterMode( Render::Sampler* sampler, uint32_t minFilterMode, uint32_t magFilterMode ); + + /** + * Set wrapping mode for a sampler + * @param[in] rWrapMode Wrap mode in the z direction + * @param[in] uWrapMode Wrap mode in the x direction + * @param[in] vWrapMode Wrap mode in the y direction + */ + void SetWrapMode( Render::Sampler* sampler, uint32_t rWrapMode, uint32_t sWrapMode, uint32_t tWrapMode ); + + /** + * Add a property buffer to the render manager. + * @param[in] propertyBuffer The property buffer to add. + * @post propertBuffer is owned by RenderManager + */ + void AddPropertyBuffer( OwnerPointer< Render::PropertyBuffer >& propertyBuffer ); + + /** + * Remove a property buffer from the render manager. + * @param[in] propertyBuffer The property buffer to remove. + * @post propertyBuffer is destroyed. + */ + void RemovePropertyBuffer( Render::PropertyBuffer* propertyBuffer ); + + /** + * Add a geometry to the render manager. + * @param[in] geometry The geometry to add. + * @post geometry is owned by RenderManager + */ + void AddGeometry( OwnerPointer< Render::Geometry >& geometry ); + + /** + * Remove a geometry from the render manager. + * @param[in] geometry The geometry to remove. + * @post geometry is destroyed. + */ + void RemoveGeometry( Render::Geometry* geometry ); + + /** + * Adds a property buffer to a geometry from the render manager. + * @param[in] geometry The geometry + * @param[in] propertyBuffer The property buffer to remove. + */ + void AttachVertexBuffer( Render::Geometry* geometry, Render::PropertyBuffer* propertyBuffer ); + + /** + * Remove a property buffer from a Render::Geometry from the render manager. + * @param[in] geometry The geometry + * @param[in] propertyBuffer The property buffer to remove. + * @post property buffer is destroyed. + */ + void RemoveVertexBuffer( Render::Geometry* geometry, Render::PropertyBuffer* propertyBuffer ); + + /** + * Sets the format of an existing property buffer + * @param[in] propertyBuffer The property buffer. + * @param[in] format The new format of the buffer + */ + void SetPropertyBufferFormat( Render::PropertyBuffer* propertyBuffer, OwnerPointer< Render::PropertyBuffer::Format>& format ); + + /** + * Sets the data of an existing property buffer + * @param[in] propertyBuffer The property buffer. + * @param[in] data The new data of the buffer + * @param[in] size The new size of the buffer + */ + void SetPropertyBufferData( Render::PropertyBuffer* propertyBuffer, OwnerPointer< Vector >& data, uint32_t size ); + + /** + * Sets the data for the index buffer of an existing geometry + * @param[in] geometry The geometry + * @param[in] data A vector containing the indices + */ + void SetIndexBuffer( Render::Geometry* geometry, Dali::Vector& data ); + + /** + * Set the geometry type of an existing render geometry + * @param[in] geometry The render geometry + * @param[in] geometryType The new geometry type + */ + void SetGeometryType( Render::Geometry* geometry, uint32_t geometryType ); + + /** + * Adds a texture to the render manager + * @param[in] texture The texture to add + */ + void AddTexture( OwnerPointer< Render::Texture >& texture ); + + /** + * Removes a texture from the render manager + * @param[in] texture The texture to remove + */ + void RemoveTexture( Render::Texture* texture ); + + /** + * Uploads data to an existing texture + * @param[in] texture The texture + * @param[in] pixelData The pixel data object + * @param[in] params The parameters for the upload + */ + void UploadTexture( Render::Texture* texture, PixelDataPtr pixelData, const Texture::UploadParams& params ); + + /** + * Generates mipmaps for a given texture + * @param[in] texture The texture + */ + void GenerateMipmaps( Render::Texture* texture ); + + /** + * Adds a framebuffer to the render manager + * @param[in] frameBuffer The framebuffer to add + */ + void AddFrameBuffer( OwnerPointer< Render::FrameBuffer >& frameBuffer ); + + /** + * Removes a framebuffer from the render manager + * @param[in] frameBuffer The framebuffer to remove + */ + void RemoveFrameBuffer( Render::FrameBuffer* frameBuffer ); + + /** + * Attach a texture as color output to an existing FrameBuffer + * @param[in] frameBuffer The FrameBuffer + * @param[in] texture The texture that will be used as output when rendering + * @param[in] mipmapLevel The mipmap of the texture to be attached + * @param[in] layer Indicates which layer of a cube map or array texture to attach. Unused for 2D textures + */ + void AttachColorTextureToFrameBuffer( Render::FrameBuffer* frameBuffer, Render::Texture* texture, uint32_t mipmapLevel, uint32_t layer ); + + /** + * Initializes a Scene to the render manager + * @param[in] scene The Scene to initialize + */ + void InitializeScene( SceneGraph::Scene* scene ); + + /** + * Uninitializes a Scene to the render manager + * @param[in] scene The Scene to uninitialize + */ + void UninitializeScene( SceneGraph::Scene* scene ); + + /** + * This is called when the surface of the scene has been replaced. + * @param[in] scene The scene. + */ + void SurfaceReplaced( SceneGraph::Scene* scene ); /** * Adds a render tracker to the RenderManager. RenderManager takes ownership of the @@ -144,19 +316,13 @@ public: * object, usually an offscreen render task. * @param[in] renderTracker The render tracker */ - void AddRenderTracker( RenderTracker* renderTracker ); + void AddRenderTracker( Render::RenderTracker* renderTracker ); /** * Removes a render tracker from the RenderManager. * @param[in] renderTracker The render tracker to remove. */ - void RemoveRenderTracker( RenderTracker* renderTracker ); - - /** - * Set the default shader that is to be used in absence of custom shader - * @param[in] shader that is the default one - */ - void SetDefaultShader( Shader* shader ); + void RemoveRenderTracker( Render::RenderTracker* renderTracker ); /** * returns the Program controller for sending program messages @@ -164,24 +330,45 @@ public: */ ProgramCache* GetProgramCache(); - // This method should be called from Core::Render() + // This method should be called from Core::PreRender() /** - * Renders the results of the previous "update" traversal. - * @param[out] status contains the flag that indicates if render instructions exist - * @return true if a further update is required + * This is called before rendering any scene in the next frame. This method should be preceded + * by a call up Update. + * Multi-threading note: this method should be called from a dedicated rendering thread. + * @pre The GL context must have been created, and made current. + * @param[out] status showing whether update is required to run. + * @param[in] forceClear force the Clear on the framebuffer even if nothing is rendered. + * @param[in] uploadOnly uploadOnly Upload the resource only without rendering. */ - bool Render( Integration::RenderStatus& status ); + void PreRender( Integration::RenderStatus& status, bool forceClear, bool uploadOnly ); -private: + // This method should be called from Core::RenderScene() + + /** + * Render a scene in the next frame. This method should be preceded by a call up PreRender. + * This method should be called twice. The first pass to render off-screen frame buffers if any, + * and the second pass to render the surface. + * Multi-threading note: this method should be called from a dedicated rendering thread. + * @pre The GL context must have been created, and made current. + * @param[in] scene The scene to be rendered. + * @param[in] renderToFbo True to render off-screen frame buffers only if any, and False to render the surface only. + */ + void RenderScene( Integration::Scene& scene, bool renderToFbo ); + + // This method should be called from Core::PostRender() /** - * Helper to process a single RenderInstruction. - * @param[in] instruction A description of the rendering operation. - * @param[in] defaultShader default shader to use. - * @param[in] elapsedTime from previous render. + * This is called after rendering all the scenes in the next frame. This method should be + * followed by a call up RenderScene. + * Multi-threading note: this method should be called from a dedicated rendering thread. + * @pre The GL context must have been created, and made current. + * @param[in] uploadOnly uploadOnly Upload the resource only without rendering. */ - void DoRender( RenderInstruction& instruction, Shader& defaultShader, float elapsedTime ); + void PostRender( bool uploadOnly ); + + +private: private: @@ -209,4 +396,4 @@ private: } // namespace Dali -#endif // __DALI_INTERNAL_SCENE_GRAPH_RENDER_MANAGER_H__ +#endif // DALI_INTERNAL_SCENE_GRAPH_RENDER_MANAGER_H