dali/internal/window-system/common/window-base.h

   1 #ifndef DALI_INTERNAL_WINDOWSYSTEM_COMMON_WINDOW_BASE_H
   2 #define DALI_INTERNAL_WINDOWSYSTEM_COMMON_WINDOW_BASE_H
   3
   4 /*
   5  * Copyright (c) 2021 Samsung Electronics Co., Ltd.
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  * http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  *
  19  */
  20
  21 // EXTERNAL INCLUDES
  22 #include <dali/integration-api/events/key-event-integ.h>
  23 #include <dali/integration-api/events/point.h>
  24 #include <dali/integration-api/events/wheel-event-integ.h>
  25 #include <cstdint>
  26 #include <string>
  27 #include <vector>
  28
  29 // INTERNAL INCLUDES
  30 #include <dali/devel-api/adaptor-framework/window-devel.h>
  31 #include <dali/internal/graphics/gles/egl-implementation.h>
  32 #include <dali/internal/window-system/common/damage-observer.h>
  33 #include <dali/internal/window-system/common/rotation-event.h>
  34 #include <dali/public-api/adaptor-framework/key-grab.h>
  35 #include <dali/public-api/adaptor-framework/style-change.h>
  36 #include <dali/public-api/adaptor-framework/window-enumerations.h>
  37 #include <dali/public-api/adaptor-framework/window.h>
  38
  39 namespace Dali
  40 {
  41 namespace Internal
  42 {
  43 namespace Adaptor
  44 {
  45 /**
  46  * WindowBase interface
  47  */
  48 class WindowBase
  49 {
  50 public:
  51   /**
  52    * @brief Struct used to retrieve accessibility information
  53    */
  54   struct AccessibilityInfo
  55   {
  56     int gestureValue;
  57     int startX;
  58     int startY;
  59     int endX;
  60     int endY;
  61     int state;
  62     int eventTime;
  63   };
  64
  65   // Window
  66   typedef Signal<void(bool)>                                IconifySignalType;
  67   typedef Signal<void(bool)>                                FocusSignalType;
  68   typedef Signal<void()>                                    OutputSignalType;
  69   typedef Signal<void()>                                    DeleteSignalType;
  70   typedef Signal<void(const DamageArea&)>                   DamageSignalType;
  71   typedef Signal<void(const RotationEvent&)>                RotationSignalType;
  72   typedef Signal<void(WindowEffectState, WindowEffectType)> TransitionEffectEventSignalType;
  73   typedef Signal<void()>                                    KeyboardRepeatSettingsChangedSignalType;
  74   typedef Signal<void()>                                    WindowRedrawRequestSignalType;
  75   typedef Signal<void(Dali::PositionSize&)>                 UpdatePositionSizeType;
  76
  77   // Input events
  78   typedef Signal<void(Integration::Point&, uint32_t)> TouchEventSignalType;
  79   typedef Signal<void(Integration::WheelEvent&)>      WheelEventSignalType;
  80   typedef Signal<void(Integration::KeyEvent&)>        KeyEventSignalType;
  81
  82   // Clipboard
  83   typedef Signal<void(void*)> SelectionSignalType;
  84
  85   // Accessibility
  86   typedef Signal<void(StyleChange::Type)>        StyleSignalType;
  87   typedef Signal<void(const AccessibilityInfo&)> AccessibilitySignalType;
  88
  89   /**
  90    * @brief Default constructor
  91    */
  92   WindowBase();
  93
  94   /**
  95    * @brief Destructor
  96    */
  97   virtual ~WindowBase();
  98
  99 public:
 100   /**
 101    * @brief Get the native window handle
 102    * @return The native window handle
 103    */
 104   virtual Any GetNativeWindow() = 0;
 105
 106   /**
 107    * @brief Get the native window id
 108    * @return The native window id
 109    */
 110   virtual int GetNativeWindowId() = 0;
 111
 112   /**
 113    * @brief Create the egl window
 114    */
 115   virtual EGLNativeWindowType CreateEglWindow(int width, int height) = 0;
 116
 117   /**
 118    * @brief Destroy the egl window
 119    */
 120   virtual void DestroyEglWindow() = 0;
 121
 122   /**
 123    * @brief Set the egl window rotation
 124    */
 125   virtual void SetEglWindowRotation(int angle) = 0;
 126
 127   /**
 128    * @brief Set the egl window buffer transform
 129    */
 130   virtual void SetEglWindowBufferTransform(int angle) = 0;
 131
 132   /**
 133    * @brief Set the egl window transform
 134    */
 135   virtual void SetEglWindowTransform(int angle) = 0;
 136
 137   /**
 138    * @brief Resize the egl window
 139    */
 140   virtual void ResizeEglWindow(Dali::PositionSize positionSize) = 0;
 141
 142   /**
 143    * @brief Returns whether the egl window support rotation or not
 144    */
 145   virtual bool IsEglWindowRotationSupported() = 0;
 146
 147   /**
 148    * @brief Move the window
 149    */
 150   virtual void Move(Dali::PositionSize positionSize) = 0;
 151
 152   /**
 153    * @brief Resize the window
 154    */
 155   virtual void Resize(Dali::PositionSize positionSize) = 0;
 156
 157   /**
 158    * @brief Move and resize the window
 159    */
 160   virtual void MoveResize(Dali::PositionSize positionSize) = 0;
 161
 162   /**
 163    * @copydoc Dali::Window::SetClass()
 164    */
 165   virtual void SetClass(const std::string& name, const std::string& className) = 0;
 166
 167   /**
 168    * @copydoc Dali::Window::Raise()
 169    */
 170   virtual void Raise() = 0;
 171
 172   /**
 173    * @copydoc Dali::Window::Lower()
 174    */
 175   virtual void Lower() = 0;
 176
 177   /**
 178    * @copydoc Dali::Window::Activate()
 179    */
 180   virtual void Activate() = 0;
 181
 182   /**
 183    * @copydoc Dali::Window::SetAvailableOrientations()
 184    */
 185   virtual void SetAvailableAnlges(const std::vector<int>& angles) = 0;
 186
 187   /**
 188    * @copydoc Dali::Window::SetPreferredOrientation()
 189    */
 190   virtual void SetPreferredAngle(int angle) = 0;
 191
 192   /**
 193    * @copydoc Dali::Window::SetAcceptFocus()
 194    */
 195   virtual void SetAcceptFocus(bool accept) = 0;
 196
 197   /**
 198    * @copydoc Dali::Window::Show()
 199    */
 200   virtual void Show() = 0;
 201
 202   /**
 203    * @copydoc Dali::Window::Hide()
 204    */
 205   virtual void Hide() = 0;
 206
 207   /**
 208    * @copydoc Dali::Window::GetSupportedAuxiliaryHintCount()
 209    */
 210   virtual unsigned int GetSupportedAuxiliaryHintCount() const = 0;
 211
 212   /**
 213    * @copydoc Dali::Window::GetSupportedAuxiliaryHint()
 214    */
 215   virtual std::string GetSupportedAuxiliaryHint(unsigned int index) const = 0;
 216
 217   /**
 218    * @copydoc Dali::Window::AddAuxiliaryHint()
 219    */
 220   virtual unsigned int AddAuxiliaryHint(const std::string& hint, const std::string& value) = 0;
 221
 222   /**
 223    * @copydoc Dali::Window::RemoveAuxiliaryHint()
 224    */
 225   virtual bool RemoveAuxiliaryHint(unsigned int id) = 0;
 226
 227   /**
 228    * @copydoc Dali::Window::SetAuxiliaryHintValue()
 229    */
 230   virtual bool SetAuxiliaryHintValue(unsigned int id, const std::string& value) = 0;
 231
 232   /**
 233    * @copydoc Dali::Window::GetAuxiliaryHintValue()
 234    */
 235   virtual std::string GetAuxiliaryHintValue(unsigned int id) const = 0;
 236
 237   /**
 238    * @copydoc Dali::Window::GetAuxiliaryHintId()
 239    */
 240   virtual unsigned int GetAuxiliaryHintId(const std::string& hint) const = 0;
 241
 242   /**
 243    * @copydoc Dali::Window::SetInputRegion()
 244    */
 245   virtual void SetInputRegion(const Rect<int>& inputRegion) = 0;
 246
 247   /**
 248    * @copydoc Dali::Window::SetType()
 249    */
 250   virtual void SetType(Dali::WindowType type) = 0;
 251
 252   /**
 253    * @copydoc Dali::Window::SetNotificationLevel()
 254    */
 255   virtual bool SetNotificationLevel(Dali::WindowNotificationLevel level) = 0;
 256
 257   /**
 258    * @copydoc Dali::Window::GetNotificationLevel()
 259    */
 260   virtual Dali::WindowNotificationLevel GetNotificationLevel() const = 0;
 261
 262   /**
 263    * @copydoc Dali::Window::SetOpaqueState()
 264    */
 265   virtual void SetOpaqueState(bool opaque) = 0;
 266
 267   /**
 268    * @copydoc Dali::Window::SetScreenOffMode()
 269    */
 270   virtual bool SetScreenOffMode(WindowScreenOffMode screenOffMode) = 0;
 271
 272   /**
 273    * @copydoc Dali::Window::GetScreenOffMode()
 274    */
 275   virtual WindowScreenOffMode GetScreenOffMode() const = 0;
 276
 277   /**
 278    * @copydoc Dali::Window::SetBrightness()
 279    */
 280   virtual bool SetBrightness(int brightness) = 0;
 281
 282   /**
 283    * @copydoc Dali::Window::GetBrightness()
 284    */
 285   virtual int GetBrightness() const = 0;
 286
 287   /**
 288    * @copydoc Dali::KeyGrab::GrabKey()
 289    */
 290   virtual bool GrabKey(Dali::KEY key, KeyGrab::KeyGrabMode grabMode) = 0;
 291
 292   /**
 293    * @copydoc Dali::KeyGrab::UngrabKey()
 294    */
 295   virtual bool UngrabKey(Dali::KEY key) = 0;
 296
 297   /**
 298    * @copydoc Dali::KeyGrab::GrabKeyList()
 299    */
 300   virtual bool GrabKeyList(const Dali::Vector<Dali::KEY>& key, const Dali::Vector<KeyGrab::KeyGrabMode>& grabMode, Dali::Vector<bool>& result) = 0;
 301
 302   /**
 303    * @copydoc Dali::KeyGrab::UngrabKeyList()
 304    */
 305   virtual bool UngrabKeyList(const Dali::Vector<Dali::KEY>& key, Dali::Vector<bool>& result) = 0;
 306
 307   /**
 308    * @brief Get DPI
 309    * @param[out] dpiHorizontal set to the horizontal dpi
 310    * @param[out] dpiVertical set to the vertical dpi
 311    */
 312   virtual void GetDpi(unsigned int& dpiHorizontal, unsigned int& dpiVertical) = 0;
 313
 314   /**
 315    * @brief Return the orientation of the surface.
 316    * @return The orientation
 317    */
 318   virtual int GetOrientation() const = 0;
 319
 320   /**
 321    * @brief Get the screen rotation angle of the window
 322    */
 323   virtual int GetScreenRotationAngle() = 0;
 324
 325   /**
 326    * @brief Set the rotation angle of the window
 327    */
 328   virtual void SetWindowRotationAngle(int degree) = 0;
 329
 330   /**
 331    * @brief Inform the window rotation is completed
 332    */
 333   virtual void WindowRotationCompleted(int degree, int width, int height) = 0;
 334
 335   /**
 336    * @copydoc Dali::Window::SetTransparency()
 337    */
 338   virtual void SetTransparency(bool transparent) = 0;
 339
 340   /**
 341    * @copydoc Dali::Window::SetParent()
 342    */
 343   virtual void SetParent(WindowBase* parentWinBase) = 0;
 344
 345   /**
 346    * @brief Create a sync fence that can tell the frame is rendered by the graphics driver.
 347    * @return The file descriptor that tells when it is rendered.
 348    */
 349   virtual int CreateFrameRenderedSyncFence() = 0;
 350
 351   /**
 352    * @brief Create a sync fence that can tell the frame is presented by the display server.
 353    * @return The file descriptor that tells when it is presented.
 354    */
 355   virtual int CreateFramePresentedSyncFence() = 0;
 356
 357   // Signals
 358
 359   /**
 360    * @brief This signal is emitted when the window becomes iconified or deiconified.
 361    */
 362   IconifySignalType& IconifyChangedSignal();
 363
 364   /**
 365    * @brief This signal is emitted when the window focus is changed.
 366    */
 367   FocusSignalType& FocusChangedSignal();
 368
 369   /**
 370    * @brief This signal is emitted when the output is transformed.
 371    */
 372   OutputSignalType& OutputTransformedSignal();
 373
 374   /**
 375    * @brief This signal is emitted when the window receives a delete request.
 376    */
 377   DeleteSignalType& DeleteRequestSignal();
 378
 379   /**
 380    * @brief This signal is emitted when the window is damaged.
 381    */
 382   DamageSignalType& WindowDamagedSignal();
 383
 384   /**
 385    * @brief This signal is emitted when a rotation event is recevied.
 386    */
 387   RotationSignalType& RotationSignal();
 388
 389   /**
 390    * @brief This signal is emitted when a touch event is received.
 391    */
 392   TouchEventSignalType& TouchEventSignal();
 393
 394   /**
 395    * @brief This signal is emitted when a mouse wheel is received.
 396    */
 397   WheelEventSignalType& WheelEventSignal();
 398
 399   /**
 400    * @brief This signal is emitted when a key event is received.
 401    */
 402   KeyEventSignalType& KeyEventSignal();
 403
 404   /**
 405    * @brief This signal is emitted when the source window notifies us the content in clipboard is selected.
 406    */
 407   SelectionSignalType& SelectionDataSendSignal();
 408
 409   /**
 410    * @brief This signal is emitted when the source window sends us about the selected content.
 411    */
 412   SelectionSignalType& SelectionDataReceivedSignal();
 413
 414   /**
 415    * @brief This signal is emitted when the style is changed.
 416    */
 417   StyleSignalType& StyleChangedSignal();
 418
 419   /**
 420    * @brief This signal is emitted when an accessibility event is received.
 421    */
 422   AccessibilitySignalType& AccessibilitySignal();
 423
 424   /**
 425    * @brief This signal is emitted when window's transition animation is started or ended.
 426    */
 427   TransitionEffectEventSignalType& TransitionEffectEventSignal();
 428
 429   /**
 430    * @brief This signal is emitted when the keyboard repeat is changed.
 431    */
 432   KeyboardRepeatSettingsChangedSignalType& KeyboardRepeatSettingsChangedSignal();
 433
 434   /**
 435    * @brief This signal is emitted when the window redraw is requested.
 436    */
 437   WindowRedrawRequestSignalType& WindowRedrawRequestSignal();
 438
 439   /**
 440    * @brief This signal is emitted when the window is resized or moved by display server.
 441    */
 442   UpdatePositionSizeType& UpdatePositionSizeSignal();
 443
 444 protected:
 445   // Undefined
 446   WindowBase(const WindowBase&) = delete;
 447
 448   // Undefined
 449   WindowBase& operator=(const WindowBase& rhs) = delete;
 450
 451 protected:
 452   IconifySignalType                       mIconifyChangedSignal;
 453   FocusSignalType                         mFocusChangedSignal;
 454   OutputSignalType                        mOutputTransformedSignal;
 455   DeleteSignalType                        mDeleteRequestSignal;
 456   DamageSignalType                        mWindowDamagedSignal;
 457   RotationSignalType                      mRotationSignal;
 458   TouchEventSignalType                    mTouchEventSignal;
 459   WheelEventSignalType                    mWheelEventSignal;
 460   KeyEventSignalType                      mKeyEventSignal;
 461   SelectionSignalType                     mSelectionDataSendSignal;
 462   SelectionSignalType                     mSelectionDataReceivedSignal;
 463   StyleSignalType                         mStyleChangedSignal;
 464   AccessibilitySignalType                 mAccessibilitySignal;
 465   TransitionEffectEventSignalType         mTransitionEffectEventSignal;
 466   KeyboardRepeatSettingsChangedSignalType mKeyboardRepeatSettingsChangedSignal;
 467   WindowRedrawRequestSignalType           mWindowRedrawRequestSignal;
 468   UpdatePositionSizeType                  mUpdatePositionSizeSignal;
 469
 470 };
 471
 472 } // namespace Adaptor
 473
 474 } // namespace Internal
 475
 476 } // namespace Dali
 477
 478 #endif // DALI_INTERNAL_WINDOWSYSTEM_COMMON_WINDOW_BASE_H