2 * Copyright (c) 2021 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/animated-vector-image-visual.h>
22 #include <dali/devel-api/adaptor-framework/window-devel.h>
23 #include <dali/devel-api/common/stage.h>
24 #include <dali/devel-api/rendering/renderer-devel.h>
25 #include <dali/integration-api/debug.h>
28 #include <dali-toolkit/devel-api/visuals/visual-actions-devel.h>
29 #include <dali-toolkit/devel-api/visuals/animated-vector-image-visual-signals-devel.h>
30 #include <dali-toolkit/devel-api/visuals/image-visual-properties-devel.h>
31 #include <dali-toolkit/internal/visuals/animated-vector-image/vector-animation-manager.h>
32 #include <dali-toolkit/internal/visuals/image-visual-shader-factory.h>
33 #include <dali-toolkit/internal/visuals/visual-base-data-impl.h>
34 #include <dali-toolkit/internal/visuals/visual-factory-cache.h>
35 #include <dali-toolkit/internal/visuals/visual-string-constants.h>
36 #include <dali-toolkit/public-api/visuals/image-visual-properties.h>
37 #include <dali-toolkit/public-api/visuals/visual-properties.h>
47 const Dali::Vector4 FULL_TEXTURE_RECT(0.f, 0.f, 1.f, 1.f);
50 DALI_ENUM_TO_STRING_TABLE_BEGIN(STOP_BEHAVIOR)
51 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::StopBehavior, CURRENT_FRAME)
52 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::StopBehavior, FIRST_FRAME)
53 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::StopBehavior, LAST_FRAME)
54 DALI_ENUM_TO_STRING_TABLE_END(STOP_BEHAVIOR)
57 DALI_ENUM_TO_STRING_TABLE_BEGIN(LOOPING_MODE)
58 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::LoopingMode, RESTART)
59 DALI_ENUM_TO_STRING_WITH_SCOPE(Dali::Toolkit::DevelImageVisual::LoopingMode, AUTO_REVERSE)
60 DALI_ENUM_TO_STRING_TABLE_END(LOOPING_MODE)
62 #if defined(DEBUG_ENABLED)
63 Debug::Filter* gVectorAnimationLogFilter = Debug::Filter::New(Debug::NoLogging, false, "LOG_VECTOR_ANIMATION");
66 } // unnamed namespace
68 AnimatedVectorImageVisualPtr AnimatedVectorImageVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl, const Property::Map& properties)
70 AnimatedVectorImageVisualPtr visual(new AnimatedVectorImageVisual(factoryCache, shaderFactory, imageUrl));
71 visual->SetProperties(properties);
76 AnimatedVectorImageVisualPtr AnimatedVectorImageVisual::New(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl)
78 AnimatedVectorImageVisualPtr visual(new AnimatedVectorImageVisual(factoryCache, shaderFactory, imageUrl));
83 AnimatedVectorImageVisual::AnimatedVectorImageVisual(VisualFactoryCache& factoryCache, ImageVisualShaderFactory& shaderFactory, const VisualUrl& imageUrl)
84 : Visual::Base(factoryCache, Visual::FittingMode::FILL, static_cast<Toolkit::Visual::Type>(Toolkit::DevelVisual::ANIMATED_VECTOR_IMAGE)),
87 mVectorAnimationTask(new VectorAnimationTask(factoryCache)),
88 mImageVisualShaderFactory(shaderFactory),
90 mVisualScale(Vector2::ONE),
92 mPlayState(DevelImageVisual::PlayState::STOPPED),
93 mEventCallback(nullptr),
95 mRendererAdded(false),
97 mRedrawInScalingDown(true)
99 // the rasterized image is with pre-multiplied alpha format
100 mImpl->mFlags |= Impl::IS_PREMULTIPLIED_ALPHA;
102 if(!mVectorAnimationTask->Load(mUrl.GetUrl()))
107 mVectorAnimationTask->UploadCompletedSignal().Connect(this, &AnimatedVectorImageVisual::OnUploadCompleted);
108 mVectorAnimationTask->SetAnimationFinishedCallback(new EventThreadCallback(MakeCallback(this, &AnimatedVectorImageVisual::OnAnimationFinished)));
110 auto& vectorAnimationManager = mFactoryCache.GetVectorAnimationManager();
111 vectorAnimationManager.AddObserver(*this);
114 AnimatedVectorImageVisual::~AnimatedVectorImageVisual()
118 auto& vectorAnimationManager = mFactoryCache.GetVectorAnimationManager();
119 vectorAnimationManager.RemoveObserver(*this);
123 mFactoryCache.GetVectorAnimationManager().UnregisterEventCallback(mEventCallback);
126 // Finalize animation task and disconnect the signal in the main thread
127 mVectorAnimationTask->UploadCompletedSignal().Disconnect(this, &AnimatedVectorImageVisual::OnUploadCompleted);
128 mVectorAnimationTask->Finalize();
132 void AnimatedVectorImageVisual::VectorAnimationManagerDestroyed()
134 // Core is shutting down. Don't talk to the plugin any more.
135 mCoreShutdown = true;
138 void AnimatedVectorImageVisual::GetNaturalSize(Vector2& naturalSize)
140 if(mVisualSize != Vector2::ZERO)
142 naturalSize = mVisualSize;
146 uint32_t width, height;
147 mVectorAnimationTask->GetDefaultSize(width, height);
148 naturalSize.x = width;
149 naturalSize.y = height;
152 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::GetNaturalSize: w = %f, h = %f [%p]\n", naturalSize.width, naturalSize.height, this);
155 void AnimatedVectorImageVisual::DoCreatePropertyMap(Property::Map& map) const
158 map.Insert(Toolkit::Visual::Property::TYPE, Toolkit::DevelVisual::ANIMATED_VECTOR_IMAGE);
161 map.Insert(Toolkit::ImageVisual::Property::URL, mUrl.GetUrl());
163 map.Insert(Toolkit::DevelImageVisual::Property::LOOP_COUNT, mAnimationData.loopCount);
165 uint32_t startFrame, endFrame;
166 mVectorAnimationTask->GetPlayRange(startFrame, endFrame);
168 Property::Array playRange;
169 playRange.PushBack(static_cast<int32_t>(startFrame));
170 playRange.PushBack(static_cast<int32_t>(endFrame));
171 map.Insert(Toolkit::DevelImageVisual::Property::PLAY_RANGE, playRange);
173 map.Insert(Toolkit::DevelImageVisual::Property::PLAY_STATE, static_cast<int32_t>(mPlayState));
174 map.Insert(Toolkit::DevelImageVisual::Property::CURRENT_FRAME_NUMBER, static_cast<int32_t>(mVectorAnimationTask->GetCurrentFrameNumber()));
175 map.Insert(Toolkit::DevelImageVisual::Property::TOTAL_FRAME_NUMBER, static_cast<int32_t>(mVectorAnimationTask->GetTotalFrameNumber()));
177 map.Insert(Toolkit::DevelImageVisual::Property::STOP_BEHAVIOR, mAnimationData.stopBehavior);
178 map.Insert(Toolkit::DevelImageVisual::Property::LOOPING_MODE, mAnimationData.loopingMode);
179 map.Insert(Toolkit::DevelImageVisual::Property::REDRAW_IN_SCALING_DOWN, mRedrawInScalingDown);
181 Property::Map layerInfo;
182 mVectorAnimationTask->GetLayerInfo(layerInfo);
183 map.Insert(Toolkit::DevelImageVisual::Property::CONTENT_INFO, layerInfo);
186 void AnimatedVectorImageVisual::DoCreateInstancePropertyMap(Property::Map& map) const
191 void AnimatedVectorImageVisual::DoSetProperties(const Property::Map& propertyMap)
193 // url already passed in from constructor
194 for(Property::Map::SizeType iter = 0; iter < propertyMap.Count(); ++iter)
196 KeyValuePair keyValue = propertyMap.GetKeyValue(iter);
197 if(keyValue.first.type == Property::Key::INDEX)
199 DoSetProperty(keyValue.first.indexKey, keyValue.second);
203 if(keyValue.first == LOOP_COUNT_NAME)
205 DoSetProperty(Toolkit::DevelImageVisual::Property::LOOP_COUNT, keyValue.second);
207 else if(keyValue.first == PLAY_RANGE_NAME)
209 DoSetProperty(Toolkit::DevelImageVisual::Property::PLAY_RANGE, keyValue.second);
211 else if(keyValue.first == STOP_BEHAVIOR_NAME)
213 DoSetProperty(Toolkit::DevelImageVisual::Property::STOP_BEHAVIOR, keyValue.second);
215 else if(keyValue.first == LOOPING_MODE_NAME)
217 DoSetProperty(Toolkit::DevelImageVisual::Property::LOOPING_MODE, keyValue.second);
219 else if(keyValue.first == REDRAW_IN_SCALING_DOWN_NAME)
221 DoSetProperty(Toolkit::DevelImageVisual::Property::REDRAW_IN_SCALING_DOWN, keyValue.second);
226 TriggerVectorRasterization();
229 void AnimatedVectorImageVisual::DoSetProperty(Property::Index index, const Property::Value& value)
233 case Toolkit::DevelImageVisual::Property::LOOP_COUNT:
236 if(value.Get(loopCount))
238 mAnimationData.loopCount = loopCount;
239 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_LOOP_COUNT;
243 case Toolkit::DevelImageVisual::Property::PLAY_RANGE:
245 const Property::Array* array = value.GetArray();
248 mAnimationData.playRange = *array;
249 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_PLAY_RANGE;
253 case Toolkit::DevelImageVisual::Property::STOP_BEHAVIOR:
255 int32_t stopBehavior = mAnimationData.stopBehavior;
256 if(Scripting::GetEnumerationProperty(value, STOP_BEHAVIOR_TABLE, STOP_BEHAVIOR_TABLE_COUNT, stopBehavior))
258 mAnimationData.stopBehavior = DevelImageVisual::StopBehavior::Type(stopBehavior);
259 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_STOP_BEHAVIOR;
263 case Toolkit::DevelImageVisual::Property::LOOPING_MODE:
265 int32_t loopingMode = mAnimationData.loopingMode;
266 if(Scripting::GetEnumerationProperty(value, LOOPING_MODE_TABLE, LOOPING_MODE_TABLE_COUNT, loopingMode))
268 mAnimationData.loopingMode = DevelImageVisual::LoopingMode::Type(loopingMode);
269 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_LOOPING_MODE;
273 case Toolkit::DevelImageVisual::Property::REDRAW_IN_SCALING_DOWN:
276 if(value.Get(redraw))
278 mRedrawInScalingDown = redraw;
285 void AnimatedVectorImageVisual::OnInitialize(void)
287 Shader shader = GenerateShader();
289 Geometry geometry = mFactoryCache.GetGeometry(VisualFactoryCache::QUAD_GEOMETRY);
291 mImpl->mRenderer = Renderer::New(geometry, shader);
293 TextureSet textureSet = TextureSet::New();
294 mImpl->mRenderer.SetTextures(textureSet);
296 // Register transform properties
297 mImpl->mTransform.RegisterUniforms(mImpl->mRenderer, Direction::LEFT_TO_RIGHT);
300 void AnimatedVectorImageVisual::DoSetOnScene(Actor& actor)
302 // Defer the rasterisation task until we get given a size (by Size Negotiation algorithm)
304 // Hold the weak handle of the placement actor and delay the adding of renderer until the rasterization is finished.
305 mPlacementActor = actor;
309 Vector2 imageSize = Vector2::ZERO;
310 imageSize = actor.GetProperty(Actor::Property::SIZE).Get<Vector2>();
311 mFactoryCache.UpdateBrokenImageRenderer(mImpl->mRenderer, imageSize);
312 actor.AddRenderer(mImpl->mRenderer);
313 ResourceReady(Toolkit::Visual::ResourceStatus::FAILED);
317 mVectorAnimationTask->SetRenderer(mImpl->mRenderer);
319 // Add property notification for scaling & size
320 mScaleNotification = actor.AddPropertyNotification(Actor::Property::WORLD_SCALE, StepCondition(0.1f, 1.0f));
321 mScaleNotification.NotifySignal().Connect(this, &AnimatedVectorImageVisual::OnScaleNotification);
323 mSizeNotification = actor.AddPropertyNotification(Actor::Property::SIZE, StepCondition(3.0f));
324 mSizeNotification.NotifySignal().Connect(this, &AnimatedVectorImageVisual::OnSizeNotification);
326 DevelActor::VisibilityChangedSignal(actor).Connect(this, &AnimatedVectorImageVisual::OnControlVisibilityChanged);
328 Window window = DevelWindow::Get(actor);
331 DevelWindow::VisibilityChangedSignal(window).Connect(this, &AnimatedVectorImageVisual::OnWindowVisibilityChanged);
335 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::DoSetOnScene [%p]\n", this);
338 void AnimatedVectorImageVisual::DoSetOffScene(Actor& actor)
345 actor.RemoveRenderer(mImpl->mRenderer);
346 mRendererAdded = false;
349 // Remove property notification
350 actor.RemovePropertyNotification(mScaleNotification);
351 actor.RemovePropertyNotification(mSizeNotification);
353 DevelActor::VisibilityChangedSignal(actor).Disconnect(this, &AnimatedVectorImageVisual::OnControlVisibilityChanged);
355 Window window = DevelWindow::Get(actor);
358 DevelWindow::VisibilityChangedSignal(window).Disconnect(this, &AnimatedVectorImageVisual::OnWindowVisibilityChanged);
361 mPlacementActor.Reset();
363 // Reset the visual size to zero so that when adding the actor back to stage the rasterization is forced
364 mVisualSize = Vector2::ZERO;
365 mVisualScale = Vector2::ONE;
367 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::DoSetOffScene [%p]\n", this);
370 void AnimatedVectorImageVisual::OnSetTransform()
372 Vector2 visualSize = mImpl->mTransform.GetVisualSize(mImpl->mControlSize);
374 if(IsOnScene() && visualSize != mVisualSize)
376 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnSetTransform: width = %f, height = %f [%p]\n", visualSize.width, visualSize.height, this);
378 mVisualSize = visualSize;
380 SetVectorImageSize();
382 if(mPlayState == DevelImageVisual::PlayState::PLAYING && mAnimationData.playState != DevelImageVisual::PlayState::PLAYING)
384 mAnimationData.playState = DevelImageVisual::PlayState::PLAYING;
385 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_PLAY_STATE;
392 void AnimatedVectorImageVisual::UpdateShader()
396 Shader shader = GenerateShader();
397 mImpl->mRenderer.SetShader(shader);
401 void AnimatedVectorImageVisual::OnDoAction(const Property::Index actionId, const Property::Value& attributes)
403 // Check if action is valid for this visual type and perform action if possible
406 case DevelAnimatedVectorImageVisual::Action::PLAY:
408 if(IsOnScene() && mVisualSize != Vector2::ZERO)
410 if(mAnimationData.playState != DevelImageVisual::PlayState::PLAYING)
412 mAnimationData.playState = DevelImageVisual::PlayState::PLAYING;
413 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_PLAY_STATE;
416 mPlayState = DevelImageVisual::PlayState::PLAYING;
419 case DevelAnimatedVectorImageVisual::Action::PAUSE:
421 if(mAnimationData.playState == DevelImageVisual::PlayState::PLAYING)
423 mAnimationData.playState = DevelImageVisual::PlayState::PAUSED;
424 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_PLAY_STATE;
426 mPlayState = DevelImageVisual::PlayState::PAUSED;
429 case DevelAnimatedVectorImageVisual::Action::STOP:
431 if(mAnimationData.playState != DevelImageVisual::PlayState::STOPPED)
433 mAnimationData.playState = DevelImageVisual::PlayState::STOPPED;
434 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_PLAY_STATE;
436 mPlayState = DevelImageVisual::PlayState::STOPPED;
439 case DevelAnimatedVectorImageVisual::Action::JUMP_TO:
442 if(attributes.Get(frameNumber))
444 mAnimationData.currentFrame = frameNumber;
445 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_CURRENT_FRAME;
451 TriggerVectorRasterization();
454 void AnimatedVectorImageVisual::OnUploadCompleted()
456 // If weak handle is holding a placement actor, it is the time to add the renderer to actor.
457 Actor actor = mPlacementActor.GetHandle();
458 if(actor && !mRendererAdded)
460 actor.AddRenderer(mImpl->mRenderer);
461 mRendererAdded = true;
463 ResourceReady(Toolkit::Visual::ResourceStatus::READY);
465 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnUploadCompleted: Renderer is added [%p]\n", this);
469 void AnimatedVectorImageVisual::OnAnimationFinished()
471 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnAnimationFinished: action state = %d [%p]\n", mPlayState, this);
473 if(mPlayState != DevelImageVisual::PlayState::STOPPED)
475 mPlayState = DevelImageVisual::PlayState::STOPPED;
477 mAnimationData.playState = DevelImageVisual::PlayState::STOPPED;
479 if(mImpl->mEventObserver)
481 mImpl->mEventObserver->NotifyVisualEvent(*this, DevelAnimatedVectorImageVisual::Signal::ANIMATION_FINISHED);
487 mImpl->mRenderer.SetProperty(DevelRenderer::Property::RENDERING_BEHAVIOR, DevelRenderer::Rendering::IF_REQUIRED);
491 void AnimatedVectorImageVisual::SendAnimationData()
493 if(mAnimationData.resendFlag)
495 mVectorAnimationTask->SetAnimationData(mAnimationData);
499 if(mAnimationData.playState == DevelImageVisual::PlayState::PLAYING)
501 mImpl->mRenderer.SetProperty(DevelRenderer::Property::RENDERING_BEHAVIOR, DevelRenderer::Rendering::CONTINUOUSLY);
505 mImpl->mRenderer.SetProperty(DevelRenderer::Property::RENDERING_BEHAVIOR, DevelRenderer::Rendering::IF_REQUIRED);
509 mAnimationData.resendFlag = 0;
513 void AnimatedVectorImageVisual::SetVectorImageSize()
515 uint32_t width = static_cast<uint32_t>(mVisualSize.width * mVisualScale.width);
516 uint32_t height = static_cast<uint32_t>(mVisualSize.height * mVisualScale.height);
518 mAnimationData.width = width;
519 mAnimationData.height = height;
520 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_SIZE;
523 void AnimatedVectorImageVisual::StopAnimation()
525 if(mAnimationData.playState != DevelImageVisual::PlayState::STOPPED)
527 mAnimationData.playState = DevelImageVisual::PlayState::STOPPED;
528 mAnimationData.resendFlag |= VectorAnimationTask::RESEND_PLAY_STATE;
530 mPlayState = DevelImageVisual::PlayState::STOPPED;
534 void AnimatedVectorImageVisual::TriggerVectorRasterization()
536 if(!mEventCallback && !mCoreShutdown)
538 mEventCallback = MakeCallback(this, &AnimatedVectorImageVisual::OnProcessEvents);
539 auto& vectorAnimationManager = mFactoryCache.GetVectorAnimationManager();
540 vectorAnimationManager.RegisterEventCallback(mEventCallback);
541 Stage::GetCurrent().KeepRendering(0.0f); // Trigger event processing
545 void AnimatedVectorImageVisual::OnScaleNotification(PropertyNotification& source)
547 Actor actor = mPlacementActor.GetHandle();
550 Vector3 scale = actor.GetProperty<Vector3>(Actor::Property::WORLD_SCALE);
552 if(mRedrawInScalingDown || scale.width >= 1.0f || scale.height >= 1.0f)
554 mVisualScale.width = scale.width;
555 mVisualScale.height = scale.height;
557 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnScaleNotification: scale = %f, %f [%p]\n", mVisualScale.width, mVisualScale.height, this);
559 SetVectorImageSize();
562 Stage::GetCurrent().KeepRendering(0.0f); // Trigger event processing
567 void AnimatedVectorImageVisual::OnSizeNotification(PropertyNotification& source)
569 Actor actor = mPlacementActor.GetHandle();
572 Vector3 size = actor.GetCurrentProperty<Vector3>(Actor::Property::SIZE);
573 mVisualSize.width = size.width;
574 mVisualSize.height = size.height;
576 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnSizeNotification: size = %f, %f [%p]\n", mVisualSize.width, mVisualSize.height, this);
578 SetVectorImageSize();
581 Stage::GetCurrent().KeepRendering(0.0f); // Trigger event processing
585 void AnimatedVectorImageVisual::OnControlVisibilityChanged(Actor actor, bool visible, DevelActor::VisibilityChange::Type type)
590 TriggerVectorRasterization();
592 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnControlVisibilityChanged: invisibile. Pause animation [%p]\n", this);
596 void AnimatedVectorImageVisual::OnWindowVisibilityChanged(Window window, bool visible)
601 TriggerVectorRasterization();
603 DALI_LOG_INFO(gVectorAnimationLogFilter, Debug::Verbose, "AnimatedVectorImageVisual::OnWindowVisibilityChanged: invisibile. Pause animation [%p]\n", this);
607 void AnimatedVectorImageVisual::OnProcessEvents()
611 mEventCallback = nullptr; // The callback will be deleted in the VectorAnimationManager
614 Shader AnimatedVectorImageVisual::GenerateShader() const
617 if(mImpl->mCustomShader)
619 shader = Shader::New(mImpl->mCustomShader->mVertexShader.empty() ? mImageVisualShaderFactory.GetVertexShaderSource().data() : mImpl->mCustomShader->mVertexShader,
620 mImpl->mCustomShader->mFragmentShader.empty() ? mImageVisualShaderFactory.GetFragmentShaderSource().data() : mImpl->mCustomShader->mFragmentShader,
621 mImpl->mCustomShader->mHints);
623 shader.RegisterProperty(PIXEL_AREA_UNIFORM_NAME, FULL_TEXTURE_RECT);
627 shader = mImageVisualShaderFactory.GetShader(
629 ImageVisualShaderFeature::FeatureBuilder()
630 .EnableRoundedCorner(IsRoundedCornerRequired())
631 .EnableBorderline(IsBorderlineRequired())
638 } // namespace Internal
640 } // namespace Toolkit