dali/internal/render/common/render-manager.cpp

   1 /*
   2  * Copyright (c) 2016 Samsung Electronics Co., Ltd.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  *
  16  */
  17
  18 // CLASS HEADER
  19 #include <dali/internal/render/common/render-manager.h>
  20
  21 // INTERNAL INCLUDES
  22 #include <dali/public-api/actors/sampling.h>
  23 #include <dali/public-api/common/dali-common.h>
  24 #include <dali/public-api/common/stage.h>
  25 #include <dali/public-api/render-tasks/render-task.h>
  26 #include <dali/integration-api/debug.h>
  27 #include <dali/integration-api/core.h>
  28 #include <dali/internal/common/owner-pointer.h>
  29 #include <dali/internal/render/common/render-algorithms.h>
  30 #include <dali/internal/render/common/render-debug.h>
  31 #include <dali/internal/render/common/render-tracker.h>
  32 #include <dali/internal/render/common/render-instruction-container.h>
  33 #include <dali/internal/render/common/render-instruction.h>
  34 #include <dali/internal/render/gl-resources/context.h>
  35 #include <dali/internal/render/gl-resources/frame-buffer-texture.h>
  36 #include <dali/internal/render/gl-resources/texture-cache.h>
  37 #include <dali/internal/render/queue/render-queue.h>
  38 #include <dali/internal/render/renderers/render-frame-buffer.h>
  39 #include <dali/internal/render/renderers/render-geometry.h>
  40 #include <dali/internal/render/renderers/render-renderer.h>
  41 #include <dali/internal/render/renderers/render-sampler.h>
  42 #include <dali/internal/render/shaders/program-controller.h>
  43
  44 namespace Dali
  45 {
  46
  47 namespace Internal
  48 {
  49
  50 namespace SceneGraph
  51 {
  52
  53 typedef OwnerContainer< Render::Renderer* >    RendererOwnerContainer;
  54 typedef RendererOwnerContainer::Iterator       RendererOwnerIter;
  55
  56 typedef OwnerContainer< Render::Geometry* >    GeometryOwnerContainer;
  57 typedef GeometryOwnerContainer::Iterator       GeometryOwnerIter;
  58
  59 typedef OwnerContainer< Render::Sampler* >    SamplerOwnerContainer;
  60 typedef SamplerOwnerContainer::Iterator       SamplerOwnerIter;
  61
  62 typedef OwnerContainer< Render::NewTexture* >   TextureOwnerContainer;
  63 typedef TextureOwnerContainer::Iterator         TextureOwnerIter;
  64
  65 typedef OwnerContainer< Render::FrameBuffer* >  FrameBufferOwnerContainer;
  66 typedef FrameBufferOwnerContainer::Iterator     FrameBufferOwnerIter;
  67
  68 typedef OwnerContainer< Render::PropertyBuffer* > PropertyBufferOwnerContainer;
  69 typedef PropertyBufferOwnerContainer::Iterator    PropertyBufferOwnerIter;
  70
  71 typedef OwnerContainer< Render::RenderTracker* > RenderTrackerContainer;
  72 typedef RenderTrackerContainer::Iterator         RenderTrackerIter;
  73 typedef RenderTrackerContainer::ConstIterator    RenderTrackerConstIter;
  74
  75 /**
  76  * Structure to contain internal data
  77  */
  78 struct RenderManager::Impl
  79 {
  80   Impl( Integration::GlAbstraction& glAbstraction,
  81         Integration::GlSyncAbstraction& glSyncAbstraction,
  82         LockedResourceQueue& textureUploadedQ,
  83         TextureUploadedDispatcher& postProcessDispatcher )
  84   : context( glAbstraction ),
  85     glSyncAbstraction( glSyncAbstraction ),
  86     renderQueue(),
  87     textureCache( renderQueue, postProcessDispatcher, context ),
  88     textureUploadedQueue( textureUploadedQ ),
  89     instructions(),
  90     backgroundColor( Dali::Stage::DEFAULT_BACKGROUND_COLOR ),
  91     frameCount( 0 ),
  92     renderBufferIndex( SceneGraphBuffers::INITIAL_UPDATE_BUFFER_INDEX ),
  93     defaultSurfaceRect(),
  94     rendererContainer(),
  95     samplerContainer(),
  96     textureContainer(),
  97     frameBufferContainer(),
  98     renderersAdded( false ),
  99     firstRenderCompleted( false ),
 100     defaultShader( NULL ),
 101     programController( glAbstraction )
 102   {
 103   }
 104
 105   ~Impl()
 106   {
 107   }
 108
 109   void AddRenderTracker( Render::RenderTracker* renderTracker )
 110   {
 111     DALI_ASSERT_DEBUG( renderTracker != NULL );
 112     mRenderTrackers.PushBack( renderTracker );
 113   }
 114
 115   void RemoveRenderTracker( Render::RenderTracker* renderTracker )
 116   {
 117     DALI_ASSERT_DEBUG( renderTracker != NULL );
 118     for(RenderTrackerIter iter = mRenderTrackers.Begin(), end = mRenderTrackers.End(); iter != end; ++iter)
 119     {
 120       if( *iter == renderTracker )
 121       {
 122         mRenderTrackers.Erase( iter );
 123         break;
 124       }
 125     }
 126   }
 127
 128   void UpdateTrackers()
 129   {
 130     for(RenderTrackerIter iter = mRenderTrackers.Begin(), end = mRenderTrackers.End(); iter != end; ++iter)
 131     {
 132       (*iter)->PollSyncObject();
 133     }
 134   }
 135
 136   // the order is important for destruction,
 137   // programs are owned by context at the moment.
 138   Context                       context;                  ///< holds the GL state
 139   Integration::GlSyncAbstraction& glSyncAbstraction;      ///< GL sync abstraction
 140   RenderQueue                   renderQueue;              ///< A message queue for receiving messages from the update-thread.
 141   TextureCache                  textureCache;             ///< Cache for all GL textures
 142   LockedResourceQueue&          textureUploadedQueue;     ///< A queue for requesting resource post processing in update thread
 143
 144   // Render instructions describe what should be rendered during RenderManager::Render()
 145   // Owned by RenderManager. Update manager updates instructions for the next frame while we render the current one
 146   RenderInstructionContainer    instructions;
 147
 148   Vector4                       backgroundColor;          ///< The glClear color used at the beginning of each frame.
 149
 150   unsigned int                  frameCount;               ///< The current frame count
 151   BufferIndex                   renderBufferIndex;        ///< The index of the buffer to read from; this is opposite of the "update" buffer
 152
 153   Rect<int>                     defaultSurfaceRect;       ///< Rectangle for the default surface we are rendering to
 154
 155   RendererOwnerContainer        rendererContainer;        ///< List of owned renderers
 156   SamplerOwnerContainer         samplerContainer;         ///< List of owned samplers
 157   TextureOwnerContainer         textureContainer;         ///< List of owned textures
 158   FrameBufferOwnerContainer     frameBufferContainer;     ///< List of owned framebuffers
 159   PropertyBufferOwnerContainer  propertyBufferContainer;  ///< List of owned property buffers
 160   GeometryOwnerContainer        geometryContainer;        ///< List of owned Geometries
 161
 162   bool                          renderersAdded;
 163
 164   RenderTrackerContainer        mRenderTrackers;          ///< List of render trackers
 165
 166   bool                          firstRenderCompleted;     ///< False until the first render is done
 167   Shader*                       defaultShader;            ///< Default shader to use
 168   ProgramController             programController;        ///< Owner of the GL programs
 169
 170 };
 171
 172 RenderManager* RenderManager::New( Integration::GlAbstraction& glAbstraction,
 173                                    Integration::GlSyncAbstraction& glSyncAbstraction,
 174                                    LockedResourceQueue& textureUploadedQ )
 175 {
 176   RenderManager* manager = new RenderManager;
 177   manager->mImpl = new Impl( glAbstraction,
 178                              glSyncAbstraction,
 179                              textureUploadedQ,
 180                              *manager );
 181   return manager;
 182 }
 183
 184 RenderManager::RenderManager()
 185 : mImpl(NULL)
 186 {
 187 }
 188
 189 RenderManager::~RenderManager()
 190 {
 191   delete mImpl;
 192 }
 193
 194 RenderQueue& RenderManager::GetRenderQueue()
 195 {
 196   return mImpl->renderQueue;
 197 }
 198
 199 TextureCache& RenderManager::GetTextureCache()
 200 {
 201   return mImpl->textureCache;
 202 }
 203
 204 void RenderManager::ContextCreated()
 205 {
 206   mImpl->context.GlContextCreated();
 207   mImpl->programController.GlContextCreated();
 208
 209   // renderers, textures and gpu buffers cannot reinitialize themselves
 210   // so they rely on someone reloading the data for them
 211 }
 212
 213 void RenderManager::ContextDestroyed()
 214 {
 215   mImpl->context.GlContextDestroyed();
 216   mImpl->programController.GlContextDestroyed();
 217
 218   // inform texture cache
 219   mImpl->textureCache.GlContextDestroyed(); // Clears gl texture ids
 220
 221   //Inform textures
 222   for( TextureOwnerIter iter = mImpl->textureContainer.Begin(); iter != mImpl->textureContainer.End(); ++iter )
 223   {
 224     (*iter)->GlContextDestroyed();
 225   }
 226
 227   //Inform framebuffers
 228   for( FrameBufferOwnerIter iter = mImpl->frameBufferContainer.Begin(); iter != mImpl->frameBufferContainer.End(); ++iter )
 229   {
 230     (*iter)->GlContextDestroyed();
 231   }
 232
 233   // inform renderers
 234   RendererOwnerContainer::Iterator end = mImpl->rendererContainer.End();
 235   RendererOwnerContainer::Iterator iter = mImpl->rendererContainer.Begin();
 236   for( ; iter != end; ++iter )
 237   {
 238     GlResourceOwner* renderer = *iter;
 239     renderer->GlContextDestroyed(); // Clear up vertex buffers
 240   }
 241 }
 242
 243 void RenderManager::DispatchTextureUploaded(ResourceId request)
 244 {
 245   mImpl->textureUploadedQueue.PushBack( request );
 246 }
 247
 248 void RenderManager::SetShaderSaver( ShaderSaver& upstream )
 249 {
 250   mImpl->programController.SetShaderSaver( upstream );
 251 }
 252
 253 RenderInstructionContainer& RenderManager::GetRenderInstructionContainer()
 254 {
 255   return mImpl->instructions;
 256 }
 257
 258 void RenderManager::SetBackgroundColor( const Vector4& color )
 259 {
 260   mImpl->backgroundColor = color;
 261 }
 262
 263 void RenderManager::SetDefaultSurfaceRect(const Rect<int>& rect)
 264 {
 265   mImpl->defaultSurfaceRect = rect;
 266 }
 267
 268 void RenderManager::AddRenderer( Render::Renderer* renderer )
 269 {
 270   // Initialize the renderer as we are now in render thread
 271   renderer->Initialize( mImpl->context, mImpl->textureCache );
 272
 273   mImpl->rendererContainer.PushBack( renderer );
 274
 275   if( !mImpl->renderersAdded )
 276   {
 277     mImpl->renderersAdded = true;
 278   }
 279 }
 280
 281 void RenderManager::RemoveRenderer( Render::Renderer* renderer )
 282 {
 283   DALI_ASSERT_DEBUG( NULL != renderer );
 284
 285   RendererOwnerContainer& renderers = mImpl->rendererContainer;
 286
 287   // Find the renderer
 288   for ( RendererOwnerIter iter = renderers.Begin(); iter != renderers.End(); ++iter )
 289   {
 290     if ( *iter == renderer )
 291     {
 292       renderers.Erase( iter ); // Renderer found; now destroy it
 293       break;
 294     }
 295   }
 296 }
 297
 298 void RenderManager::AddSampler( Render::Sampler* sampler )
 299 {
 300   mImpl->samplerContainer.PushBack( sampler );
 301 }
 302
 303 void RenderManager::RemoveSampler( Render::Sampler* sampler )
 304 {
 305   DALI_ASSERT_DEBUG( NULL != sampler );
 306
 307   SamplerOwnerContainer& samplers = mImpl->samplerContainer;
 308
 309   // Find the sampler
 310   for ( SamplerOwnerIter iter = samplers.Begin(); iter != samplers.End(); ++iter )
 311   {
 312     if ( *iter == sampler )
 313     {
 314       samplers.Erase( iter ); // Sampler found; now destroy it
 315       break;
 316     }
 317   }
 318 }
 319
 320 void RenderManager::AddTexture( Render::NewTexture* texture )
 321 {
 322   mImpl->textureContainer.PushBack( texture );
 323   texture->Initialize(mImpl->context);
 324 }
 325
 326 void RenderManager::RemoveTexture( Render::NewTexture* texture )
 327 {
 328   DALI_ASSERT_DEBUG( NULL != texture );
 329
 330   TextureOwnerContainer& textures = mImpl->textureContainer;
 331
 332   // Find the texture
 333   for ( TextureOwnerIter iter = textures.Begin(); iter != textures.End(); ++iter )
 334   {
 335     if ( *iter == texture )
 336     {
 337       texture->Destroy( mImpl->context );
 338       textures.Erase( iter ); // Texture found; now destroy it
 339       break;
 340     }
 341   }
 342 }
 343
 344 void RenderManager::UploadTexture( Render::NewTexture* texture, PixelDataPtr pixelData, const NewTexture::UploadParams& params )
 345 {
 346   texture->Upload( mImpl->context, pixelData, params );
 347 }
 348
 349 void RenderManager::GenerateMipmaps( Render::NewTexture* texture )
 350 {
 351   texture->GenerateMipmaps( mImpl->context );
 352 }
 353
 354 void RenderManager::SetFilterMode( Render::Sampler* sampler, unsigned int minFilterMode, unsigned int magFilterMode )
 355 {
 356   sampler->mMinificationFilter = static_cast<Dali::FilterMode::Type>(minFilterMode);
 357   sampler->mMagnificationFilter = static_cast<Dali::FilterMode::Type>(magFilterMode );
 358 }
 359
 360 void RenderManager::SetWrapMode( Render::Sampler* sampler, unsigned int rWrapMode, unsigned int sWrapMode, unsigned int tWrapMode )
 361 {
 362   sampler->mRWrapMode = static_cast<Dali::WrapMode::Type>(rWrapMode);
 363   sampler->mSWrapMode = static_cast<Dali::WrapMode::Type>(sWrapMode);
 364   sampler->mTWrapMode = static_cast<Dali::WrapMode::Type>(tWrapMode);
 365 }
 366
 367 void RenderManager::AddFrameBuffer( Render::FrameBuffer* frameBuffer )
 368 {
 369   mImpl->frameBufferContainer.PushBack( frameBuffer );
 370   frameBuffer->Initialize(mImpl->context);
 371 }
 372
 373 void RenderManager::RemoveFrameBuffer( Render::FrameBuffer* frameBuffer )
 374 {
 375   DALI_ASSERT_DEBUG( NULL != frameBuffer );
 376
 377   FrameBufferOwnerContainer& framebuffers = mImpl->frameBufferContainer;
 378
 379   // Find the sampler
 380   for ( FrameBufferOwnerIter iter = framebuffers.Begin(); iter != framebuffers.End(); ++iter )
 381   {
 382     if ( *iter == frameBuffer )
 383     {
 384       frameBuffer->Destroy( mImpl->context );
 385       framebuffers.Erase( iter ); // frameBuffer found; now destroy it
 386       break;
 387     }
 388   }
 389 }
 390
 391 void RenderManager::AttachColorTextureToFrameBuffer( Render::FrameBuffer* frameBuffer, Render::NewTexture* texture, unsigned int mipmapLevel, unsigned int layer )
 392 {
 393   frameBuffer->AttachColorTexture( mImpl->context, texture, mipmapLevel, layer );
 394 }
 395
 396 void RenderManager::AddPropertyBuffer( Render::PropertyBuffer* propertyBuffer )
 397 {
 398   mImpl->propertyBufferContainer.PushBack( propertyBuffer );
 399 }
 400
 401 void RenderManager::RemovePropertyBuffer( Render::PropertyBuffer* propertyBuffer )
 402 {
 403   DALI_ASSERT_DEBUG( NULL != propertyBuffer );
 404
 405   PropertyBufferOwnerContainer& propertyBuffers = mImpl->propertyBufferContainer;
 406
 407   // Find the sampler
 408   for ( PropertyBufferOwnerIter iter = propertyBuffers.Begin(); iter != propertyBuffers.End(); ++iter )
 409   {
 410     if ( *iter == propertyBuffer )
 411     {
 412       propertyBuffers.Erase( iter ); // Property buffer found; now destroy it
 413       break;
 414     }
 415   }
 416 }
 417
 418 void RenderManager::SetPropertyBufferFormat(Render::PropertyBuffer* propertyBuffer, Render::PropertyBuffer::Format* format )
 419 {
 420   propertyBuffer->SetFormat( format );
 421 }
 422
 423 void RenderManager::SetPropertyBufferData( Render::PropertyBuffer* propertyBuffer, Dali::Vector<char>* data, size_t size )
 424 {
 425   propertyBuffer->SetData( data, size );
 426 }
 427
 428 void RenderManager::SetIndexBuffer( Render::Geometry* geometry, Dali::Vector<unsigned short>& indices )
 429 {
 430   geometry->SetIndexBuffer( indices );
 431 }
 432
 433 void RenderManager::AddGeometry( Render::Geometry* geometry )
 434 {
 435   mImpl->geometryContainer.PushBack( geometry );
 436 }
 437
 438 void RenderManager::RemoveGeometry( Render::Geometry* geometry )
 439 {
 440   DALI_ASSERT_DEBUG( NULL != geometry );
 441
 442   GeometryOwnerContainer& geometries = mImpl->geometryContainer;
 443
 444   // Find the geometry
 445   for ( GeometryOwnerIter iter = geometries.Begin(); iter != geometries.End(); ++iter )
 446   {
 447     if ( *iter == geometry )
 448     {
 449       geometries.Erase( iter ); // Geometry found; now destroy it
 450       break;
 451     }
 452   }
 453 }
 454
 455 void RenderManager::AddVertexBuffer( Render::Geometry* geometry, Render::PropertyBuffer* propertyBuffer )
 456 {
 457   DALI_ASSERT_DEBUG( NULL != geometry );
 458
 459   GeometryOwnerContainer& geometries = mImpl->geometryContainer;
 460
 461   // Find the renderer
 462   for ( GeometryOwnerIter iter = geometries.Begin(); iter != geometries.End(); ++iter )
 463   {
 464     if ( *iter == geometry )
 465     {
 466       (*iter)->AddPropertyBuffer( propertyBuffer );
 467       break;
 468     }
 469   }
 470 }
 471
 472 void RenderManager::RemoveVertexBuffer( Render::Geometry* geometry, Render::PropertyBuffer* propertyBuffer )
 473 {
 474   DALI_ASSERT_DEBUG( NULL != geometry );
 475
 476   GeometryOwnerContainer& geometries = mImpl->geometryContainer;
 477
 478   // Find the renderer
 479   for ( GeometryOwnerIter iter = geometries.Begin(); iter != geometries.End(); ++iter )
 480   {
 481     if ( *iter == geometry )
 482     {
 483       (*iter)->RemovePropertyBuffer( propertyBuffer );
 484       break;
 485     }
 486   }
 487 }
 488
 489 void RenderManager::SetGeometryType( Render::Geometry* geometry, unsigned int geometryType )
 490 {
 491   geometry->SetType( Render::Geometry::Type(geometryType) );
 492 }
 493
 494 void RenderManager::AddRenderTracker( Render::RenderTracker* renderTracker )
 495 {
 496   mImpl->AddRenderTracker(renderTracker);
 497 }
 498
 499 void RenderManager::RemoveRenderTracker( Render::RenderTracker* renderTracker )
 500 {
 501   mImpl->RemoveRenderTracker(renderTracker);
 502 }
 503
 504 void RenderManager::SetDefaultShader( Shader* shader )
 505 {
 506   mImpl->defaultShader = shader;
 507 }
 508
 509 ProgramCache* RenderManager::GetProgramCache()
 510 {
 511   return &(mImpl->programController);
 512 }
 513
 514 bool RenderManager::Render( Integration::RenderStatus& status )
 515 {
 516   DALI_PRINT_RENDER_START( mImpl->renderBufferIndex );
 517
 518   // Core::Render documents that GL context must be current before calling Render
 519   DALI_ASSERT_DEBUG( mImpl->context.IsGlContextCreated() );
 520
 521   // Increment the frame count at the beginning of each frame
 522   ++(mImpl->frameCount);
 523
 524   // Process messages queued during previous update
 525   mImpl->renderQueue.ProcessMessages( mImpl->renderBufferIndex );
 526
 527   // No need to make any gl calls if we've done 1st glClear & don't have any renderers to render during startup.
 528   if( !mImpl->firstRenderCompleted || mImpl->renderersAdded )
 529   {
 530     // switch rendering to adaptor provided (default) buffer
 531     mImpl->context.BindFramebuffer( GL_FRAMEBUFFER, 0 );
 532
 533     mImpl->context.Viewport( mImpl->defaultSurfaceRect.x,
 534                              mImpl->defaultSurfaceRect.y,
 535                              mImpl->defaultSurfaceRect.width,
 536                              mImpl->defaultSurfaceRect.height );
 537
 538     mImpl->context.ClearColor( mImpl->backgroundColor.r,
 539                                mImpl->backgroundColor.g,
 540                                mImpl->backgroundColor.b,
 541                                mImpl->backgroundColor.a );
 542
 543     mImpl->context.ClearStencil( 0 );
 544
 545     // Clear the entire color, depth and stencil buffers for the default framebuffer.
 546     // It is important to clear all 3 buffers, for performance on deferred renderers like Mali
 547     // e.g. previously when the depth & stencil buffers were NOT cleared, it caused the DDK to exceed a "vertex count limit",
 548     // and then stall. That problem is only noticeable when rendering a large number of vertices per frame.
 549     mImpl->context.SetScissorTest( false );
 550     mImpl->context.ColorMask( true );
 551     mImpl->context.DepthMask( true );
 552     mImpl->context.StencilMask( 0xFF ); // 8 bit stencil mask, all 1's
 553     mImpl->context.Clear( GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT,  Context::FORCE_CLEAR );
 554
 555     // reset the program matrices for all programs once per frame
 556     // this ensures we will set view and projection matrix once per program per camera
 557     mImpl->programController.ResetProgramMatrices();
 558
 559     // if we don't have default shader, no point doing the render calls
 560     if( mImpl->defaultShader )
 561     {
 562       size_t count = mImpl->instructions.Count( mImpl->renderBufferIndex );
 563       for ( size_t i = 0; i < count; ++i )
 564       {
 565         RenderInstruction& instruction = mImpl->instructions.At( mImpl->renderBufferIndex, i );
 566
 567         DoRender( instruction, *mImpl->defaultShader );
 568       }
 569       GLenum attachments[] = { GL_DEPTH, GL_STENCIL };
 570       mImpl->context.InvalidateFramebuffer(GL_FRAMEBUFFER, 2, attachments);
 571
 572       mImpl->UpdateTrackers();
 573
 574       mImpl->firstRenderCompleted = true;
 575     }
 576   }
 577
 578   //Notify RenderGeometries that rendering has finished
 579   for ( GeometryOwnerIter iter = mImpl->geometryContainer.Begin(); iter != mImpl->geometryContainer.End(); ++iter )
 580   {
 581     (*iter)->OnRenderFinished();
 582   }
 583
 584   /**
 585    * The rendering has finished; swap to the next buffer.
 586    * Ideally the update has just finished using this buffer; otherwise the render thread
 587    * should block until the update has finished.
 588    */
 589   mImpl->renderBufferIndex = (0 != mImpl->renderBufferIndex) ? 0 : 1;
 590
 591   DALI_PRINT_RENDER_END();
 592
 593   // check if anything has been posted to the update thread, if IsEmpty then no update required.
 594   return !mImpl->textureUploadedQueue.IsEmpty();
 595 }
 596
 597 void RenderManager::DoRender( RenderInstruction& instruction, Shader& defaultShader )
 598 {
 599   Rect<int> viewportRect;
 600   Vector4   clearColor;
 601
 602   if ( instruction.mIsClearColorSet )
 603   {
 604     clearColor = instruction.mClearColor;
 605   }
 606   else
 607   {
 608     clearColor = Dali::RenderTask::DEFAULT_CLEAR_COLOR;
 609   }
 610
 611   FrameBufferTexture* offscreen = NULL;
 612
 613   if( instruction.mFrameBuffer != 0 )
 614   {
 615     instruction.mFrameBuffer->Bind( mImpl->context );
 616     if ( instruction.mIsViewportSet )
 617     {
 618       // For glViewport the lower-left corner is (0,0)
 619       const int y = ( instruction.mFrameBuffer->GetHeight() - instruction.mViewport.height ) - instruction.mViewport.y;
 620       viewportRect.Set( instruction.mViewport.x,  y, instruction.mViewport.width, instruction.mViewport.height );
 621     }
 622     else
 623     {
 624       viewportRect.Set( 0, 0, instruction.mFrameBuffer->GetWidth(), instruction.mFrameBuffer->GetHeight() );
 625     }
 626   }
 627   else // !(instruction.mOffscreenTexture)
 628   {
 629     // switch rendering to adaptor provided (default) buffer
 630     mImpl->context.BindFramebuffer( GL_FRAMEBUFFER, 0 );
 631
 632     // Check whether a viewport is specified, otherwise the full surface size is used
 633     if ( instruction.mIsViewportSet )
 634     {
 635       // For glViewport the lower-left corner is (0,0)
 636       const int y = ( mImpl->defaultSurfaceRect.height - instruction.mViewport.height ) - instruction.mViewport.y;
 637       viewportRect.Set( instruction.mViewport.x,  y, instruction.mViewport.width, instruction.mViewport.height );
 638     }
 639     else
 640     {
 641       viewportRect = mImpl->defaultSurfaceRect;
 642     }
 643   }
 644
 645   mImpl->context.Viewport(viewportRect.x, viewportRect.y, viewportRect.width, viewportRect.height);
 646
 647   if ( instruction.mIsClearColorSet )
 648   {
 649     mImpl->context.ClearColor( clearColor.r,
 650                                clearColor.g,
 651                                clearColor.b,
 652                                clearColor.a );
 653
 654     // Clear the viewport area only
 655     mImpl->context.SetScissorTest( true );
 656     mImpl->context.Scissor( viewportRect.x, viewportRect.y, viewportRect.width, viewportRect.height );
 657     mImpl->context.ColorMask( true );
 658     mImpl->context.Clear( GL_COLOR_BUFFER_BIT , Context::CHECK_CACHED_VALUES );
 659     mImpl->context.SetScissorTest( false );
 660   }
 661
 662   Render::ProcessRenderInstruction( instruction,
 663                                     mImpl->context,
 664                                     mImpl->textureCache,
 665                                     defaultShader,
 666                                     mImpl->renderBufferIndex );
 667
 668   if( instruction.mRenderTracker && ( offscreen != NULL || instruction.mFrameBuffer != NULL ) )
 669   {
 670     // This will create a sync object every frame this render tracker
 671     // is alive (though it should be now be created only for
 672     // render-once render tasks)
 673     instruction.mRenderTracker->CreateSyncObject( mImpl->glSyncAbstraction );
 674     instruction.mRenderTracker = NULL; // Only create once.
 675   }
 676 }
 677
 678 } // namespace SceneGraph
 679
 680 } // namespace Internal
 681
 682 } // namespace Dali