2 * Copyright (c) 2020 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 <dali-toolkit/internal/visuals/animated-vector-image/vector-animation-task.h>
22 #include <dali/integration-api/debug.h>
23 #include <dali/public-api/object/property-array.h>
24 #include <dali/public-api/math/math-utils.h>
27 #include <dali-toolkit/internal/visuals/image-visual-shader-factory.h>
28 #include <dali-toolkit/internal/visuals/animated-vector-image/vector-animation-thread.h>
29 #include <dali-toolkit/internal/visuals/animated-vector-image/vector-animation-manager.h>
43 constexpr auto LOOP_FOREVER = -1;
44 constexpr auto NANOSECONDS_PER_SECOND( 1e+9 );
46 #if defined(DEBUG_ENABLED)
47 Debug::Filter* gVectorAnimationLogFilter = Debug::Filter::New( Debug::NoLogging, false, "LOG_VECTOR_ANIMATION" );
50 } // unnamed namespace
52 VectorAnimationTask::VectorAnimationTask( VisualFactoryCache& factoryCache, const std::string& url )
56 mVectorAnimationThread( factoryCache.GetVectorAnimationManager().GetVectorAnimationThread() ),
58 mAnimationFinishedTrigger(),
59 mPlayState( PlayState::STOPPED ),
60 mStopBehavior( DevelImageVisual::StopBehavior::CURRENT_FRAME ),
61 mLoopingMode( DevelImageVisual::LoopingMode::RESTART ),
62 mNextFrameStartTime(),
63 mFrameDurationNanoSeconds( 0 ),
71 mAnimationDataIndex( 0 ),
72 mLoopCount( LOOP_FOREVER ),
75 mUpdateFrameNumber( false ),
76 mNeedAnimationFinishedTrigger( true ),
77 mAnimationDataUpdated( false ),
83 VectorAnimationTask::~VectorAnimationTask()
85 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::~VectorAnimationTask: destructor [%p]\n", this );
88 void VectorAnimationTask::Finalize()
90 ConditionalWait::ScopedLock lock( mConditionalWait );
92 // Release some objects in the main thread
93 if( mAnimationFinishedTrigger )
95 mAnimationFinishedTrigger.reset();
98 mVectorRenderer.Finalize();
103 void VectorAnimationTask::SetRenderer( Renderer renderer )
105 ConditionalWait::ScopedLock lock( mConditionalWait );
107 mVectorRenderer.SetRenderer( renderer );
109 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetRenderer [%p]\n", this );
112 void VectorAnimationTask::SetAnimationData( const AnimationData& data )
114 ConditionalWait::ScopedLock lock( mConditionalWait );
116 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetAnimationData [%p]\n", this );
118 uint32_t index = mAnimationDataIndex == 0 ? 1 : 0; // Use the other buffer
120 mAnimationData[index] = data;
121 mAnimationDataUpdated = true;
123 if( data.resendFlag & VectorAnimationTask::RESEND_SIZE )
125 // The size should be changed in the main thread.
126 SetSize( data.width, data.height );
129 mVectorAnimationThread.AddTask( this );
132 void VectorAnimationTask::SetSize( uint32_t width, uint32_t height )
134 if( mWidth != width || mHeight != height )
136 mVectorRenderer.SetSize( width, height );
141 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetSize: width = %d, height = %d [%p]\n", width, height, this );
145 void VectorAnimationTask::PlayAnimation()
147 if( mPlayState != PlayState::PLAYING )
149 mNeedAnimationFinishedTrigger = true;
150 mUpdateFrameNumber = false;
151 mPlayState = PlayState::PLAYING;
153 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::PlayAnimation: Play [%p]\n", this );
157 void VectorAnimationTask::StopAnimation()
159 if( mPlayState != PlayState::STOPPING )
161 mNeedAnimationFinishedTrigger = false;
162 mPlayState = PlayState::STOPPING;
164 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::StopAnimation: Stop [%p]\n", this );
168 void VectorAnimationTask::PauseAnimation()
170 if( mPlayState == PlayState::PLAYING )
172 mPlayState = PlayState::PAUSED;
174 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::PauseAnimation: Pause [%p]\n", this );
178 void VectorAnimationTask::SetAnimationFinishedCallback( EventThreadCallback* callback )
180 ConditionalWait::ScopedLock lock( mConditionalWait );
183 mAnimationFinishedTrigger = std::unique_ptr< EventThreadCallback >( callback );
187 void VectorAnimationTask::SetLoopCount( int32_t count )
189 if( mLoopCount != count )
194 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetLoopCount: [%d] [%p]\n", count, this );
198 void VectorAnimationTask::SetPlayRange( const Property::Array& playRange )
201 uint32_t startFrame = 0, endFrame = 0;
202 size_t count = playRange.Count();
206 int32_t start = 0, end = 0;
207 if( playRange.GetElementAt( 0 ).Get( start ) && playRange.GetElementAt( 1 ).Get( end ) )
209 startFrame = static_cast< uint32_t >( start );
210 endFrame = static_cast< uint32_t >( end );
215 std::string startMarker, endMarker;
216 if( playRange.GetElementAt( 0 ).Get( startMarker ) && playRange.GetElementAt( 1 ).Get( endMarker ) )
218 if( mVectorRenderer )
220 uint32_t frame; // We don't use this later
221 if( mVectorRenderer.GetMarkerInfo( startMarker, startFrame, frame ) && mVectorRenderer.GetMarkerInfo( endMarker, frame, endFrame ) )
229 else if( count == 1 )
232 if( playRange.GetElementAt( 0 ).Get( marker ) )
234 if( mVectorRenderer )
236 mVectorRenderer.GetMarkerInfo( marker, startFrame, endFrame );
244 DALI_LOG_ERROR( "VectorAnimationTask::SetPlayRange: Invalid range [%p]\n", this );
248 // Make sure the range specified is between 0 and the total frame number
249 if( startFrame < mTotalFrame && endFrame < mTotalFrame )
251 // If the range is not in order swap values
252 if( startFrame > endFrame )
254 uint32_t temp = startFrame;
255 startFrame = endFrame;
259 if( startFrame != mStartFrame || endFrame != mEndFrame )
261 mStartFrame = startFrame;
262 mEndFrame = endFrame;
264 // If the current frame is out of the range, change the current frame also.
265 if( mStartFrame > mCurrentFrame )
267 mCurrentFrame = mStartFrame;
269 else if( mEndFrame < mCurrentFrame )
271 mCurrentFrame = mEndFrame;
274 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetPlayRange: [%d, %d] [%p]\n", mStartFrame, mEndFrame, this );
279 DALI_LOG_ERROR( "VectorAnimationTask::SetPlayRange: Invalid range (%d, %d) [%p]\n", startFrame, endFrame, this );
284 void VectorAnimationTask::GetPlayRange( uint32_t& startFrame, uint32_t& endFrame )
286 startFrame = mStartFrame;
287 endFrame = mEndFrame;
290 void VectorAnimationTask::SetCurrentFrameNumber( uint32_t frameNumber )
292 if( mCurrentFrame == frameNumber )
294 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetCurrentFrameNumber: Set same frame [%d] [%p]\n", frameNumber, this );
298 if( frameNumber >= mStartFrame && frameNumber <= mEndFrame )
300 mCurrentFrame = frameNumber;
301 mUpdateFrameNumber = false;
303 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetCurrentFrameNumber: frame number = %d [%p]\n", mCurrentFrame, this );
307 DALI_LOG_ERROR( "Invalid frame number [%d (%d, %d)]\n", frameNumber, mStartFrame, mEndFrame );
311 uint32_t VectorAnimationTask::GetCurrentFrameNumber() const
313 return mCurrentFrame;
316 uint32_t VectorAnimationTask::GetTotalFrameNumber() const
321 void VectorAnimationTask::GetDefaultSize( uint32_t& width, uint32_t& height ) const
323 mVectorRenderer.GetDefaultSize( width, height );
326 void VectorAnimationTask::SetStopBehavior( DevelImageVisual::StopBehavior::Type stopBehavior )
328 mStopBehavior = stopBehavior;
330 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetStopBehavior: stop behavor = %d [%p]\n", mStopBehavior, this );
333 void VectorAnimationTask::SetLoopingMode( DevelImageVisual::LoopingMode::Type loopingMode )
335 mLoopingMode = loopingMode;
337 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::SetLoopingMode: looping mode = %d [%p]\n", mLoopingMode, this );
340 void VectorAnimationTask::GetLayerInfo( Property::Map& map ) const
342 mVectorRenderer.GetLayerInfo( map );
345 VectorAnimationTask::UploadCompletedSignalType& VectorAnimationTask::UploadCompletedSignal()
347 return mVectorRenderer.UploadCompletedSignal();
350 void VectorAnimationTask::Initialize()
352 mVectorRenderer = VectorAnimationRenderer::New( mUrl );
354 mTotalFrame = mVectorRenderer.GetTotalFrameNumber();
356 mEndFrame = mTotalFrame - 1;
358 mFrameRate = mVectorRenderer.GetFrameRate();
359 mFrameDurationNanoSeconds = NANOSECONDS_PER_SECOND / mFrameRate;
361 uint32_t width, height;
362 mVectorRenderer.GetDefaultSize( width, height );
364 SetSize( width, height );
366 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::Initialize: file = %s [%d frames, %f fps] [%p]\n", mUrl.c_str(), mTotalFrame, mFrameRate, this );
369 bool VectorAnimationTask::Rasterize()
371 bool stopped = false;
372 uint32_t currentFrame;
375 ConditionalWait::ScopedLock lock( mConditionalWait );
378 // The task will be destroyed. We don't need rasterization.
383 ApplyAnimationData();
385 if( mPlayState == PlayState::PLAYING && mUpdateFrameNumber )
387 mCurrentFrame = mForward ? mCurrentFrame + 1 : mCurrentFrame - 1;
388 Dali::ClampInPlace( mCurrentFrame, mStartFrame, mEndFrame );
391 currentFrame = mCurrentFrame;
393 mUpdateFrameNumber = true;
395 if( mPlayState == PlayState::STOPPING )
397 mCurrentFrame = GetStoppedFrame( mStartFrame, mEndFrame, mCurrentFrame );
398 currentFrame = mCurrentFrame;
401 else if( mPlayState == PlayState::PLAYING )
403 bool animationFinished = false;
405 if( currentFrame >= mEndFrame ) // last frame
407 if( mLoopingMode == DevelImageVisual::LoopingMode::AUTO_REVERSE )
413 if( mLoopCount < 0 || ++mCurrentLoop < mLoopCount ) // repeat forever or before the last loop
415 mCurrentFrame = mStartFrame;
416 mUpdateFrameNumber = false;
420 animationFinished = true; // end of animation
424 else if( currentFrame == mStartFrame && !mForward ) // first frame
426 if( mLoopCount < 0 || ++mCurrentLoop < mLoopCount ) // repeat forever or before the last loop
432 animationFinished = true; // end of animation
436 if( animationFinished )
438 if( mStopBehavior == DevelImageVisual::StopBehavior::CURRENT_FRAME )
444 mPlayState = PlayState::STOPPING;
450 bool renderSuccess = false;
451 if( mVectorRenderer )
453 renderSuccess = mVectorRenderer.Render( currentFrame );
456 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::Rasterize: Rendering failed. Try again later.[%d] [%p]\n", currentFrame, this );
457 mUpdateFrameNumber = false;
461 if( stopped && renderSuccess )
463 mPlayState = PlayState::STOPPED;
467 // Animation is finished
469 ConditionalWait::ScopedLock lock( mConditionalWait );
470 if( mNeedAnimationFinishedTrigger && mAnimationFinishedTrigger )
472 mAnimationFinishedTrigger->Trigger();
476 DALI_LOG_INFO( gVectorAnimationLogFilter, Debug::Verbose, "VectorAnimationTask::Rasterize: Animation is finished [current = %d] [%p]\n", currentFrame, this );
479 bool keepAnimation = true;
480 if( mPlayState == PlayState::PAUSED || mPlayState == PlayState::STOPPED )
482 keepAnimation = false;
485 return keepAnimation;
488 uint32_t VectorAnimationTask::GetStoppedFrame( uint32_t startFrame, uint32_t endFrame, uint32_t currentFrame )
490 uint32_t frame = currentFrame;
492 switch( mStopBehavior )
494 case DevelImageVisual::StopBehavior::FIRST_FRAME:
499 case DevelImageVisual::StopBehavior::LAST_FRAME:
501 if( mLoopingMode == DevelImageVisual::LoopingMode::AUTO_REVERSE )
511 case DevelImageVisual::StopBehavior::CURRENT_FRAME:
513 frame = currentFrame;
521 std::chrono::time_point< std::chrono::system_clock > VectorAnimationTask::CalculateNextFrameTime( bool renderNow )
523 // std::chrono::time_point template has second parameter duration which defaults to the std::chrono::system_clock supported
524 // duration. In some C++11 implementations it is a milliseconds duration, so it fails to compile unless mNextFrameStartTime
525 // is casted to use the default duration.
526 mNextFrameStartTime = std::chrono::time_point_cast< std::chrono::time_point< std::chrono::system_clock >::duration >(
527 mNextFrameStartTime + std::chrono::nanoseconds( mFrameDurationNanoSeconds ) );
528 auto current = std::chrono::system_clock::now();
529 if( renderNow || mNextFrameStartTime < current )
531 mNextFrameStartTime = current;
533 return mNextFrameStartTime;
536 std::chrono::time_point< std::chrono::system_clock > VectorAnimationTask::GetNextFrameTime()
538 return mNextFrameStartTime;
541 void VectorAnimationTask::ApplyAnimationData()
546 ConditionalWait::ScopedLock lock( mConditionalWait );
548 if( !mAnimationDataUpdated || mAnimationData[mAnimationDataIndex].resendFlag != 0 )
550 // Data is not updated or the previous data is not applied yet.
554 mAnimationDataIndex = mAnimationDataIndex == 0 ? 1 : 0; // Swap index
555 mAnimationDataUpdated = false;
557 index = mAnimationDataIndex;
560 if( mAnimationData[index].resendFlag & VectorAnimationTask::RESEND_LOOP_COUNT )
562 SetLoopCount( mAnimationData[index].loopCount );
565 if( mAnimationData[index].resendFlag & VectorAnimationTask::RESEND_PLAY_RANGE )
567 SetPlayRange( mAnimationData[index].playRange );
570 if( mAnimationData[index].resendFlag & VectorAnimationTask::RESEND_STOP_BEHAVIOR )
572 SetStopBehavior( mAnimationData[index].stopBehavior );
575 if( mAnimationData[index].resendFlag & VectorAnimationTask::RESEND_LOOPING_MODE )
577 SetLoopingMode( mAnimationData[index].loopingMode );
580 if( mAnimationData[index].resendFlag & VectorAnimationTask::RESEND_CURRENT_FRAME )
582 SetCurrentFrameNumber( mAnimationData[index].currentFrame );
585 if( mAnimationData[index].resendFlag & VectorAnimationTask::RESEND_PLAY_STATE )
587 if( mAnimationData[index].playState == DevelImageVisual::PlayState::PLAYING )
591 else if( mAnimationData[index].playState == DevelImageVisual::PlayState::PAUSED )
595 else if( mAnimationData[index].playState == DevelImageVisual::PlayState::STOPPED )
601 mAnimationData[index].resendFlag = 0;
604 } // namespace Internal
606 } // namespace Toolkit