2 * Copyright (c) 2024 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-image/animated-image-visual.h>
22 #include <dali/devel-api/adaptor-framework/image-loading.h>
23 #include <dali/devel-api/adaptor-framework/window-devel.h>
24 #include <dali/integration-api/debug.h>
25 #include <dali/public-api/rendering/decorated-visual-renderer.h>
29 #include <dali-toolkit/devel-api/image-loader/image-atlas.h>
30 #include <dali-toolkit/devel-api/image-loader/texture-manager.h>
31 #include <dali-toolkit/devel-api/visuals/image-visual-properties-devel.h>
32 #include <dali-toolkit/internal/visuals/animated-image/fixed-image-cache.h>
33 #include <dali-toolkit/internal/visuals/animated-image/rolling-animated-image-cache.h>
34 #include <dali-toolkit/internal/visuals/animated-image/rolling-image-cache.h>
35 #include <dali-toolkit/internal/visuals/image-visual-shader-factory.h>
36 #include <dali-toolkit/internal/visuals/image-visual-shader-feature-builder.h>
37 #include <dali-toolkit/internal/visuals/visual-base-data-impl.h>
38 #include <dali-toolkit/internal/visuals/visual-factory-cache.h>
39 #include <dali-toolkit/internal/visuals/visual-factory-impl.h>
40 #include <dali-toolkit/internal/visuals/visual-string-constants.h>
41 #include <dali-toolkit/public-api/visuals/image-visual-properties.h>
42 #include <dali-toolkit/public-api/visuals/visual-properties.h>
52 const int CUSTOM_PROPERTY_COUNT(5); // ltr, wrap, pixel area, crop to mask, mask texture ratio
55 DALI_ENUM_TO_STRING_TABLE_BEGIN(FITTING_MODE)
56 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::FittingMode, SHRINK_TO_FIT)
57 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::FittingMode, SCALE_TO_FILL)
58 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::FittingMode, FIT_WIDTH)
59 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::FittingMode, FIT_HEIGHT)
60 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::FittingMode, DEFAULT)
61 DALI_ENUM_TO_STRING_TABLE_END(FITTING_MODE)
64 DALI_ENUM_TO_STRING_TABLE_BEGIN(SAMPLING_MODE)
65 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, BOX)
66 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, NEAREST)
67 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, LINEAR)
68 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, BOX_THEN_NEAREST)
69 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, BOX_THEN_LINEAR)
70 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, NO_FILTER)
71 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::SamplingMode, DONT_CARE)
72 DALI_ENUM_TO_STRING_TABLE_END(SAMPLING_MODE)
75 DALI_ENUM_TO_STRING_TABLE_BEGIN(STOP_BEHAVIOR)
76 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::StopBehavior, CURRENT_FRAME)
77 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::StopBehavior, FIRST_FRAME)
78 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::StopBehavior, LAST_FRAME)
79 DALI_ENUM_TO_STRING_TABLE_END(STOP_BEHAVIOR)
82 DALI_ENUM_TO_STRING_TABLE_BEGIN(WRAP_MODE)
83 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::WrapMode, DEFAULT)
84 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::WrapMode, CLAMP_TO_EDGE)
85 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::WrapMode, REPEAT)
86 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::WrapMode, MIRRORED_REPEAT)
87 DALI_ENUM_TO_STRING_TABLE_END(WRAP_MODE)
90 DALI_ENUM_TO_STRING_TABLE_BEGIN(LOAD_POLICY)
91 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::ImageVisual::LoadPolicy, IMMEDIATE)
92 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::ImageVisual::LoadPolicy, ATTACHED)
93 DALI_ENUM_TO_STRING_TABLE_END(LOAD_POLICY)
96 DALI_ENUM_TO_STRING_TABLE_BEGIN(RELEASE_POLICY)
97 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::ImageVisual::ReleasePolicy, DETACHED)
98 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::ImageVisual::ReleasePolicy, DESTROYED)
99 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::ImageVisual::ReleasePolicy, NEVER)
100 DALI_ENUM_TO_STRING_TABLE_END(RELEASE_POLICY)
102 static constexpr uint32_t SINGLE_IMAGE_COUNT = 1u;
103 static constexpr uint32_t FIRST_FRAME_INDEX = 0u;
104 static constexpr uint16_t MINIMUM_CACHESIZE = 1;
105 static constexpr Vector4 FULL_TEXTURE_RECT(0.f, 0.f, 1.f, 1.f);
106 static constexpr auto LOOP_FOREVER = -1;
107 static constexpr auto FIRST_LOOP = 0u;
109 constexpr uint32_t TEXTURE_COUNT_FOR_GPU_ALPHA_MASK = 2u;
111 #if defined(DEBUG_ENABLED)
112 Debug::Filter* gAnimImgLogFilter = Debug::Filter::New(Debug::NoLogging, false, "LOG_ANIMATED_IMAGE");
117 * Multi-image Flow of execution
120 * | DoSetProperties()
122 * | CreateImageCache()
125 * | PrepareTextureSet()
126 * | cache->FirstFrame()
128 * | FrameReady(textureSet)
130 * | actor.AddRenderer
132 * | mRenderer.SetTextures(textureSet)
135 * | DisplayNextFrame()
136 * | if front frame is ready,
137 * | mRenderer.SetTextures( front frame's texture )
139 * | Waiting for frame ready.
141 * | FrameReady(textureSet)
142 * | mRenderer.SetTextures(textureSet)
147 AnimatedImageVisualPtr AnimatedImageVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl, const Property::Map& properties)
149 AnimatedImageVisualPtr visual(new AnimatedImageVisual(factoryCache, shaderFactory, ImageDimensions()));
150 visual->InitializeAnimatedImage(imageUrl);
151 visual->SetProperties(properties);
153 visual->Initialize();
158 AnimatedImageVisualPtr AnimatedImageVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const Property::Array& imageUrls, const Property::Map& properties)
160 AnimatedImageVisualPtr visual(new AnimatedImageVisual(factoryCache, shaderFactory, ImageDimensions()));
161 visual->mImageUrls = new ImageCache::UrlList();
162 visual->mImageUrls->reserve(imageUrls.Count());
164 for(unsigned int i = 0; i < imageUrls.Count(); ++i)
166 ImageCache::UrlStore urlStore;
167 urlStore.mTextureId = TextureManager::INVALID_TEXTURE_ID;
168 urlStore.mUrl = imageUrls[i].Get<std::string>();
169 visual->mImageUrls->push_back(urlStore);
171 visual->mFrameCount = imageUrls.Count();
172 visual->SetProperties(properties);
174 visual->Initialize();
179 AnimatedImageVisualPtr AnimatedImageVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl, ImageDimensions size)
181 AnimatedImageVisualPtr visual(new AnimatedImageVisual(factoryCache, shaderFactory, size));
182 visual->InitializeAnimatedImage(imageUrl);
184 visual->Initialize();
189 void AnimatedImageVisual::InitializeAnimatedImage(const VisualUrl& imageUrl)
191 mImageUrl = imageUrl;
192 mAnimatedImageLoading = AnimatedImageLoading::New(imageUrl.GetUrl(), imageUrl.IsLocalResource());
195 void AnimatedImageVisual::CreateImageCache()
197 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Concise, "AnimatedImageVisual::CreateImageCache() batchSize:%d cacheSize:%d\n", mBatchSize, mCacheSize);
199 TextureManager& textureManager = mFactoryCache.GetTextureManager();
201 if(mAnimatedImageLoading)
203 mImageCache = new RollingAnimatedImageCache(textureManager, mDesiredSize, mFittingMode, mSamplingMode, mAnimatedImageLoading, mMaskingData, *this, mCacheSize, mBatchSize, mWrapModeU, mWrapModeV, IsSynchronousLoadingRequired(), IsPreMultipliedAlphaEnabled());
207 // Ensure the batch size and cache size are no bigger than the number of URLs,
208 // and that the cache is at least as big as the batch size.
209 uint16_t numUrls = mImageUrls->size();
210 uint16_t batchSize = std::max(std::min(mBatchSize, numUrls), MINIMUM_CACHESIZE);
211 uint16_t cacheSize = std::max(std::min(std::max(batchSize, mCacheSize), numUrls), MINIMUM_CACHESIZE);
212 if(cacheSize < numUrls)
214 mImageCache = new RollingImageCache(textureManager, mDesiredSize, mFittingMode, mSamplingMode, *mImageUrls, mMaskingData, *this, cacheSize, batchSize, mFrameDelay, IsPreMultipliedAlphaEnabled());
218 mImageCache = new FixedImageCache(textureManager, mDesiredSize, mFittingMode, mSamplingMode, *mImageUrls, mMaskingData, *this, batchSize, mFrameDelay, IsPreMultipliedAlphaEnabled());
224 DALI_LOG_ERROR("mImageCache is null\n");
228 AnimatedImageVisual::AnimatedImageVisual(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, ImageDimensions desiredSize)
229 : Visual::Base(factoryCache, Visual::FittingMode::FILL, Toolkit::Visual::ANIMATED_IMAGE),
232 mImageVisualShaderFactory(shaderFactory),
233 mPixelArea(FULL_TEXTURE_RECT),
235 mAnimatedImageLoading(),
236 mFrameIndexForJumpTo(0),
237 mCurrentFrameIndex(FIRST_FRAME_INDEX),
243 mLoopCount(LOOP_FOREVER),
244 mCurrentLoopIndex(FIRST_LOOP),
245 mLoadPolicy(Toolkit::ImageVisual::LoadPolicy::ATTACHED),
246 mReleasePolicy(Toolkit::ImageVisual::ReleasePolicy::DETACHED),
248 mDesiredSize(desiredSize),
251 mActionStatus(DevelAnimatedImageVisual::Action::PLAY),
252 mWrapModeU(WrapMode::DEFAULT),
253 mWrapModeV(WrapMode::DEFAULT),
254 mFittingMode(FittingMode::SCALE_TO_FILL),
255 mSamplingMode(SamplingMode::BOX_THEN_LINEAR),
256 mStopBehavior(DevelImageVisual::StopBehavior::CURRENT_FRAME),
257 mStartFirstFrame(false),
260 EnablePreMultipliedAlpha(mFactoryCache.GetPreMultiplyOnLoad());
263 AnimatedImageVisual::~AnimatedImageVisual()
265 // AnimatedImageVisual destroyed so remove texture unless ReleasePolicy is set to never release
266 // If this is animated image, clear cache. Else if this is single frame image, this is affected be release policy.
267 if(mFrameCount > SINGLE_IMAGE_COUNT || mReleasePolicy != Toolkit::ImageVisual::ReleasePolicy::NEVER)
269 mImageCache->ClearCache();
275 void AnimatedImageVisual::GetNaturalSize(Vector2& naturalSize)
277 if(mDesiredSize.GetWidth() > 0 && mDesiredSize.GetHeight() > 0)
279 naturalSize.x = mDesiredSize.GetWidth();
280 naturalSize.y = mDesiredSize.GetHeight();
284 naturalSize = Vector2::ZERO;
285 if(mImageSize.GetWidth() == 0 && mImageSize.GetHeight() == 0)
287 if(mMaskingData && mMaskingData->mAlphaMaskUrl.IsValid() &&
288 mMaskingData->mCropToMask)
290 ImageDimensions dimensions = Dali::GetClosestImageSize(mMaskingData->mAlphaMaskUrl.GetUrl());
291 if(dimensions != ImageDimensions(0, 0))
293 mImageSize = dimensions;
294 naturalSize.x = dimensions.GetWidth();
295 naturalSize.y = dimensions.GetHeight();
300 if(mImageUrl.IsValid())
302 mImageSize = mAnimatedImageLoading.GetImageSize();
304 else if(mImageUrls && mImageUrls->size() > 0)
306 mImageSize = Dali::GetClosestImageSize((*mImageUrls)[0].mUrl.GetUrl());
310 naturalSize.width = mImageSize.GetWidth();
311 naturalSize.height = mImageSize.GetHeight();
314 void AnimatedImageVisual::DoCreatePropertyMap(Property::Map& map) const
318 bool sync = IsSynchronousLoadingRequired();
319 map.Insert(Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING, sync);
321 map.Insert(Toolkit::Visual::Property::TYPE, Toolkit::Visual::ANIMATED_IMAGE);
323 if(mImageUrl.IsValid())
325 map.Insert(Toolkit::ImageVisual::Property::URL, mImageUrl.GetUrl());
327 if(mImageUrls != NULL && !mImageUrls->empty())
329 Property::Array urls;
330 for(unsigned int i = 0; i < mImageUrls->size(); ++i)
332 urls.Add((*mImageUrls)[i].mUrl.GetUrl());
334 Property::Value value(const_cast<Property::Array&>(urls));
335 map.Insert(Toolkit::ImageVisual::Property::URL, value);
338 map.Insert(Toolkit::ImageVisual::Property::PIXEL_AREA, mPixelArea);
339 map.Insert(Toolkit::ImageVisual::Property::WRAP_MODE_U, mWrapModeU);
340 map.Insert(Toolkit::ImageVisual::Property::WRAP_MODE_V, mWrapModeV);
342 map.Insert(Toolkit::ImageVisual::Property::BATCH_SIZE, static_cast<int>(mBatchSize));
343 map.Insert(Toolkit::ImageVisual::Property::CACHE_SIZE, static_cast<int>(mCacheSize));
344 map.Insert(Toolkit::ImageVisual::Property::FRAME_DELAY, static_cast<int>(mFrameDelay));
345 map.Insert(Toolkit::DevelImageVisual::Property::LOOP_COUNT, static_cast<int>(mLoopCount));
346 map.Insert(Toolkit::DevelImageVisual::Property::CURRENT_FRAME_NUMBER, (mImageCache) ? static_cast<int32_t>(mImageCache->GetCurrentFrameIndex()) : -1);
348 // 1. Get cached mFrameCount if mFrameCount != 0.
349 // 2. If we are not using animated image loading, ask to image cache.
350 // 2-1. If image cache return SINGLE_IMAGE_COUNT or less, It might not a valid value
351 // (since default frameCount of image cache is SINGLE_IMAGE_COUNT)
352 // So, let we ask to animated image loader again.
353 // 2-1-1. If animated image loader return 0, it means that it is not a valid animated image.
354 // 2-1-2. Otherwise, we can assume that it is valid frame count.
355 // 2-2. Otherwise, we can assume that it is valid frame count.
356 uint32_t frameCount = mFrameCount;
357 if(mImageCache && frameCount == 0)
359 frameCount = mImageCache->GetTotalFrameCount();
361 if(frameCount <= SINGLE_IMAGE_COUNT && mAnimatedImageLoading)
363 frameCount = mAnimatedImageLoading.GetImageCount();
367 map.Insert(Toolkit::DevelImageVisual::Property::TOTAL_FRAME_NUMBER, (frameCount >= SINGLE_IMAGE_COUNT) ? static_cast<int>(frameCount) : -1);
369 map.Insert(Toolkit::DevelImageVisual::Property::STOP_BEHAVIOR, mStopBehavior);
371 if(mMaskingData != nullptr)
373 map.Insert(Toolkit::ImageVisual::Property::ALPHA_MASK_URL, mMaskingData->mAlphaMaskUrl.GetUrl());
374 map.Insert(Toolkit::ImageVisual::Property::MASK_CONTENT_SCALE, mMaskingData->mContentScaleFactor);
375 map.Insert(Toolkit::ImageVisual::Property::CROP_TO_MASK, mMaskingData->mCropToMask);
376 map.Insert(Toolkit::DevelImageVisual::Property::MASKING_TYPE, mMaskingData->mPreappliedMasking ? DevelImageVisual::MaskingType::MASKING_ON_LOADING : DevelImageVisual::MaskingType::MASKING_ON_RENDERING);
379 map.Insert(Toolkit::ImageVisual::Property::LOAD_POLICY, mLoadPolicy);
380 map.Insert(Toolkit::ImageVisual::Property::RELEASE_POLICY, mReleasePolicy);
381 map.Insert(Toolkit::ImageVisual::Property::FITTING_MODE, mFittingMode);
382 map.Insert(Toolkit::ImageVisual::Property::SAMPLING_MODE, mSamplingMode);
383 map.Insert(Toolkit::ImageVisual::Property::DESIRED_WIDTH, mDesiredSize.GetWidth());
384 map.Insert(Toolkit::ImageVisual::Property::DESIRED_HEIGHT, mDesiredSize.GetHeight());
387 void AnimatedImageVisual::DoCreateInstancePropertyMap(Property::Map& map) const
390 map.Insert(Toolkit::Visual::Property::TYPE, Toolkit::Visual::ANIMATED_IMAGE);
391 if(mImageUrl.IsValid())
393 map.Insert(Toolkit::ImageVisual::Property::DESIRED_WIDTH, mDesiredSize.GetWidth());
394 map.Insert(Toolkit::ImageVisual::Property::DESIRED_HEIGHT, mDesiredSize.GetHeight());
398 void AnimatedImageVisual::OnDoAction(const Dali::Property::Index actionId, const Dali::Property::Value& attributes)
400 // Make not set any action when the resource status is already failed.
401 if(mImpl->mResourceStatus == Toolkit::Visual::ResourceStatus::FAILED)
406 // Check if action is valid for this visual type and perform action if possible
409 case DevelAnimatedImageVisual::Action::PAUSE:
411 // Pause will be executed on next timer tick
412 mActionStatus = DevelAnimatedImageVisual::Action::PAUSE;
415 case DevelAnimatedImageVisual::Action::PLAY:
417 if(mFrameDelayTimer && IsOnScene() && mActionStatus != DevelAnimatedImageVisual::Action::PLAY)
419 mFrameDelayTimer.Start();
421 mActionStatus = DevelAnimatedImageVisual::Action::PLAY;
424 case DevelAnimatedImageVisual::Action::STOP:
426 // STOP reset functionality will actually be done in a future change
427 // Stop will be executed on next timer tick
428 mActionStatus = DevelAnimatedImageVisual::Action::STOP;
429 mCurrentLoopIndex = FIRST_LOOP;
436 case DevelAnimatedImageVisual::Action::JUMP_TO:
439 if(attributes.Get(frameNumber))
441 if(frameNumber < 0 || frameNumber >= static_cast<int32_t>(mFrameCount))
443 DALI_LOG_ERROR("Invalid frame index used.\n");
448 mFrameIndexForJumpTo = frameNumber;
460 void AnimatedImageVisual::DoSetProperties(const Property::Map& propertyMap)
462 // url[s] already passed in from constructor
463 for(Property::Map::SizeType iter = 0; iter < propertyMap.Count(); ++iter)
465 KeyValuePair keyValue = propertyMap.GetKeyValue(iter);
466 if(keyValue.first.type == Property::Key::INDEX)
468 DoSetProperty(keyValue.first.indexKey, keyValue.second);
472 if(keyValue.first == PIXEL_AREA_UNIFORM_NAME)
474 DoSetProperty(Toolkit::ImageVisual::Property::PIXEL_AREA, keyValue.second);
476 else if(keyValue.first == IMAGE_WRAP_MODE_U)
478 DoSetProperty(Toolkit::ImageVisual::Property::WRAP_MODE_U, keyValue.second);
480 else if(keyValue.first == IMAGE_WRAP_MODE_V)
482 DoSetProperty(Toolkit::ImageVisual::Property::WRAP_MODE_V, keyValue.second);
484 else if(keyValue.first == BATCH_SIZE_NAME)
486 DoSetProperty(Toolkit::ImageVisual::Property::BATCH_SIZE, keyValue.second);
488 else if(keyValue.first == CACHE_SIZE_NAME)
490 DoSetProperty(Toolkit::ImageVisual::Property::CACHE_SIZE, keyValue.second);
492 else if(keyValue.first == FRAME_DELAY_NAME)
494 DoSetProperty(Toolkit::ImageVisual::Property::FRAME_DELAY, keyValue.second);
496 else if(keyValue.first == LOOP_COUNT_NAME)
498 DoSetProperty(Toolkit::DevelImageVisual::Property::LOOP_COUNT, keyValue.second);
500 else if(keyValue.first == STOP_BEHAVIOR_NAME)
502 DoSetProperty(Toolkit::DevelImageVisual::Property::STOP_BEHAVIOR, keyValue.second);
504 else if(keyValue.first == ALPHA_MASK_URL)
506 DoSetProperty(Toolkit::ImageVisual::Property::ALPHA_MASK_URL, keyValue.second);
508 else if(keyValue.first == MASK_CONTENT_SCALE_NAME)
510 DoSetProperty(Toolkit::ImageVisual::Property::MASK_CONTENT_SCALE, keyValue.second);
512 else if(keyValue.first == CROP_TO_MASK_NAME)
514 DoSetProperty(Toolkit::ImageVisual::Property::CROP_TO_MASK, keyValue.second);
516 else if(keyValue.first == MASKING_TYPE_NAME)
518 DoSetProperty(Toolkit::DevelImageVisual::Property::MASKING_TYPE, keyValue.second);
520 else if(keyValue.first == LOAD_POLICY_NAME)
522 DoSetProperty(Toolkit::ImageVisual::Property::LOAD_POLICY, keyValue.second);
524 else if(keyValue.first == RELEASE_POLICY_NAME)
526 DoSetProperty(Toolkit::ImageVisual::Property::RELEASE_POLICY, keyValue.second);
528 else if(keyValue.first == SYNCHRONOUS_LOADING)
530 DoSetProperty(Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING, keyValue.second);
532 else if(keyValue.first == IMAGE_FITTING_MODE)
534 DoSetProperty(Toolkit::ImageVisual::Property::FITTING_MODE, keyValue.second);
536 else if(keyValue.first == IMAGE_SAMPLING_MODE)
538 DoSetProperty(Toolkit::ImageVisual::Property::SAMPLING_MODE, keyValue.second);
540 else if(keyValue.first == IMAGE_DESIRED_WIDTH)
542 DoSetProperty(Toolkit::ImageVisual::Property::DESIRED_WIDTH, keyValue.second);
544 else if(keyValue.first == IMAGE_DESIRED_HEIGHT)
546 DoSetProperty(Toolkit::ImageVisual::Property::DESIRED_HEIGHT, keyValue.second);
550 // Load image immediately if LOAD_POLICY requires it
551 if(mLoadPolicy == Toolkit::ImageVisual::LoadPolicy::IMMEDIATE)
557 void AnimatedImageVisual::DoSetProperty(Property::Index index,
558 const Property::Value& value)
562 case Toolkit::ImageVisual::Property::PIXEL_AREA:
564 value.Get(mPixelArea);
567 case Toolkit::ImageVisual::Property::WRAP_MODE_U:
570 if(Scripting::GetEnumerationProperty(value, WRAP_MODE_TABLE, WRAP_MODE_TABLE_COUNT, wrapMode))
572 mWrapModeU = Dali::WrapMode::Type(wrapMode);
576 mWrapModeU = Dali::WrapMode::Type::DEFAULT;
580 case Toolkit::ImageVisual::Property::WRAP_MODE_V:
583 if(Scripting::GetEnumerationProperty(value, WRAP_MODE_TABLE, WRAP_MODE_TABLE_COUNT, wrapMode))
585 mWrapModeV = Dali::WrapMode::Type(wrapMode);
589 mWrapModeV = Dali::WrapMode::Type::DEFAULT;
594 case Toolkit::ImageVisual::Property::BATCH_SIZE:
597 if(value.Get(batchSize))
601 DALI_LOG_ERROR("The minimum value of batch size is 2.");
605 mBatchSize = batchSize;
611 case Toolkit::ImageVisual::Property::CACHE_SIZE:
614 if(value.Get(cacheSize))
618 DALI_LOG_ERROR("The minimum value of cache size is 2.");
622 mCacheSize = cacheSize;
628 case Toolkit::ImageVisual::Property::FRAME_DELAY:
631 if(value.Get(frameDelay))
633 mFrameDelay = frameDelay;
636 mImageCache->SetInterval(static_cast<uint32_t>(mFrameDelay));
642 case Toolkit::DevelImageVisual::Property::LOOP_COUNT:
645 if(value.Get(loopCount))
647 mLoopCount = loopCount;
652 case Toolkit::DevelImageVisual::Property::STOP_BEHAVIOR:
654 int32_t stopBehavior = mStopBehavior;
655 if(Scripting::GetEnumerationProperty(value, STOP_BEHAVIOR_TABLE, STOP_BEHAVIOR_TABLE_COUNT, stopBehavior))
657 mStopBehavior = DevelImageVisual::StopBehavior::Type(stopBehavior);
662 case Toolkit::ImageVisual::Property::SYNCHRONOUS_LOADING:
668 mImpl->mFlags |= Visual::Base::Impl::IS_SYNCHRONOUS_RESOURCE_LOADING;
672 mImpl->mFlags &= ~Visual::Base::Impl::IS_SYNCHRONOUS_RESOURCE_LOADING;
677 case Toolkit::ImageVisual::Property::ALPHA_MASK_URL:
679 std::string alphaUrl = "";
680 if(value.Get(alphaUrl))
683 mMaskingData->mAlphaMaskUrl = alphaUrl;
688 case Toolkit::ImageVisual::Property::MASK_CONTENT_SCALE:
694 mMaskingData->mContentScaleFactor = scale;
699 case Toolkit::ImageVisual::Property::CROP_TO_MASK:
705 mMaskingData->mCropToMask = crop;
710 case Toolkit::DevelImageVisual::Property::MASKING_TYPE:
713 if(value.Get(maskingType))
716 mMaskingData->mPreappliedMasking = Toolkit::DevelImageVisual::MaskingType::Type(maskingType) == Toolkit::DevelImageVisual::MaskingType::MASKING_ON_LOADING ? true : false;
721 case Toolkit::ImageVisual::Property::RELEASE_POLICY:
723 int releasePolicy = 0;
724 Scripting::GetEnumerationProperty(value, RELEASE_POLICY_TABLE, RELEASE_POLICY_TABLE_COUNT, releasePolicy);
725 mReleasePolicy = Toolkit::ImageVisual::ReleasePolicy::Type(releasePolicy);
729 case Toolkit::ImageVisual::Property::LOAD_POLICY:
732 Scripting::GetEnumerationProperty(value, LOAD_POLICY_TABLE, LOAD_POLICY_TABLE_COUNT, loadPolicy);
733 mLoadPolicy = Toolkit::ImageVisual::LoadPolicy::Type(loadPolicy);
737 case Toolkit::ImageVisual::Property::FITTING_MODE:
740 Scripting::GetEnumerationProperty(value, FITTING_MODE_TABLE, FITTING_MODE_TABLE_COUNT, fittingMode);
741 mFittingMode = Dali::FittingMode::Type(fittingMode);
745 case Toolkit::ImageVisual::Property::SAMPLING_MODE:
747 int samplingMode = 0;
748 Scripting::GetEnumerationProperty(value, SAMPLING_MODE_TABLE, SAMPLING_MODE_TABLE_COUNT, samplingMode);
749 mSamplingMode = Dali::SamplingMode::Type(samplingMode);
753 case Toolkit::ImageVisual::Property::DESIRED_WIDTH:
755 float desiredWidth = 0.0f;
756 if(value.Get(desiredWidth))
758 mDesiredSize.SetWidth(desiredWidth);
762 DALI_LOG_ERROR("AnimatedImageVisual: desiredWidth property has incorrect type\n");
767 case Toolkit::ImageVisual::Property::DESIRED_HEIGHT:
769 float desiredHeight = 0.0f;
770 if(value.Get(desiredHeight))
772 mDesiredSize.SetHeight(desiredHeight);
776 DALI_LOG_ERROR("AnimatedImageVisual: desiredHeight property has incorrect type\n");
783 void AnimatedImageVisual::DoSetOnScene(Actor& actor)
785 mStartFirstFrame = true;
786 mPlacementActor = actor;
789 DevelActor::VisibilityChangedSignal(actor).Connect(this, &AnimatedImageVisual::OnControlVisibilityChanged);
791 Window window = DevelWindow::Get(actor);
794 mPlacementWindow = window;
795 DevelWindow::VisibilityChangedSignal(window).Connect(this, &AnimatedImageVisual::OnWindowVisibilityChanged);
799 void AnimatedImageVisual::DoSetOffScene(Actor& actor)
801 DALI_ASSERT_DEBUG((bool)mImpl->mRenderer && "There should always be a renderer whilst on stage");
805 mFrameDelayTimer.Stop();
806 mFrameDelayTimer.Reset();
809 actor.RemoveRenderer(mImpl->mRenderer);
810 if(mReleasePolicy == Toolkit::ImageVisual::ReleasePolicy::DETACHED)
812 mImageCache->ClearCache(); // If INVALID_TEXTURE_ID then removal will be attempted on atlas
813 mImpl->mResourceStatus = Toolkit::Visual::ResourceStatus::PREPARING;
815 TextureSet textureSet = TextureSet::New();
816 mImpl->mRenderer.SetTextures(textureSet);
819 mPlacementActor.Reset();
820 mStartFirstFrame = false;
821 mCurrentFrameIndex = FIRST_FRAME_INDEX;
822 mCurrentLoopIndex = FIRST_LOOP;
824 DevelActor::VisibilityChangedSignal(actor).Disconnect(this, &AnimatedImageVisual::OnControlVisibilityChanged);
826 Window window = mPlacementWindow.GetHandle();
829 DevelWindow::VisibilityChangedSignal(window).Disconnect(this, &AnimatedImageVisual::OnWindowVisibilityChanged);
830 mPlacementWindow.Reset();
834 void AnimatedImageVisual::OnSetTransform()
838 mImpl->mTransform.SetUniforms(mImpl->mRenderer, Direction::LEFT_TO_RIGHT);
842 void AnimatedImageVisual::UpdateShader()
846 Shader shader = GenerateShader();
847 mImpl->mRenderer.SetShader(shader);
851 Shader AnimatedImageVisual::GenerateShader() const
853 bool defaultWrapMode = mWrapModeU <= WrapMode::CLAMP_TO_EDGE && mWrapModeV <= WrapMode::CLAMP_TO_EDGE;
854 bool requiredAlphaMaskingOnRendering = (mMaskingData && !mMaskingData->mMaskImageLoadingFailed) ? !mMaskingData->mPreappliedMasking : false;
856 shader = mImageVisualShaderFactory.GetShader(
858 ImageVisualShaderFeatureBuilder()
859 .ApplyDefaultTextureWrapMode(defaultWrapMode)
860 .EnableRoundedCorner(IsRoundedCornerRequired())
861 .EnableBorderline(IsBorderlineRequired())
862 .EnableAlphaMaskingOnRendering(requiredAlphaMaskingOnRendering));
866 void AnimatedImageVisual::OnInitialize()
870 bool defaultWrapMode = mWrapModeU <= WrapMode::CLAMP_TO_EDGE && mWrapModeV <= WrapMode::CLAMP_TO_EDGE;
871 Shader shader = GenerateShader();
873 Geometry geometry = mFactoryCache.GetGeometry(VisualFactoryCache::QUAD_GEOMETRY);
875 mImpl->mRenderer = DecoratedVisualRenderer::New(geometry, shader);
876 mImpl->mRenderer.ReserveCustomProperties(CUSTOM_PROPERTY_COUNT);
878 // Register transform properties
879 mImpl->mTransform.SetUniforms(mImpl->mRenderer, Direction::LEFT_TO_RIGHT);
881 if(!defaultWrapMode) // custom wrap mode
883 Vector2 wrapMode(mWrapModeU - WrapMode::CLAMP_TO_EDGE, mWrapModeV - WrapMode::CLAMP_TO_EDGE);
884 wrapMode.Clamp(Vector2::ZERO, Vector2(2.f, 2.f));
885 mImpl->mRenderer.RegisterProperty(WRAP_MODE_UNIFORM_NAME, wrapMode);
888 if(mPixelArea != FULL_TEXTURE_RECT)
890 mImpl->mRenderer.RegisterProperty(PIXEL_AREA_UNIFORM_NAME, mPixelArea);
895 mImpl->mRenderer.RegisterProperty(CROP_TO_MASK_NAME, static_cast<float>(mMaskingData->mCropToMask));
898 // Enable PreMultipliedAlpha if it need premultiplied
899 auto preMultiplyOnLoad = IsPreMultipliedAlphaEnabled() && !mImpl->mCustomShader
900 ? TextureManager::MultiplyOnLoad::MULTIPLY_ON_LOAD
901 : TextureManager::MultiplyOnLoad::LOAD_WITHOUT_MULTIPLY;
902 EnablePreMultipliedAlpha(preMultiplyOnLoad == TextureManager::MultiplyOnLoad::MULTIPLY_ON_LOAD);
905 void AnimatedImageVisual::StartFirstFrame(TextureSet& textureSet, uint32_t firstInterval)
907 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Concise, "AnimatedImageVisual::StartFirstFrame()\n");
909 mStartFirstFrame = false;
912 mImpl->mRenderer.SetTextures(textureSet);
915 Actor actor = mPlacementActor.GetHandle();
918 actor.AddRenderer(mImpl->mRenderer);
919 mPlacementActor.Reset();
923 if(mImpl->mResourceStatus != Toolkit::Visual::ResourceStatus::FAILED)
925 if(mFrameCount > SINGLE_IMAGE_COUNT)
927 mFrameDelayTimer = Timer::New(firstInterval);
928 mFrameDelayTimer.TickSignal().Connect(this, &AnimatedImageVisual::DisplayNextFrame);
929 mFrameDelayTimer.Start();
932 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Concise, "ResourceReady(ResourceStatus::READY)\n");
933 ResourceReady(Toolkit::Visual::ResourceStatus::READY);
936 mCurrentFrameIndex = FIRST_FRAME_INDEX;
939 void AnimatedImageVisual::PrepareTextureSet()
941 TextureSet textureSet;
944 textureSet = mImageCache->FirstFrame();
947 // Check whether synchronous loading is true or false for the first frame.
950 SetImageSize(textureSet);
954 void AnimatedImageVisual::SetImageSize(TextureSet& textureSet)
958 Texture texture = textureSet.GetTexture(0);
961 mImageSize.SetWidth(texture.GetWidth());
962 mImageSize.SetHeight(texture.GetHeight());
965 if(textureSet.GetTextureCount() > 1u && mMaskingData && mMaskingData->mCropToMask)
967 Texture maskTexture = textureSet.GetTexture(1);
970 mImageSize.SetWidth(std::min(static_cast<uint32_t>(mImageSize.GetWidth() * mMaskingData->mContentScaleFactor), maskTexture.GetWidth()));
971 mImageSize.SetHeight(std::min(static_cast<uint32_t>(mImageSize.GetHeight() * mMaskingData->mContentScaleFactor), maskTexture.GetHeight()));
973 float textureWidth = std::max(static_cast<float>(texture.GetWidth() * mMaskingData->mContentScaleFactor), Dali::Math::MACHINE_EPSILON_1);
974 float textureHeight = std::max(static_cast<float>(texture.GetHeight() * mMaskingData->mContentScaleFactor), Dali::Math::MACHINE_EPSILON_1);
975 Vector2 textureRatio(std::min(static_cast<float>(maskTexture.GetWidth()), textureWidth) / textureWidth,
976 std::min(static_cast<float>(maskTexture.GetHeight()), textureHeight) / textureHeight);
977 mImpl->mRenderer.RegisterProperty(MASK_TEXTURE_RATIO_NAME, textureRatio);
983 void AnimatedImageVisual::FrameReady(TextureSet textureSet, uint32_t interval, bool preMultiplied)
985 EnablePreMultipliedAlpha(preMultiplied);
987 // When image visual requested to load new frame to mImageCache and it is failed.
988 if(!mImageCache || !textureSet)
990 textureSet = SetLoadingFailed();
992 SetImageSize(textureSet);
996 mFrameCount = mImageCache->GetTotalFrameCount();
997 StartFirstFrame(textureSet, interval);
1001 if(mImpl->mRenderer)
1003 if(mFrameDelayTimer && interval > 0u)
1005 mFrameDelayTimer.SetInterval(interval);
1007 mImpl->mRenderer.SetTextures(textureSet);
1013 bool AnimatedImageVisual::DisplayNextFrame()
1015 TextureSet textureSet;
1016 bool continueTimer = false;
1020 uint32_t frameIndex = mImageCache->GetCurrentFrameIndex();
1025 frameIndex = mFrameIndexForJumpTo;
1027 else if(mActionStatus == DevelAnimatedImageVisual::Action::PAUSE)
1031 else if(mActionStatus == DevelAnimatedImageVisual::Action::STOP)
1033 mCurrentLoopIndex = FIRST_LOOP;
1034 if(mStopBehavior == DevelImageVisual::StopBehavior::FIRST_FRAME)
1036 frameIndex = FIRST_FRAME_INDEX;
1038 else if(mStopBehavior == DevelImageVisual::StopBehavior::LAST_FRAME)
1040 frameIndex = mFrameCount - 1;
1044 return false; // Do not draw already rendered scene twice.
1049 if(mFrameCount > SINGLE_IMAGE_COUNT)
1052 if(frameIndex >= mFrameCount)
1054 frameIndex = FIRST_FRAME_INDEX;
1055 ++mCurrentLoopIndex;
1058 if(mLoopCount >= 0 && mCurrentLoopIndex >= mLoopCount)
1060 // This will stop timer
1061 mActionStatus = DevelAnimatedImageVisual::Action::STOP;
1062 return DisplayNextFrame();
1067 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Concise, "AnimatedImageVisual::DisplayNextFrame(this:%p) CurrentFrameIndex:%d\n", this, frameIndex);
1069 textureSet = mImageCache->Frame(frameIndex);
1073 SetImageSize(textureSet);
1074 if(mImpl->mRenderer)
1076 mImpl->mRenderer.SetTextures(textureSet);
1079 mFrameDelayTimer.SetInterval(mImageCache->GetFrameInterval(frameIndex));
1082 mCurrentFrameIndex = frameIndex;
1083 continueTimer = (mActionStatus == DevelAnimatedImageVisual::Action::PLAY && textureSet) ? true : false;
1086 return continueTimer;
1089 TextureSet AnimatedImageVisual::SetLoadingFailed()
1091 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Concise, "ResourceReady(ResourceStatus::FAILED)\n");
1092 ResourceReady(Toolkit::Visual::ResourceStatus::FAILED);
1094 Actor actor = mPlacementActor.GetHandle();
1095 Vector2 imageSize = Vector2::ZERO;
1098 imageSize = actor.GetProperty(Actor::Property::SIZE).Get<Vector2>();
1100 mFactoryCache.UpdateBrokenImageRenderer(mImpl->mRenderer, imageSize);
1101 TextureSet textureSet = mImpl->mRenderer.GetTextures();
1103 if(mFrameDelayTimer)
1105 mFrameDelayTimer.Stop();
1106 mFrameDelayTimer.Reset();
1109 SetImageSize(textureSet);
1114 void AnimatedImageVisual::AllocateMaskData()
1118 mMaskingData.reset(new TextureManager::MaskingData());
1122 void AnimatedImageVisual::CheckMaskTexture()
1124 if(mMaskingData && !mMaskingData->mPreappliedMasking)
1126 bool maskLoadFailed = true;
1127 TextureSet textures = mImpl->mRenderer.GetTextures();
1128 if(textures && textures.GetTextureCount() >= TEXTURE_COUNT_FOR_GPU_ALPHA_MASK)
1130 maskLoadFailed = false;
1132 if(mMaskingData->mMaskImageLoadingFailed != maskLoadFailed)
1134 mMaskingData->mMaskImageLoadingFailed = maskLoadFailed;
1140 void AnimatedImageVisual::OnControlVisibilityChanged(Actor actor, bool visible, DevelActor::VisibilityChange::Type type)
1142 if(!visible && mActionStatus != DevelAnimatedImageVisual::Action::STOP)
1144 mActionStatus = DevelAnimatedImageVisual::Action::STOP;
1146 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Verbose, "AnimatedImageVisual::OnControlVisibilityChanged: invisibile. Pause animation [%p]\n", this);
1150 void AnimatedImageVisual::OnWindowVisibilityChanged(Window window, bool visible)
1152 if(!visible && mActionStatus != DevelAnimatedImageVisual::Action::STOP)
1154 mActionStatus = DevelAnimatedImageVisual::Action::STOP;
1156 DALI_LOG_INFO(gAnimImgLogFilter, Debug::Verbose, "AnimatedImageVisual::OnWindowVisibilityChanged: invisibile. Pause animation [%p]\n", this);
1160 } // namespace Internal
1162 } // namespace Toolkit