BsRenderWindow.h 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311
  1. #pragma once
  2. #include "BsCorePrerequisites.h"
  3. #include "BsRenderTarget.h"
  4. #include "BsVideoModeInfo.h"
  5. #include "BsVector2I.h"
  6. namespace BansheeEngine
  7. {
  8. /**
  9. * @brief Enum that defines possible window border styles.
  10. */
  11. enum class WindowBorder
  12. {
  13. Normal,
  14. None,
  15. Fixed
  16. };
  17. /**
  18. * @brief Structure that is used for initializing a render window.
  19. */
  20. struct BS_CORE_EXPORT RENDER_WINDOW_DESC
  21. {
  22. RENDER_WINDOW_DESC()
  23. : vsync(false), vsyncInterval(1), fullscreen(false), hidden(false), depthBuffer(true)
  24. , multisampleCount(0), multisampleHint(""), gamma(false), left(-1), top(-1)
  25. , title(""), border(WindowBorder::Normal), outerDimensions(false), enableDoubleClick(true)
  26. , toolWindow(false), modal(false)
  27. { }
  28. VideoMode videoMode; /**< A set of frame buffer options. */
  29. bool fullscreen; /**< Should the window be opened in fullscreen mode. */
  30. bool vsync; /**< Should the window wait for vertical sync before swapping buffers. */
  31. UINT32 vsyncInterval; /**< Determines how many vsync intervals occur per frame. FPS = refreshRate/interval. Usually 1 when vsync active. */
  32. bool hidden; /**< Should the window be hidden. */
  33. bool depthBuffer; /**< Should the window be created with a depth/stencil buffer. */
  34. UINT32 multisampleCount; /**< If higher than 1, texture containing multiple samples per pixel is created. */
  35. String multisampleHint; /**< Hint about what kind of multisampling to use. Render system specific. */
  36. bool gamma; /**< Should the written color pixels be gamma corrected before write. */
  37. INT32 left; /**< Window origin on X axis in pixels. -1 == screen center. Relative to monitor provided in videoMode. */
  38. INT32 top; /**< Window origin on Y axis in pixels. -1 == screen center. Relative to monitor provided in videoMode. */
  39. String title; /**< Title of the window. */
  40. WindowBorder border; /**< Type of border to create the window with. */
  41. bool outerDimensions; /**< Do our dimensions include space for things like title-bar and border. */
  42. bool enableDoubleClick; /**< Does window accept double-clicks. */
  43. bool toolWindow; /**< Tool windows have a different style than normal windows and can be created with no border or title bar. */
  44. bool modal; /**< When a modal window is open all other windows will be locked until modal window is closed. */
  45. NameValuePairList platformSpecific; /**< Platform-specific creation options. */
  46. };
  47. /**
  48. * @brief Contains various properties that describe a render window.
  49. */
  50. class BS_CORE_EXPORT RenderWindowProperties : public RenderTargetProperties
  51. {
  52. public:
  53. RenderWindowProperties(const RENDER_WINDOW_DESC& desc);
  54. virtual ~RenderWindowProperties() { }
  55. /**
  56. * @brief Gets the horizontal origin of the window in pixels.
  57. */
  58. INT32 getLeft() const { return mLeft; }
  59. /**
  60. * @brief Gets the vertical origin of the window in pixels.
  61. */
  62. INT32 getTop() const { return mTop; }
  63. /**
  64. * @brief Indicates whether the window currently has keyboard focus.
  65. */
  66. bool hasFocus() const { return mHasFocus; }
  67. /**
  68. * @brief Returns true if window is running in fullscreen mode.
  69. */
  70. bool isFullScreen() const { return mIsFullScreen; }
  71. /**
  72. * @brief Returns true if the window is modal (blocks interaction with
  73. * any non-modal window until closed).
  74. */
  75. bool isModal() const { return mIsModal; }
  76. /**
  77. * @brief Returns true if the window is hidden.
  78. */
  79. bool isHidden() const { return mHidden; }
  80. protected:
  81. friend class RenderWindowCore;
  82. friend class RenderWindow;
  83. bool mIsFullScreen = false;
  84. INT32 mLeft = 0;
  85. INT32 mTop = 0;
  86. bool mHasFocus = false;
  87. bool mHidden = false;
  88. bool mIsModal = false;
  89. };
  90. /**
  91. * @brief Provides access to internal render window implementation usable only from the core thread.
  92. *
  93. * @note Core thread only.
  94. */
  95. class BS_CORE_EXPORT RenderWindowCore : public RenderTargetCore
  96. {
  97. public:
  98. RenderWindowCore(const RENDER_WINDOW_DESC& desc);
  99. virtual ~RenderWindowCore();
  100. /**
  101. * @brief Switches the window to fullscreen mode. Child windows cannot go into fullscreen mode.
  102. *
  103. * @param width Width of the window frame buffer in pixels.
  104. * @param height Height of the window frame buffer in pixels.
  105. * @param refreshRate Refresh rate of the window in Hertz.
  106. * @param monitorIdx Index of the monitor to go fullscreen on.
  107. *
  108. * @note If the exact provided mode isn't available, closest one is used instead.
  109. */
  110. virtual void setFullscreen(UINT32 width, UINT32 height, float refreshRate = 60.0f, UINT32 monitorIdx = 0) { }
  111. /**
  112. * @brief Switches the window to fullscreen mode. Child windows cannot go into fullscreen mode.
  113. *
  114. * @param videoMode Mode retrieved from VideoModeInfo in RenderSystem.
  115. */
  116. virtual void setFullscreen(const VideoMode& mode) { }
  117. /**
  118. * @brief Switches the window to windowed mode.
  119. *
  120. * @param Window width in pixels.
  121. * @param Window height in pixels.
  122. */
  123. virtual void setWindowed(UINT32 width, UINT32 height) { }
  124. /**
  125. * @brief Hide or show the window.
  126. */
  127. virtual void setHidden(bool hidden);
  128. /**
  129. * @brief Makes the render target active or inactive. (e.g. for a window, it will hide or restore the window).
  130. */
  131. virtual void setActive(bool state);
  132. /**
  133. * @brief Change the size of the window.
  134. */
  135. virtual void resize(UINT32 width, UINT32 height) = 0;
  136. /**
  137. * @brief Reposition the window.
  138. */
  139. virtual void move(INT32 left, INT32 top) = 0;
  140. /**
  141. * @brief Returns properties that describe the render window.
  142. */
  143. const RenderWindowProperties& getProperties() const;
  144. /**
  145. * @brief Called when window is moved or resized.
  146. *
  147. * @note Core thread. Internal method.
  148. */
  149. virtual void _windowMovedOrResized();
  150. /**
  151. * @brief Called when window has received focus.
  152. *
  153. * @note Core thread.
  154. */
  155. virtual void _windowFocusReceived();
  156. /**
  157. * @brief Called when window has lost focus.
  158. *
  159. * @note Core thread.
  160. */
  161. virtual void _windowFocusLost();
  162. protected:
  163. friend class RenderWindow;
  164. friend class RenderWindowManager;
  165. /**
  166. * @copydoc CoreObjectCore::syncToCore
  167. */
  168. virtual void syncToCore(const CoreSyncData& data);
  169. /**
  170. * @brief Retrieves data that is to be used for syncing between core and sim thread
  171. * versions of this object.
  172. */
  173. virtual UINT32 getSyncData(UINT8* buffer) { return 0; }
  174. RENDER_WINDOW_DESC mDesc;
  175. };
  176. /**
  177. * @brief Render target specialization that allows you to render into window
  178. * frame buffer(s).
  179. *
  180. * @note Sim thread only. Retrieve core implementation from getCore()
  181. * for core thread only functionality.
  182. */
  183. class BS_CORE_EXPORT RenderWindow : public RenderTarget
  184. {
  185. public:
  186. virtual ~RenderWindow() { }
  187. /**
  188. * @copydoc RenderTarget::destroy
  189. */
  190. virtual void destroy();
  191. /**
  192. * @brief Converts screen position into window local position.
  193. */
  194. virtual Vector2I screenToWindowPos(const Vector2I& screenPos) const = 0;
  195. /**
  196. * @brief Converts window local position to screen position.
  197. */
  198. virtual Vector2I windowToScreenPos(const Vector2I& windowPos) const = 0;
  199. /**
  200. * @brief Resize the window to specified width and height in pixels.
  201. */
  202. void resize(CoreAccessor& accessor, UINT32 width, UINT32 height);
  203. /**
  204. * @brief Move the window to specified screen coordinates.
  205. */
  206. void move(CoreAccessor& accessor, INT32 left, INT32 top);
  207. /**
  208. * @brief Hide the window. (Does not destroy it, just hides it).
  209. */
  210. void hide(CoreAccessor& accessor);
  211. /**
  212. * @brief Shows a previously hidden window.
  213. */
  214. void show(CoreAccessor& accessor);
  215. /**
  216. * @copydoc RenderWindowCore::setFullscreen(UINT32, UINT32, float, UINT32)
  217. */
  218. void setFullscreen(CoreAccessor& accessor, UINT32 width, UINT32 height, float refreshRate = 60.0f, UINT32 monitorIdx = 0);
  219. /**
  220. * @copydoc RenderWindowCore::setFullscreen(const VideoMode&)
  221. */
  222. void setFullscreen(CoreAccessor& accessor, const VideoMode& mode);
  223. /**
  224. * @copydoc RenderWindowCore::setWindowed
  225. */
  226. void setWindowed(CoreAccessor& accessor, UINT32 width, UINT32 height);
  227. /**
  228. * @brief Retrieves a core implementation of a render window usable only from the
  229. * core thread.
  230. */
  231. SPtr<RenderWindowCore> getCore() const;
  232. /**
  233. * @brief Returns properties that describe the render window.
  234. */
  235. const RenderWindowProperties& getProperties() const;
  236. /**
  237. * @brief Creates a new render window using the specified options. Optionally
  238. * makes the created window a child of another window.
  239. */
  240. static RenderWindowPtr create(RENDER_WINDOW_DESC& desc, RenderWindowPtr parentWindow = nullptr);
  241. protected:
  242. friend class RenderWindowManager;
  243. RenderWindow(const RENDER_WINDOW_DESC& desc);
  244. /**
  245. * @brief Updates internal properties using the provided data. Data must have been retrieved from
  246. * "getSyncData" method of the core version of this object.
  247. */
  248. virtual void setSyncData(UINT8* buffer, UINT32 size) { }
  249. /**
  250. * @copydoc RenderTarget::createCore
  251. */
  252. SPtr<CoreObjectCore> createCore() const;
  253. /**
  254. * @copydoc CoreObjectCore::syncToCore
  255. */
  256. virtual CoreSyncData syncToCore(FrameAlloc* allocator);
  257. protected:
  258. RENDER_WINDOW_DESC mDesc;
  259. };
  260. }