2 * Copyright (c) 2015 Samsung Electronics Co., Ltd.
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
19 #include "combined-update-render-controller.h"
23 #include <dali/integration-api/platform-abstraction.h>
26 #include <trigger-event-factory.h>
27 #include <base/combined-update-render/combined-update-render-controller-debug.h>
28 #include <base/environment-options.h>
29 #include <base/time-service.h>
30 #include <base/interfaces/adaptor-internal-services.h>
43 const unsigned int CREATED_THREAD_COUNT = 1u;
45 const int CONTINUOUS = -1;
48 const unsigned int TRUE = 1u;
49 const unsigned int FALSE = 0u;
51 const unsigned int MILLISECONDS_PER_SECOND( 1e+3 );
52 const float NANOSECONDS_TO_SECOND( 1e-9f );
53 const unsigned int NANOSECONDS_PER_SECOND( 1e+9 );
54 const unsigned int NANOSECONDS_PER_MILLISECOND( 1e+6 );
56 // The following values will get calculated at compile time
57 const float DEFAULT_FRAME_DURATION_IN_SECONDS( 1.0f / 60.0f );
58 const unsigned int DEFAULT_FRAME_DURATION_IN_MILLISECONDS( DEFAULT_FRAME_DURATION_IN_SECONDS * MILLISECONDS_PER_SECOND );
59 const unsigned int DEFAULT_FRAME_DURATION_IN_NANOSECONDS( DEFAULT_FRAME_DURATION_IN_SECONDS * NANOSECONDS_PER_SECOND );
62 * Handles the use case when an update-request is received JUST before we process a sleep-request. If we did not have an update-request count then
63 * there is a danger that, on the event-thread we could have:
64 * 1) An update-request where we do nothing as Update/Render thread still running.
65 * 2) Quickly followed by a sleep-request being handled where we pause the Update/Render Thread (even though we have an update to process).
67 * Using a counter means we increment the counter on an update-request, and decrement it on a sleep-request. This handles the above scenario because:
68 * 1) MAIN THREAD: Update Request: COUNTER = 1
69 * 2) UPDATE/RENDER THREAD: Do Update/Render, then no Updates required -> Sleep Trigger
70 * 3) MAIN THREAD: Update Request: COUNTER = 2
71 * 4) MAIN THREAD: Sleep Request: COUNTER = 1 -> We do not sleep just yet
73 * Also ensures we preserve battery life by only doing ONE update when the above use case is not triggered.
74 * 1) MAIN THREAD: Update Request: COUNTER = 1
75 * 2) UPDATE/RENDER THREAD: Do Update/Render, then no Updates required -> Sleep Trigger
76 * 3) MAIN THREAD: Sleep Request: COUNTER = 0 -> Go to sleep
78 const unsigned int MAXIMUM_UPDATE_REQUESTS = 2;
79 } // unnamed namespace
81 ///////////////////////////////////////////////////////////////////////////////////////////////////
83 ///////////////////////////////////////////////////////////////////////////////////////////////////
85 CombinedUpdateRenderController::CombinedUpdateRenderController( AdaptorInternalServices& adaptorInterfaces, const EnvironmentOptions& environmentOptions )
86 : mFpsTracker( environmentOptions ),
87 mUpdateStatusLogger( environmentOptions ),
88 mRenderHelper( adaptorInterfaces ),
89 mEventThreadSemaphore(),
90 mUpdateRenderThreadWaitCondition(),
91 mAdaptorInterfaces( adaptorInterfaces ),
92 mPerformanceInterface( adaptorInterfaces.GetPerformanceInterface() ),
93 mCore( adaptorInterfaces.GetCore() ),
94 mEnvironmentOptions( environmentOptions ),
95 mNotificationTrigger( adaptorInterfaces.GetProcessCoreEventsTrigger() ),
96 mSleepTrigger( NULL ),
97 mUpdateRenderThread( NULL ),
98 mDefaultFrameDelta( 0.0f ),
99 mDefaultFrameDurationMilliseconds( 0u ),
100 mDefaultFrameDurationNanoseconds( 0u ),
101 mDefaultHalfFrameNanoseconds( 0u ),
102 mUpdateRequestCount( 0u ),
104 mUpdateRenderRunCount( 0 ),
105 mDestroyUpdateRenderThread( FALSE ),
106 mUpdateRenderThreadCanSleep( FALSE ),
107 mPendingRequestUpdate( FALSE ),
109 mPostRendering( FALSE )
113 // Initialise frame delta/duration variables first
114 SetRenderRefreshRate( environmentOptions.GetRenderRefreshRate() );
116 // Set the thread-synchronization interface on the render-surface
117 RenderSurface* currentSurface = mAdaptorInterfaces.GetRenderSurfaceInterface();
120 currentSurface->SetThreadSynchronization( *this );
123 TriggerEventFactoryInterface& triggerFactory = mAdaptorInterfaces.GetTriggerEventFactoryInterface();
124 mSleepTrigger = triggerFactory.CreateTriggerEvent( MakeCallback( this, &CombinedUpdateRenderController::ProcessSleepRequest ), TriggerEventInterface::KEEP_ALIVE_AFTER_TRIGGER );
126 sem_init( &mEventThreadSemaphore, 0, 0 ); // Initialize to 0 so that it just waits if sem_post has not been called
129 CombinedUpdateRenderController::~CombinedUpdateRenderController()
135 delete mSleepTrigger;
138 void CombinedUpdateRenderController::Initialize()
142 // Ensure Update/Render Thread not already created
143 DALI_ASSERT_ALWAYS( ! mUpdateRenderThread );
145 // Create Update/Render Thread
146 mUpdateRenderThread = new pthread_t();
147 int error = pthread_create( mUpdateRenderThread, NULL, InternalUpdateRenderThreadEntryFunc, this );
148 DALI_ASSERT_ALWAYS( !error && "Return code from pthread_create() when creating UpdateRenderThread" );
150 // The Update/Render thread will now run and initialise EGL etc. and will then wait for Start to be called
151 // When this function returns, the application initialisation on the event thread should occur
154 void CombinedUpdateRenderController::Start()
158 DALI_ASSERT_ALWAYS( !mRunning && mUpdateRenderThread );
160 // Wait until all threads created in Initialise are up and running
161 for( unsigned int i = 0; i < CREATED_THREAD_COUNT; ++i )
163 sem_wait( &mEventThreadSemaphore );
166 mRenderHelper.Start();
170 LOG_EVENT( "Startup Complete, starting Update/Render Thread" );
172 RunUpdateRenderThread( CONTINUOUS, false /* No animation progression */ );
175 void CombinedUpdateRenderController::Pause()
181 PauseUpdateRenderThread();
183 AddPerformanceMarker( PerformanceInterface::PAUSED );
186 void CombinedUpdateRenderController::Resume()
190 if( !mRunning && IsUpdateRenderThreadPaused() )
192 LOG_EVENT( "Resuming" );
194 RunUpdateRenderThread( CONTINUOUS, true /* Animation progression required while we were paused */ );
196 AddPerformanceMarker( PerformanceInterface::RESUME );
202 void CombinedUpdateRenderController::Stop()
206 // Stop Rendering and the Update/Render Thread
207 mRenderHelper.Stop();
209 StopUpdateRenderThread();
211 if( mUpdateRenderThread )
213 LOG_EVENT( "Destroying UpdateRenderThread" );
215 // wait for the thread to finish
216 pthread_join( *mUpdateRenderThread, NULL );
218 delete mUpdateRenderThread;
219 mUpdateRenderThread = NULL;
225 void CombinedUpdateRenderController::RequestUpdate()
229 // Increment the update-request count to the maximum
230 if( mUpdateRequestCount < MAXIMUM_UPDATE_REQUESTS )
232 ++mUpdateRequestCount;
235 if( mRunning && IsUpdateRenderThreadPaused() )
237 LOG_EVENT( "Processing" );
239 RunUpdateRenderThread( CONTINUOUS, false /* No animation progression */ );
242 ConditionalWait::ScopedLock updateLock( mUpdateRenderThreadWaitCondition );
243 mPendingRequestUpdate = TRUE;
246 void CombinedUpdateRenderController::RequestUpdateOnce()
248 if( IsUpdateRenderThreadPaused() )
252 // Run Update/Render once
253 RunUpdateRenderThread( ONCE, false /* No animation progression */ );
257 void CombinedUpdateRenderController::ReplaceSurface( RenderSurface* newSurface )
261 // Set the ThreadSyncronizationInterface on the new surface
262 newSurface->SetThreadSynchronization( *this );
264 LOG_EVENT( "Starting to replace the surface, event-thread blocked" );
266 // Start replacing the surface.
268 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
269 mPostRendering = FALSE; // Clear the post-rendering flag as Update/Render thread will replace the surface now
270 mNewSurface = newSurface;
271 mUpdateRenderThreadWaitCondition.Notify( lock );
274 // Wait until the surface has been replaced
275 sem_wait( &mEventThreadSemaphore );
277 LOG_EVENT( "Surface replaced, event-thread continuing" );
280 void CombinedUpdateRenderController::SetRenderRefreshRate( unsigned int numberOfFramesPerRender )
282 // Not protected by lock, but written to rarely so not worth adding a lock when reading
283 mDefaultFrameDelta = numberOfFramesPerRender * DEFAULT_FRAME_DURATION_IN_SECONDS;
284 mDefaultFrameDurationMilliseconds = numberOfFramesPerRender * DEFAULT_FRAME_DURATION_IN_MILLISECONDS;
285 mDefaultFrameDurationNanoseconds = numberOfFramesPerRender * DEFAULT_FRAME_DURATION_IN_NANOSECONDS;
286 mDefaultHalfFrameNanoseconds = mDefaultFrameDurationNanoseconds / 2;
288 LOG_EVENT( "mDefaultFrameDelta(%.6f), mDefaultFrameDurationMilliseconds(%lld), mDefaultFrameDurationNanoseconds(%lld)", mDefaultFrameDelta, mDefaultFrameDurationMilliseconds, mDefaultFrameDurationNanoseconds );
291 ///////////////////////////////////////////////////////////////////////////////////////////////////
293 ///////////////////////////////////////////////////////////////////////////////////////////////////
295 void CombinedUpdateRenderController::RunUpdateRenderThread( int numberOfCycles, bool useElapsedTime )
297 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
298 mUpdateRenderRunCount = numberOfCycles;
299 mUpdateRenderThreadCanSleep = FALSE;
300 mUseElapsedTimeAfterWait = useElapsedTime;
301 LOG_COUNTER_EVENT( "mUpdateRenderRunCount: %d, mUseElapsedTimeAfterWait: %d", mUpdateRenderRunCount, mUseElapsedTimeAfterWait );
302 mUpdateRenderThreadWaitCondition.Notify( lock );
305 void CombinedUpdateRenderController::PauseUpdateRenderThread()
307 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
308 mUpdateRenderRunCount = 0;
311 void CombinedUpdateRenderController::StopUpdateRenderThread()
313 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
314 mDestroyUpdateRenderThread = TRUE;
315 mUpdateRenderThreadWaitCondition.Notify( lock );
318 bool CombinedUpdateRenderController::IsUpdateRenderThreadPaused()
320 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
321 return ( mUpdateRenderRunCount != CONTINUOUS ) || // Report paused if NOT continuously running
322 mUpdateRenderThreadCanSleep; // Report paused if sleeping
325 void CombinedUpdateRenderController::ProcessSleepRequest()
329 // Decrement Update request count
330 if( mUpdateRequestCount > 0 )
332 --mUpdateRequestCount;
335 // Can sleep if our update-request count is 0
336 // Update/Render thread can choose to carry on updating if it determines more update/renders are required
337 if( mUpdateRequestCount == 0 )
339 LOG_EVENT( "Going to sleep" );
341 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
342 mUpdateRenderThreadCanSleep = TRUE;
346 ///////////////////////////////////////////////////////////////////////////////////////////////////
347 // UPDATE/RENDER THREAD
348 ///////////////////////////////////////////////////////////////////////////////////////////////////
350 void CombinedUpdateRenderController::UpdateRenderThread()
352 // Install a function for logging
353 mEnvironmentOptions.InstallLogFunction();
355 LOG_UPDATE_RENDER( "THREAD CREATED" );
357 mRenderHelper.InitializeEgl();
359 // tell core it has a context
360 mCore.ContextCreated();
362 NotifyThreadInitialised();
365 uint64_t lastFrameTime;
366 TimeService::GetNanoseconds( lastFrameTime );
368 LOG_UPDATE_RENDER( "THREAD INITIALISED" );
370 bool useElapsedTime = true;
371 bool updateRequired = true;
373 while( UpdateRenderReady( useElapsedTime, updateRequired ) )
375 LOG_UPDATE_RENDER_TRACE;
377 uint64_t currentFrameStartTime = 0;
378 TimeService::GetNanoseconds( currentFrameStartTime );
380 const uint64_t timeSinceLastFrame = currentFrameStartTime - lastFrameTime;
382 // Optional FPS Tracking when continuously rendering
383 if( useElapsedTime && mFpsTracker.Enabled() )
385 float absoluteTimeSinceLastRender = timeSinceLastFrame * NANOSECONDS_TO_SECOND;
386 mFpsTracker.Track( absoluteTimeSinceLastRender );
389 lastFrameTime = currentFrameStartTime; // Store frame start time
391 //////////////////////////////
393 //////////////////////////////
395 RenderSurface* newSurface = ShouldSurfaceBeReplaced();
396 if( DALI_UNLIKELY( newSurface ) )
398 LOG_UPDATE_RENDER_TRACE_FMT( "Replacing Surface" );
399 mRenderHelper.ReplaceSurface( newSurface );
403 //////////////////////////////
405 //////////////////////////////
407 const unsigned int currentTime = currentFrameStartTime / NANOSECONDS_PER_MILLISECOND;
408 const unsigned int nextFrameTime = currentTime + mDefaultFrameDurationMilliseconds;
410 uint64_t noOfFramesSinceLastUpdate = 1;
411 float frameDelta = 0.0f;
414 // If using the elapsed time, then calculate frameDelta as a multiple of mDefaultFrameDelta
415 // Round up if remainder is more than half the default frame time
416 noOfFramesSinceLastUpdate = ( timeSinceLastFrame + mDefaultHalfFrameNanoseconds) / mDefaultFrameDurationNanoseconds;
417 frameDelta = mDefaultFrameDelta * noOfFramesSinceLastUpdate;
419 LOG_UPDATE_RENDER( "timeSinceLastFrame(%llu) noOfFramesSinceLastUpdate(%u) frameDelta(%.6f)", timeSinceLastFrame, noOfFramesSinceLastUpdate, frameDelta );
421 Integration::UpdateStatus updateStatus;
423 AddPerformanceMarker( PerformanceInterface::UPDATE_START );
424 mCore.Update( frameDelta, currentTime, nextFrameTime, updateStatus );
425 AddPerformanceMarker( PerformanceInterface::UPDATE_END );
427 unsigned int keepUpdatingStatus = updateStatus.KeepUpdating();
429 // Tell the event-thread to wake up (if asleep) and send a notification event to Core if required
430 if( updateStatus.NeedsNotification() )
432 mNotificationTrigger.Trigger();
433 LOG_UPDATE_RENDER( "Notification Triggered" );
436 // Optional logging of update/render status
437 mUpdateStatusLogger.Log( keepUpdatingStatus );
439 //////////////////////////////
441 //////////////////////////////
443 mRenderHelper.ConsumeEvents();
444 mRenderHelper.PreRender();
446 Integration::RenderStatus renderStatus;
448 AddPerformanceMarker( PerformanceInterface::RENDER_START );
449 mCore.Render( renderStatus );
450 AddPerformanceMarker( PerformanceInterface::RENDER_END );
452 if( renderStatus.HasRendered() )
454 mRenderHelper.PostRender();
457 // Trigger event thread to request Update/Render thread to sleep if update not required
458 if( ( Integration::KeepUpdating::NOT_REQUESTED == keepUpdatingStatus ) &&
459 ! renderStatus.NeedsUpdate() )
461 mSleepTrigger->Trigger();
462 updateRequired = false;
463 LOG_UPDATE_RENDER( "Sleep Triggered" );
467 updateRequired = true;
470 //////////////////////////////
472 //////////////////////////////
474 // Sleep until at least the the default frame duration has elapsed. This will return immediately if the specified end-time has already passed.
475 TimeService::SleepUntil( currentFrameStartTime + mDefaultFrameDurationNanoseconds );
478 // Inform core of context destruction & shutdown EGL
479 mCore.ContextDestroyed();
480 mRenderHelper.ShutdownEgl();
482 LOG_UPDATE_RENDER( "THREAD DESTROYED" );
484 // Uninstall the logging function
485 mEnvironmentOptions.UnInstallLogFunction();
488 bool CombinedUpdateRenderController::UpdateRenderReady( bool& useElapsedTime, bool updateRequired )
490 useElapsedTime = true;
492 ConditionalWait::ScopedLock updateLock( mUpdateRenderThreadWaitCondition );
493 while( ( ! mUpdateRenderRunCount || // Should try to wait if event-thread has paused the Update/Render thread
494 ( mUpdateRenderThreadCanSleep && ! updateRequired && ! mPendingRequestUpdate ) ) && // Ensure we wait if we're supposed to be sleeping AND do not require another update
495 ! mDestroyUpdateRenderThread && // Ensure we don't wait if the update-render-thread is supposed to be destroyed
496 ! mNewSurface ) // Ensure we don't wait if we need to replace the surface
498 LOG_UPDATE_RENDER( "WAIT: mUpdateRenderRunCount: %d", mUpdateRenderRunCount );
499 LOG_UPDATE_RENDER( " mUpdateRenderThreadCanSleep: %d, updateRequired: %d, mPendingRequestUpdate: %d", mUpdateRenderThreadCanSleep, updateRequired, mPendingRequestUpdate );
500 LOG_UPDATE_RENDER( " mDestroyUpdateRenderThread: %d", mDestroyUpdateRenderThread );
501 LOG_UPDATE_RENDER( " mNewSurface: %d", mNewSurface );
503 mUpdateRenderThreadWaitCondition.Wait( updateLock );
505 if( ! mUseElapsedTimeAfterWait )
507 useElapsedTime = false;
511 LOG_COUNTER_UPDATE_RENDER( "mUpdateRenderRunCount: %d", mUpdateRenderRunCount );
512 LOG_COUNTER_UPDATE_RENDER( "mUpdateRenderThreadCanSleep: %d, updateRequired: %d, mPendingRequestUpdate: %d", mUpdateRenderThreadCanSleep, updateRequired, mPendingRequestUpdate );
513 LOG_COUNTER_UPDATE_RENDER( "mDestroyUpdateRenderThread: %d", mDestroyUpdateRenderThread );
514 LOG_COUNTER_UPDATE_RENDER( "mNewSurface: %d", mNewSurface );
516 mUseElapsedTimeAfterWait = FALSE;
517 mUpdateRenderThreadCanSleep = FALSE;
518 mPendingRequestUpdate = FALSE;
520 // If we've been asked to run Update/Render cycles a finite number of times then decrement so we wait after the
521 // requested number of cycles
522 if( mUpdateRenderRunCount > 0 )
524 --mUpdateRenderRunCount;
527 // Keep the update-render thread alive if this thread is NOT to be destroyed
528 return ! mDestroyUpdateRenderThread;
531 RenderSurface* CombinedUpdateRenderController::ShouldSurfaceBeReplaced()
533 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
535 RenderSurface* newSurface = mNewSurface;
541 void CombinedUpdateRenderController::SurfaceReplaced()
543 // Just increment the semaphore
544 sem_post( &mEventThreadSemaphore );
547 ///////////////////////////////////////////////////////////////////////////////////////////////////
549 ///////////////////////////////////////////////////////////////////////////////////////////////////
551 void CombinedUpdateRenderController::NotifyThreadInitialised()
553 // Just increment the semaphore
554 sem_post( &mEventThreadSemaphore );
557 void CombinedUpdateRenderController::AddPerformanceMarker( PerformanceInterface::MarkerType type )
559 if( mPerformanceInterface )
561 mPerformanceInterface->AddMarker( type );
565 /////////////////////////////////////////////////////////////////////////////////////////////////
566 // POST RENDERING: EVENT THREAD
567 /////////////////////////////////////////////////////////////////////////////////////////////////
569 void CombinedUpdateRenderController::PostRenderComplete()
571 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
572 mPostRendering = FALSE;
573 mUpdateRenderThreadWaitCondition.Notify( lock );
576 ///////////////////////////////////////////////////////////////////////////////////////////////////
577 // POST RENDERING: RENDER THREAD
578 ///////////////////////////////////////////////////////////////////////////////////////////////////
580 void CombinedUpdateRenderController::PostRenderStarted()
582 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
583 mPostRendering = TRUE;
586 void CombinedUpdateRenderController::PostRenderWaitForCompletion()
588 ConditionalWait::ScopedLock lock( mUpdateRenderThreadWaitCondition );
589 while( mPostRendering &&
590 ! mNewSurface ) // We should NOT wait if we're replacing the surface
592 mUpdateRenderThreadWaitCondition.Wait( lock );
596 } // namespace Adaptor
598 } // namespace Internal