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/internal/event/common/stage-impl.h>
24 #include <cstring> // for strcmp
27 #include <dali/integration-api/platform-abstraction.h>
28 #include <dali/internal/event/actors/camera-actor-impl.h>
29 #include <dali/internal/event/actors/layer-impl.h>
30 #include <dali/internal/event/actors/layer-list.h>
31 #include <dali/internal/event/common/object-registry-impl.h>
32 #include <dali/internal/event/common/property-notification-manager.h>
33 #include <dali/internal/event/common/thread-local-storage.h>
34 #include <dali/internal/event/render-tasks/render-task-list-impl.h>
35 #include <dali/internal/event/update/frame-callback-interface-impl.h>
36 #include <dali/internal/update/manager/scene-graph-frame-callback.h>
37 #include <dali/internal/update/nodes/node.h>
38 #include <dali/public-api/common/constants.h>
39 #include <dali/public-api/events/touch-event.h>
40 #include <dali/public-api/object/type-registry.h>
41 #include <dali/public-api/render-tasks/render-task-list.h>
42 #include <dali/public-api/rendering/frame-buffer.h>
44 using Dali::Internal::SceneGraph::Node;
48 #if defined(DEBUG_ENABLED)
49 Debug::Filter* gLogFilter = Debug::Filter::New(Debug::NoLogging, false, "LOG_DEPTH_TIMER");
61 static constexpr std::string_view SIGNAL_KEY_EVENT = "keyEvent";
62 static constexpr std::string_view SIGNAL_KEY_EVENT_GENERATED = "keyEventGenerated";
63 static constexpr std::string_view SIGNAL_EVENT_PROCESSING_FINISHED = "eventProcessingFinished";
64 static constexpr std::string_view SIGNAL_TOUCHED = "touched";
65 static constexpr std::string_view SIGNAL_WHEEL_EVENT = "wheelEvent";
66 static constexpr std::string_view SIGNAL_CONTEXT_LOST = "contextLost";
67 static constexpr std::string_view SIGNAL_CONTEXT_REGAINED = "contextRegained";
68 static constexpr std::string_view SIGNAL_SCENE_CREATED = "sceneCreated";
70 TypeRegistration mType(typeid(Dali::Stage), typeid(Dali::BaseHandle), nullptr);
72 SignalConnectorType signalConnector1(mType, std::string(SIGNAL_KEY_EVENT), &Stage::DoConnectSignal);
73 SignalConnectorType signalConnector2(mType, std::string(SIGNAL_EVENT_PROCESSING_FINISHED), &Stage::DoConnectSignal);
74 SignalConnectorType signalConnector4(mType, std::string(SIGNAL_WHEEL_EVENT), &Stage::DoConnectSignal);
75 SignalConnectorType signalConnector5(mType, std::string(SIGNAL_CONTEXT_LOST), &Stage::DoConnectSignal);
76 SignalConnectorType signalConnector6(mType, std::string(SIGNAL_CONTEXT_REGAINED), &Stage::DoConnectSignal);
77 SignalConnectorType signalConnector7(mType, std::string(SIGNAL_SCENE_CREATED), &Stage::DoConnectSignal);
78 SignalConnectorType signalConnector8(mType, std::string(SIGNAL_KEY_EVENT_GENERATED), &Stage::DoConnectSignal);
79 SignalConnectorType signalConnector9(mType, std::string(SIGNAL_TOUCHED), &Stage::DoConnectSignal);
81 } // unnamed namespace
83 StagePtr Stage::New(SceneGraph::UpdateManager& updateManager)
85 return StagePtr(new Stage(updateManager));
88 void Stage::Initialize(Scene& scene)
91 mScene->SetBackgroundColor(Dali::DEFAULT_BACKGROUND_COLOR);
92 mScene->EventProcessingFinishedSignal().Connect(this, &Stage::OnEventProcessingFinished);
93 mScene->KeyEventSignal().Connect(this, &Stage::OnKeyEvent);
94 mScene->TouchedSignal().Connect(this, &Stage::OnTouchEvent);
95 mScene->WheelEventSignal().Connect(this, &Stage::OnWheelEvent);
98 StagePtr Stage::GetCurrent()
100 StagePtr stage(nullptr);
101 // no checking in this version
102 ThreadLocalStorage* tls = ThreadLocalStorage::GetInternal();
105 stage = tls->GetCurrentStage();
110 bool Stage::IsInstalled()
112 return ThreadLocalStorage::Created();
115 bool Stage::IsShuttingDown()
117 return ThreadLocalStorage::IsShuttingDown();
120 ObjectRegistry& Stage::GetObjectRegistry()
122 return ThreadLocalStorage::Get().GetObjectRegistry();
125 Layer& Stage::GetRootActor()
127 Dali::Layer rootLayer = GetRootLayer();
128 return GetImplementation(rootLayer);
131 void Stage::Add(Actor& actor)
136 void Stage::Remove(Actor& actor)
138 mScene->Remove(actor);
141 Vector2 Stage::GetSize() const
143 return mScene->GetSize();
146 RenderTaskList& Stage::GetRenderTaskList() const
148 return mScene->GetRenderTaskList();
151 Actor& Stage::GetDefaultRootActor()
153 return mScene->GetDefaultRootActor();
156 CameraActor& Stage::GetDefaultCameraActor() const
158 return mScene->GetDefaultCameraActor();
161 uint32_t Stage::GetLayerCount() const
163 return mScene->GetLayerCount();
166 Dali::Layer Stage::GetLayer(uint32_t depth) const
168 return mScene->GetLayer(depth);
171 Dali::Layer Stage::GetRootLayer() const
173 return mScene->GetRootLayer();
176 LayerList& Stage::GetLayerList()
178 return mScene->GetLayerList();
181 void Stage::SetBackgroundColor(Vector4 color)
183 mScene->SetBackgroundColor(color);
186 Vector4 Stage::GetBackgroundColor() const
188 return mScene->GetBackgroundColor();
191 Vector2 Stage::GetDpi() const
193 return mScene->GetDpi();
196 void Stage::KeepRendering(float durationSeconds)
198 // Send message to keep rendering
199 KeepRenderingMessage(mUpdateManager, durationSeconds);
202 void Stage::SetRenderingBehavior(DevelStage::Rendering renderingBehavior)
204 if(mRenderingBehavior != renderingBehavior)
206 // Send message to change the rendering behavior
207 SetRenderingBehaviorMessage(mUpdateManager, renderingBehavior);
209 mRenderingBehavior = renderingBehavior;
213 DevelStage::Rendering Stage::GetRenderingBehavior() const
215 return mRenderingBehavior;
218 Dali::UpdateProxy::NotifySyncPoint Stage::NotifyFrameCallback(FrameCallbackInterface& frameCallback)
220 static Dali::UpdateProxy::NotifySyncPoint sSyncPoint = 0;
223 NotifyFrameCallbackMessage(mUpdateManager, &frameCallback, sSyncPoint);
227 bool Stage::DoConnectSignal(BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor)
229 bool connected(true);
230 Stage* stage = static_cast<Stage*>(object); // TypeRegistry guarantees that this is the correct type.
231 std::string_view name(signalName);
233 if(name == SIGNAL_KEY_EVENT)
235 stage->KeyEventSignal().Connect(tracker, functor);
237 else if(name == SIGNAL_KEY_EVENT_GENERATED)
239 stage->KeyEventGeneratedSignal().Connect(tracker, functor);
241 else if(name == SIGNAL_EVENT_PROCESSING_FINISHED)
243 stage->EventProcessingFinishedSignal().Connect(tracker, functor);
245 else if(name == SIGNAL_TOUCHED)
247 stage->TouchedSignal().Connect(tracker, functor);
249 else if(name == SIGNAL_WHEEL_EVENT)
251 stage->WheelEventSignal().Connect(tracker, functor);
253 else if(name == SIGNAL_CONTEXT_LOST)
255 stage->ContextLostSignal().Connect(tracker, functor);
257 else if(name == SIGNAL_CONTEXT_REGAINED)
259 stage->ContextRegainedSignal().Connect(tracker, functor);
261 else if(name == SIGNAL_SCENE_CREATED)
263 stage->SceneCreatedSignal().Connect(tracker, functor);
267 // signalName does not match any signal
274 void Stage::OnEventProcessingFinished()
276 EmitEventProcessingFinishedSignal();
279 void Stage::OnKeyEvent(const Dali::KeyEvent& event)
281 bool consumed = EmitKeyEventGeneratedSignal(event);
284 EmitKeyEventSignal(event);
288 void Stage::OnTouchEvent(const Dali::TouchEvent& touch)
290 EmitTouchedSignal(touch);
293 void Stage::OnWheelEvent(const Dali::WheelEvent& event)
295 EmitWheelEventSignal(event);
298 void Stage::EmitKeyEventSignal(const KeyEvent& event)
300 // Emit the key event signal when no actor in the stage has gained the key input focus
302 mKeyEventSignal.Emit(event);
305 bool Stage::EmitKeyEventGeneratedSignal(const KeyEvent& event)
307 // Emit the KeyEventGenerated signal when KeyEvent is generated
309 return mKeyEventGeneratedSignal.Emit(event);
312 void Stage::EmitEventProcessingFinishedSignal()
314 mEventProcessingFinishedSignal.Emit();
317 void Stage::EmitTouchedSignal(const Dali::TouchEvent& touch)
319 mTouchedSignal.Emit(touch);
322 void Stage::EmitWheelEventSignal(const WheelEvent& event)
324 // Emit the wheel event signal when no actor in the stage has gained the wheel input focus
326 mWheelEventSignal.Emit(event);
329 void Stage::EmitSceneCreatedSignal()
331 mSceneCreatedSignal.Emit();
334 Dali::Stage::KeyEventSignalType& Stage::KeyEventSignal()
336 return mKeyEventSignal;
339 Dali::DevelStage::KeyEventGeneratedSignalType& Stage::KeyEventGeneratedSignal()
341 return mKeyEventGeneratedSignal;
344 void Stage::AddFrameCallback(FrameCallbackInterface& frameCallback, Actor& rootActor)
346 DALI_ASSERT_ALWAYS((!FrameCallbackInterface::Impl::Get(frameCallback).IsConnectedToSceneGraph()) && "FrameCallbackInterface implementation already added");
348 // Create scene-graph object and transfer to UpdateManager
349 OwnerPointer<SceneGraph::FrameCallback> transferOwnership(SceneGraph::FrameCallback::New(frameCallback));
350 AddFrameCallbackMessage(mUpdateManager, transferOwnership, rootActor.GetNode());
353 void Stage::AddGlobalFrameCallback(FrameCallbackInterface& frameCallback)
355 DALI_ASSERT_ALWAYS((!FrameCallbackInterface::Impl::Get(frameCallback).IsConnectedToSceneGraph()) && "FrameCallbackInterface implementation already added");
357 // Create scene-graph object and transfer to UpdateManager
358 OwnerPointer<SceneGraph::FrameCallback> transferOwnership(SceneGraph::FrameCallback::New(frameCallback));
359 AddGlobalFrameCallbackMessage(mUpdateManager, transferOwnership);
362 void Stage::RemoveFrameCallback(FrameCallbackInterface& frameCallback)
364 FrameCallbackInterface::Impl::Get(frameCallback).Invalidate();
365 RemoveFrameCallbackMessage(mUpdateManager, frameCallback);
368 Dali::Stage::EventProcessingFinishedSignalType& Stage::EventProcessingFinishedSignal()
370 return mEventProcessingFinishedSignal;
373 Dali::Stage::TouchEventSignalType& Stage::TouchedSignal()
375 return mTouchedSignal;
378 Dali::Stage::WheelEventSignalType& Stage::WheelEventSignal()
380 return mWheelEventSignal;
383 Dali::Stage::ContextStatusSignal& Stage::ContextLostSignal()
385 return mContextLostSignal;
388 Dali::Stage::ContextStatusSignal& Stage::ContextRegainedSignal()
390 return mContextRegainedSignal;
393 Dali::Stage::SceneCreatedSignalType& Stage::SceneCreatedSignal()
395 return mSceneCreatedSignal;
398 void Stage::NotifyContextLost()
400 mContextLostSignal.Emit();
403 void Stage::NotifyContextRegained()
405 mContextRegainedSignal.Emit();
408 Stage::Stage(SceneGraph::UpdateManager& updateManager)
409 : mUpdateManager(updateManager),
411 mKeyEventGeneratedSignal(),
412 mEventProcessingFinishedSignal(),
415 mContextLostSignal(),
416 mContextRegainedSignal(),
417 mSceneCreatedSignal(),
418 mRenderingBehavior(DevelStage::Rendering::IF_REQUIRED)
422 Stage::~Stage() = default;
424 } // namespace Internal