2 * Copyright (c) 2023 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/adaptor/common/application-impl.h>
22 #include <dali/devel-api/common/singleton-service.h>
23 #include <dali/integration-api/debug.h>
24 #include <dali/integration-api/trace.h>
25 #include <dali/public-api/object/object-registry.h>
28 #include <dali/devel-api/adaptor-framework/accessibility-bridge.h>
29 #include <dali/devel-api/adaptor-framework/environment-variable.h>
30 #include <dali/devel-api/adaptor-framework/style-monitor.h>
31 #include <dali/devel-api/atspi-interfaces/accessible.h>
32 #include <dali/devel-api/text-abstraction/font-client.h>
33 #include <dali/internal/adaptor/common/adaptor-impl.h>
34 #include <dali/internal/adaptor/common/framework-factory.h>
35 #include <dali/internal/adaptor/common/framework.h>
36 #include <dali/internal/adaptor/common/lifecycle-controller-impl.h>
37 #include <dali/internal/system/common/command-line-options.h>
38 #include <dali/internal/system/common/environment-variables.h>
39 #include <dali/internal/system/common/system-settings.h>
40 #include <dali/internal/window-system/common/render-surface-factory.h>
41 #include <dali/internal/window-system/common/window-impl.h>
42 #include <dali/internal/window-system/common/window-render-surface.h>
43 #include <dali/internal/window-system/common/window-system.h>
45 // To disable a macro with the same name from one of OpenGL headers
50 namespace TizenPlatform
52 class TizenPlatformAbstraction;
64 DALI_INIT_TRACE_FILTER(gTraceFilter, DALI_TRACE_APPLICATION, true);
66 ApplicationPtr Application::gPreInitializedApplication(NULL);
68 ApplicationPtr Application::New(
71 const std::string& stylesheet,
72 Framework::Type applicationType,
74 const WindowData& windowData)
76 ApplicationPtr application(new Application(argc, argv, stylesheet, applicationType, useUiThread, windowData));
80 void Application::PreInitialize(int* argc, char** argv[])
82 if(!gPreInitializedApplication)
84 char* retEnv = std::getenv("TIZEN_UI_THREAD");
85 bool isUseUIThread = false;
88 std::string uiThreadEnv = retEnv;
89 std::string enabledString = "true";
90 if(uiThreadEnv == enabledString)
96 Dali::TextAbstraction::FontClientPreInitialize();
97 WindowData windowData;
98 gPreInitializedApplication = new Application(argc, argv, "", Framework::NORMAL, isUseUIThread, windowData);
99 gPreInitializedApplication->mLaunchpadState = Launchpad::PRE_INITIALIZED;
102 DALI_LOG_RELEASE_INFO("PRE_INITIALIZED with UI Threading");
103 gPreInitializedApplication->mUIThreadLoader = new UIThreadLoader(argc, argv);
104 gPreInitializedApplication->mUIThreadLoader->Run([&]() { gPreInitializedApplication->CreateWindow(); });
108 DALI_LOG_RELEASE_INFO("Only PRE_INITIALIZED");
109 gPreInitializedApplication->CreateWindow(); // Only create window
114 Application::Application(int* argc, char** argv[], const std::string& stylesheet, Framework::Type applicationType, bool useUiThread, const WindowData& windowData)
121 mLanguageChangedSignal(),
122 mRegionChangedSignal(),
124 mFrameworkFactory(nullptr),
125 mCommandLineOptions(nullptr),
126 mAdaptorBuilder(nullptr),
128 mEnvironmentOptions(nullptr),
130 mMainWindowMode(windowData.GetTransparency() ? WINDOW_MODE::TRANSPARENT : WINDOW_MODE::OPAQUE),
132 mStylesheet(stylesheet),
133 mWindowPositionSize(windowData.GetPositionSize()),
134 mLaunchpadState(Launchpad::NONE),
135 mDefaultWindowType(windowData.GetWindowType()),
136 mUseUiThread(useUiThread),
137 mIsSystemInitialized(false),
139 mUIThreadLoader(nullptr)
141 // Set mName from command-line args
142 if(argc && (*argc > 0))
144 mMainWindowName = (*argv)[0];
147 const char* uiThreadEnabled = Dali::EnvironmentVariable::GetEnvironmentVariable(DALI_ENV_ENABLE_UI_THREAD);
148 if(uiThreadEnabled && std::atoi(uiThreadEnabled) != 0)
153 mCommandLineOptions = new CommandLineOptions(argc, argv);
155 mFrameworkFactory = std::unique_ptr<FrameworkFactory>(Dali::Internal::Adaptor::CreateFrameworkFactory());
156 mFramework = mFrameworkFactory->CreateFramework(FrameworkBackend::DEFAULT, *this, *this, argc, argv, applicationType, mUseUiThread);
158 mUseRemoteSurface = (applicationType == Framework::WATCH);
161 Application::~Application()
163 SingletonService service = SingletonService::Get();
164 // Note this can be false i.e. if Application has never created a Core instance
167 service.UnregisterAll();
172 delete mCommandLineOptions;
174 // Application is created in Main thread whether UI Threading is enabled or not.
175 // But some resources are created in Main thread or UI thread.
176 // The below code is for the resource are created in Main thread.
180 delete mAdaptorBuilder;
181 if(mIsSystemInitialized)
183 WindowSystem::Shutdown();
190 delete mUIThreadLoader;
195 void Application::StoreWindowPositionSize(PositionSize positionSize)
197 mWindowPositionSize = positionSize;
200 void Application::ChangePreInitializedWindowInfo()
203 auto windowClassName = mEnvironmentOptions->GetWindowClassName();
204 auto windowName = mEnvironmentOptions->GetWindowName();
205 if(!windowName.empty())
207 mMainWindowName = windowName;
209 mMainWindow.SetClass(mMainWindowName, windowClassName);
211 // The real screen size may be different from the value of the preinitialized state. Update it.
212 Dali::Internal::Adaptor::WindowSystem::UpdateScreenSize();
214 int screenWidth, screenHeight;
215 Dali::Internal::Adaptor::WindowSystem::GetScreenSize(screenWidth, screenHeight);
217 // Set window position / size
218 if(mWindowPositionSize != PositionSize(0, 0, 0, 0))
220 Dali::DevelWindow::SetPositionSize(mMainWindow, mWindowPositionSize);
222 else if(mCommandLineOptions->stageWidth > 0 && mCommandLineOptions->stageHeight > 0)
224 // Command line options override environment options and full screen
225 mWindowPositionSize.width = mCommandLineOptions->stageWidth;
226 mWindowPositionSize.height = mCommandLineOptions->stageHeight;
227 mMainWindow.SetSize(Dali::Window::WindowSize(mWindowPositionSize.width, mWindowPositionSize.height));
229 else if(mEnvironmentOptions->GetWindowWidth() && mEnvironmentOptions->GetWindowHeight())
231 // Environment options override full screen functionality if command line arguments not provided
232 mWindowPositionSize.width = mEnvironmentOptions->GetWindowWidth();
233 mWindowPositionSize.height = mEnvironmentOptions->GetWindowHeight();
234 mMainWindow.SetSize(Dali::Window::WindowSize(mWindowPositionSize.width, mWindowPositionSize.height));
236 else if(screenWidth != mWindowPositionSize.width || screenHeight != mWindowPositionSize.height)
238 // Some apps can receive screen size differently after launching by specifying size in manifest.
239 mWindowPositionSize.width = screenWidth;
240 mWindowPositionSize.height = screenHeight;
241 mMainWindow.SetSize(Dali::Window::WindowSize(mWindowPositionSize.width, mWindowPositionSize.height));
245 void Application::CreateWindow()
247 Internal::Adaptor::Window* window;
248 WindowData windowData;
249 windowData.SetTransparency(mMainWindowMode);
250 windowData.SetWindowType(mDefaultWindowType);
252 DALI_LOG_RELEASE_INFO("Create Default Window");
254 WindowSystem::Initialize();
255 mIsSystemInitialized = true;
257 if(mLaunchpadState != Launchpad::PRE_INITIALIZED)
259 if(mWindowPositionSize.width == 0 && mWindowPositionSize.height == 0)
261 if(mCommandLineOptions->stageWidth > 0 && mCommandLineOptions->stageHeight > 0)
263 // Command line options override environment options and full screen
264 mWindowPositionSize.width = mCommandLineOptions->stageWidth;
265 mWindowPositionSize.height = mCommandLineOptions->stageHeight;
267 else if(mEnvironmentOptions->GetWindowWidth() && mEnvironmentOptions->GetWindowHeight())
269 // Environment options override full screen functionality if command line arguments not provided
270 mWindowPositionSize.width = mEnvironmentOptions->GetWindowWidth();
271 mWindowPositionSize.height = mEnvironmentOptions->GetWindowHeight();
275 auto windowClassName = mEnvironmentOptions->GetWindowClassName();
276 auto windowName = mEnvironmentOptions->GetWindowName();
277 if(!windowName.empty())
279 mMainWindowName = windowName;
282 windowData.SetPositionSize(mWindowPositionSize);
283 window = Internal::Adaptor::Window::New(mMainWindowName, windowClassName, windowData);
287 // The position, size and the window name of the pre-initialized application will be updated in ChangePreInitializedWindowInfo()
288 // when the real application is launched.
289 windowData.SetPositionSize(mWindowPositionSize);
290 window = Internal::Adaptor::Window::New("", "", windowData);
293 mMainWindow = Dali::Window(window);
295 // Quit the application when the window is closed
296 GetImplementation(mMainWindow).DeleteRequestSignal().Connect(mSlotDelegate, &Application::Quit);
299 void Application::CreateAdaptor()
301 DALI_ASSERT_ALWAYS(mMainWindow && "Window required to create adaptor");
303 auto graphicsFactory = mAdaptorBuilder->GetGraphicsFactory();
305 Integration::SceneHolder sceneHolder = Integration::SceneHolder(&Dali::GetImplementation(mMainWindow));
307 mAdaptor = Adaptor::New(graphicsFactory, sceneHolder, mEnvironmentOptions.get());
309 Adaptor::GetImplementation(*mAdaptor).SetUseRemoteSurface(mUseRemoteSurface);
312 void Application::CreateAdaptorBuilder()
314 mAdaptorBuilder = new AdaptorBuilder(*mEnvironmentOptions);
317 void Application::MainLoop()
319 // Run the application
323 void Application::Lower()
325 // Lower the application without quitting it.
329 void Application::Quit()
331 // Actually quit the application.
332 // Force a call to Quit even if adaptor is not running.
333 Internal::Adaptor::Adaptor::GetImplementation(*mAdaptor).AddIdle(MakeCallback(this, &Application::QuitFromMainLoop), false, true);
336 void Application::QuitFromMainLoop()
338 Accessibility::Bridge::GetCurrentBridge()->Terminate();
343 // This will trigger OnTerminate(), below, after the main loop has completed.
346 void Application::OnInit()
348 mEnvironmentOptions = std::unique_ptr<EnvironmentOptions>(new EnvironmentOptions());
350 mFramework->AddAbortCallback(MakeCallback(this, &Application::QuitFromMainLoop));
352 CreateAdaptorBuilder();
353 // If an application was pre-initialized, a window was made in advance
354 if(mLaunchpadState == Launchpad::NONE)
356 DALI_LOG_RELEASE_INFO("default Window is created in standalone");
362 if(mLaunchpadState == Launchpad::PRE_INITIALIZED)
364 ChangePreInitializedWindowInfo();
368 DALI_TRACE_BEGIN(gTraceFilter, "DALI_APP_ADAPTOR_START");
370 DALI_TRACE_END(gTraceFilter, "DALI_APP_ADAPTOR_START");
371 Accessibility::Accessible::SetObjectRegistry(mAdaptor->GetObjectRegistry());
373 if(!mStylesheet.empty())
375 Dali::StyleMonitor::Get().SetTheme(mStylesheet);
378 // Wire up the LifecycleController
379 Dali::LifecycleController lifecycleController = Dali::LifecycleController::Get();
381 InitSignal().Connect(&GetImplementation(lifecycleController), &LifecycleController::OnInit);
382 TerminateSignal().Connect(&GetImplementation(lifecycleController), &LifecycleController::OnTerminate);
383 PauseSignal().Connect(&GetImplementation(lifecycleController), &LifecycleController::OnPause);
384 ResumeSignal().Connect(&GetImplementation(lifecycleController), &LifecycleController::OnResume);
385 ResetSignal().Connect(&GetImplementation(lifecycleController), &LifecycleController::OnReset);
386 LanguageChangedSignal().Connect(&GetImplementation(lifecycleController), &LifecycleController::OnLanguageChanged);
388 Dali::Application application(this);
390 DALI_TRACE_BEGIN(gTraceFilter, "DALI_APP_EMIT_INIT_SIGNAL");
391 mInitSignal.Emit(application);
392 DALI_TRACE_END(gTraceFilter, "DALI_APP_EMIT_INIT_SIGNAL");
394 mAdaptor->NotifySceneCreated();
396 // Ensure the join of Font thread at this point
397 Dali::TextAbstraction::FontClientJoinFontThreads();
400 void Application::OnTerminate()
402 // We've been told to quit by AppCore, ecore_x_destroy has been called, need to quit synchronously
403 // delete the window as ecore_x has been destroyed by AppCore
405 Dali::Application application(this);
406 mTerminateSignal.Emit(application);
410 // Ensure that the render-thread is not using the surface(window) after we delete it
414 mMainWindow.Reset(); // This only resets (clears) the default Window
416 // If DALi's UI Thread works, some resources are created in UI Thread, not Main thread.
417 // For that case, these resource should be deleted in UI Thread.
421 delete mAdaptorBuilder;
422 WindowSystem::Shutdown();
426 void Application::OnPause()
428 // A DALi app should handle Pause/Resume events.
429 // DALi just delivers the framework Pause event to the application, but not actually pause DALi core.
430 // Pausing DALi core only occurs on the Window Hidden framework event
431 Dali::Application application(this);
432 mPauseSignal.Emit(application);
435 void Application::OnResume()
437 // Emit the signal first so the application can queue any messages before we do an update/render
438 // This ensures we do not just redraw the last frame before pausing if that's not required
439 Dali::Application application(this);
440 mResumeSignal.Emit(application);
442 // DALi just delivers the framework Resume event to the application.
443 // Resuming DALi core only occurs on the Window Show framework event
445 // Trigger processing of events queued up while paused
446 CoreEventInterface& coreEventInterface = Internal::Adaptor::Adaptor::GetImplementation(GetAdaptor());
447 coreEventInterface.ProcessCoreEvents();
450 void Application::OnReset()
453 * usually, reset callback was called when a caller request to launch this application via aul.
454 * because Application class already handled initialization in OnInit(), OnReset do nothing.
456 Dali::Application application(this);
457 mResetSignal.Emit(application);
460 void Application::OnAppControl(void* data)
462 Dali::Application application(this);
463 mAppControlSignal.Emit(application, data);
466 void Application::OnLanguageChanged()
468 mAdaptor->NotifyLanguageChanged();
469 Dali::Application application(this);
470 mLanguageChangedSignal.Emit(application);
473 void Application::OnRegionChanged()
475 Dali::Application application(this);
476 mRegionChangedSignal.Emit(application);
479 void Application::OnBatteryLow(Dali::DeviceStatus::Battery::Status status)
481 Dali::Application application(this);
482 mLowBatterySignal.Emit(status);
485 void Application::OnMemoryLow(Dali::DeviceStatus::Memory::Status status)
487 Dali::Application application(this);
488 mLowMemorySignal.Emit(status);
491 void Application::OnDeviceOrientationChanged(Dali::DeviceStatus::Orientation::Status status)
493 Dali::Application application(this);
494 mDeviceOrientationChangedSignal.Emit(status);
497 void Application::OnSurfaceCreated(Any newSurface)
499 void* newWindow = AnyCast<void*>(newSurface);
500 void* oldWindow = AnyCast<void*>(mMainWindow.GetNativeHandle());
501 if(oldWindow != newWindow)
503 auto renderSurfaceFactory = Dali::Internal::Adaptor::GetRenderSurfaceFactory();
504 std::unique_ptr<WindowRenderSurface> newSurfacePtr = renderSurfaceFactory->CreateWindowRenderSurface(PositionSize(), newSurface, true);
506 mAdaptor->ReplaceSurface(mMainWindow, *newSurfacePtr.release());
510 void Application::OnSurfaceDestroyed(Any surface)
514 void Application::OnTaskInit()
516 Dali::Application application(this);
517 mTaskInitSignal.Emit(application);
520 void Application::OnTaskTerminate()
522 Dali::Application application(this);
523 mTaskTerminateSignal.Emit(application);
526 void Application::OnTaskAppControl(void* data)
528 Dali::Application application(this);
529 mTaskAppControlSignal.Emit(application, data);
532 void Application::OnTaskLanguageChanged()
534 Dali::Application application(this);
535 mTaskLanguageChangedSignal.Emit(application);
538 void Application::OnTaskRegionChanged()
540 Dali::Application application(this);
541 mTaskRegionChangedSignal.Emit(application);
544 void Application::OnTaskBatteryLow(Dali::DeviceStatus::Battery::Status status)
546 Dali::Application application(this);
547 mTaskLowBatterySignal.Emit(status);
550 void Application::OnTaskMemoryLow(Dali::DeviceStatus::Memory::Status status)
552 Dali::Application application(this);
553 mTaskLowMemorySignal.Emit(status);
556 void Application::OnTaskDeviceOrientationChanged(Dali::DeviceStatus::Orientation::Status status)
558 Dali::Application application(this);
559 mTaskDeviceOrientationChangedSignal.Emit(status);
562 bool Application::AddIdle(CallbackBase* callback, bool hasReturnValue)
564 return mAdaptor->AddIdle(callback, hasReturnValue);
567 std::string Application::GetRegion() const
569 return mFramework->GetRegion();
572 std::string Application::GetLanguage() const
574 return mFramework->GetLanguage();
577 Dali::ObjectRegistry Application::GetObjectRegistry() const
579 Dali::ObjectRegistry objectRegistry;
582 objectRegistry = mAdaptor->GetObjectRegistry();
584 return objectRegistry;
587 Dali::Adaptor& Application::GetAdaptor()
592 Dali::Window Application::GetWindow()
597 std::string Application::GetResourcePath()
599 return SystemSettings::GetResourcePath();
602 std::string Application::GetDataPath()
604 return SystemSettings::GetDataPath();
607 void Application::SetStyleSheet(const std::string& stylesheet)
609 mStylesheet = stylesheet;
612 void Application::SetCommandLineOptions(int* argc, char** argv[])
614 delete mCommandLineOptions;
616 mCommandLineOptions = new CommandLineOptions(argc, argv);
618 mFramework->SetCommandLineOptions(argc, argv);
620 if(argc && (*argc > 0))
622 // Set mName from command-line args
623 mMainWindowName = (*argv)[0];
627 void Application::SetDefaultWindowType(WindowType type)
629 mDefaultWindowType = type;
630 mMainWindow.SetType(type);
633 int32_t Application::GetRenderThreadId() const
637 return Internal::Adaptor::Adaptor::GetImplementation(*mAdaptor).GetRenderThreadId();
642 ApplicationPtr Application::GetPreInitializedApplication()
644 // Reset the handle to decrease the reference count
645 ApplicationPtr application = gPreInitializedApplication;
646 gPreInitializedApplication.Reset();
651 } // namespace Adaptor
653 } // namespace Internal