BsRenderWindow.h 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275
  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. virtual ~RenderWindowProperties() { }
  54. /**
  55. * @brief Gets the horizontal origin of the window in pixels.
  56. */
  57. INT32 getLeft() const { return mLeft; }
  58. /**
  59. * @brief Gets the vertical origin of the window in pixels.
  60. */
  61. INT32 getTop() const { return mTop; }
  62. /**
  63. * @brief Indicates whether the window currently has keyboard focus.
  64. */
  65. bool hasFocus() const { return mHasFocus; }
  66. /**
  67. * @brief Returns true if window is running in fullscreen mode.
  68. */
  69. bool isFullScreen() const { return mIsFullScreen; }
  70. /**
  71. * @brief Returns true if the window is modal (blocks interaction with
  72. * any non-modal window until closed).
  73. */
  74. bool isModal() const { return mIsModal; }
  75. /**
  76. * @brief Returns true if the window is hidden.
  77. */
  78. bool isHidden() const { return mHidden; }
  79. protected:
  80. friend class RenderWindowCore;
  81. friend class RenderWindow;
  82. bool mIsFullScreen = false;
  83. INT32 mLeft = 0;
  84. INT32 mTop = 0;
  85. bool mHasFocus = false;
  86. bool mHidden = false;
  87. bool mIsModal = false;
  88. };
  89. /**
  90. * @brief Provides access to internal render window implementation usable only from the core thread.
  91. *
  92. * @note Core thread only.
  93. */
  94. class BS_CORE_EXPORT RenderWindowCore : public RenderTargetCore
  95. {
  96. public:
  97. RenderWindowCore(RenderWindow* parent, RenderWindowProperties* properties);
  98. virtual ~RenderWindowCore() { }
  99. /**
  100. * @brief Switches the window to fullscreen mode. Child windows cannot go into fullscreen mode.
  101. *
  102. * @param width Width of the window frame buffer in pixels.
  103. * @param height Height of the window frame buffer in pixels.
  104. * @param refreshRate Refresh rate of the window in Hertz.
  105. * @param monitorIdx Index of the monitor to go fullscreen on.
  106. *
  107. * @note Core thread.
  108. * 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. * @note Core thread.
  117. */
  118. virtual void setFullscreen(const VideoMode& mode) { }
  119. /**
  120. * @brief Switches the window to windowed mode.
  121. *
  122. * @param Window width in pixels.
  123. * @param Window height in pixels.
  124. *
  125. * @note Core thread.
  126. */
  127. virtual void setWindowed(UINT32 width, UINT32 height) { }
  128. /**
  129. * @brief Hide or show the window.
  130. *
  131. * @note Core thread.
  132. */
  133. virtual void setHidden(bool hidden);
  134. /**
  135. * @brief Change the size of the window.
  136. *
  137. * @note Core thread.
  138. */
  139. virtual void resize(UINT32 width, UINT32 height) = 0;
  140. /**
  141. * @brief Reposition the window.
  142. *
  143. * @note Core thread.
  144. */
  145. virtual void move(INT32 left, INT32 top) = 0;
  146. /**
  147. * @brief Returns properties that describe the render texture.
  148. */
  149. const RenderWindowProperties& getProperties() const { return *static_cast<RenderWindowProperties*>(mProperties); }
  150. /**
  151. * @copydoc RenderTargetCore::getNonCore
  152. */
  153. RenderWindow* getNonCore() const;
  154. protected:
  155. friend class RenderWindow;
  156. friend class RenderWindowManager;
  157. /**
  158. * @brief Called when window is moved or resized.
  159. *
  160. * @note Core thread.
  161. */
  162. virtual void _windowMovedOrResized();
  163. /**
  164. * @brief Called when window has received focus.
  165. *
  166. * @note Core thread.
  167. */
  168. virtual void _windowFocusReceived();
  169. /**
  170. * @brief Called when window has lost focus.
  171. *
  172. * @note Core thread.
  173. */
  174. virtual void _windowFocusLost();
  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::initialize
  189. */
  190. virtual void initialize(const RENDER_WINDOW_DESC& desc);
  191. /**
  192. * @copydoc RenderTarget::destroy
  193. */
  194. virtual void destroy();
  195. /**
  196. * @brief Converts screen position into window local position.
  197. */
  198. virtual Vector2I screenToWindowPos(const Vector2I& screenPos) const = 0;
  199. /**
  200. * @brief Converts window local position to screen position.
  201. */
  202. virtual Vector2I windowToScreenPos(const Vector2I& windowPos) const = 0;
  203. /**
  204. * @brief Returns properties that describe the render window.
  205. */
  206. const RenderWindowProperties& getProperties() const;
  207. /**
  208. * @brief Retrieves a core implementation of a render window usable only from the
  209. * core thread.
  210. *
  211. * @note Core thread only.
  212. */
  213. RenderWindowCore* getCore() const;
  214. /**
  215. * @brief Creates a new render window using the specified options. Optionally
  216. * makes the created window a child of another window.
  217. */
  218. static RenderWindowPtr create(RENDER_WINDOW_DESC& desc, RenderWindowPtr parentWindow = nullptr);
  219. protected:
  220. friend class RenderWindowManager;
  221. RenderWindow() { }
  222. /**
  223. * @copydoc RenderWindow::createCore
  224. */
  225. virtual RenderTargetCore* createCore();
  226. /**
  227. * @brief Creates a core implementation of a render window. This implementation
  228. * is to be used on the core thread only.
  229. */
  230. virtual RenderWindowCore* createCore(RenderWindowProperties* properties, const RENDER_WINDOW_DESC& desc) = 0;
  231. protected:
  232. RENDER_WINDOW_DESC mDesc;
  233. };
  234. }