// Copyright (C) 2002-2012 Nikolaus Gebhardt // This file is part of the "Irrlicht Engine". // For conditions of distribution and use, see copyright notice in irrlicht.h #ifndef __C_IRR_DEVICE_WIN32_H_INCLUDED__ #define __C_IRR_DEVICE_WIN32_H_INCLUDED__ #include "IrrCompileConfig.h" #ifdef _IRR_COMPILE_WITH_WINDOWS_DEVICE_ #include "CIrrDeviceStub.h" #include "IrrlichtDevice.h" #include "IImagePresenter.h" #define WIN32_LEAN_AND_MEAN #if !defined(_IRR_XBOX_PLATFORM_) #include #include // For JOYCAPS #include #endif #if !defined(GET_X_LPARAM) #define GET_X_LPARAM(lp) ((int)(short)LOWORD(lp)) #define GET_Y_LPARAM(lp) ((int)(short)HIWORD(lp)) #endif namespace irr { struct SJoystickWin32Control; class CIrrDeviceWin32 : public CIrrDeviceStub, video::IImagePresenter { friend struct SJoystickWin32Control; public: //! constructor CIrrDeviceWin32(const SIrrlichtCreationParameters& params); //! destructor virtual ~CIrrDeviceWin32(); //! runs the device. Returns false if device wants to be deleted virtual bool run() IRR_OVERRIDE; //! Cause the device to temporarily pause execution and let other processes to run // This should bring down processor usage without major performance loss for Irrlicht virtual void yield() IRR_OVERRIDE; //! Pause execution and let other processes to run for a specified amount of time. virtual void sleep(u32 timeMs, bool pauseTimer) IRR_OVERRIDE; //! sets the caption of the window virtual void setWindowCaption(const wchar_t* text) IRR_OVERRIDE; //! returns if window is active. if not, nothing need to be drawn virtual bool isWindowActive() const IRR_OVERRIDE; //! returns if window has focus virtual bool isWindowFocused() const IRR_OVERRIDE; //! returns if window is minimized virtual bool isWindowMinimized() const IRR_OVERRIDE; //! presents a surface in the client area virtual bool present(video::IImage* surface, void* windowId=0, core::rect* src=0) IRR_OVERRIDE; //! notifies the device that it should close itself virtual void closeDevice() IRR_OVERRIDE; //! \return Returns a pointer to a list with all video modes //! supported by the gfx adapter. virtual video::IVideoModeList* getVideoModeList() IRR_OVERRIDE; //! Notifies the device, that it has been resized /** Must be publis as it is called from free function (event handler) */ void OnResized(); //! Sets if the window should be resizable in windowed mode. virtual void setResizable(bool resize=false) IRR_OVERRIDE; //! Resize the render window. virtual void setWindowSize(const irr::core::dimension2d& size) IRR_OVERRIDE; //! Minimizes the window. virtual void minimizeWindow() IRR_OVERRIDE; //! Maximizes the window. virtual void maximizeWindow() IRR_OVERRIDE; //! Restores the window size. virtual void restoreWindow() IRR_OVERRIDE; //! Get the position of the window on screen virtual core::position2di getWindowPosition() IRR_OVERRIDE; //! Activate any joysticks, and generate events for them. virtual bool activateJoysticks(core::array & joystickInfo) IRR_OVERRIDE; //! Set the current Gamma Value for the Display virtual bool setGammaRamp( f32 red, f32 green, f32 blue, f32 brightness, f32 contrast ) IRR_OVERRIDE; //! Get the current Gamma Value for the Display virtual bool getGammaRamp( f32 &red, f32 &green, f32 &blue, f32 &brightness, f32 &contrast ) IRR_OVERRIDE; //! Remove all messages pending in the system message loop virtual void clearSystemMessages() IRR_OVERRIDE; //! Get the device type virtual E_DEVICE_TYPE getType() const IRR_OVERRIDE { return EIDT_WIN32; } //! Compares to the last call of this function to return double and triple clicks. //! \return Returns only 1,2 or 3. A 4th click will start with 1 again. virtual u32 checkSuccessiveClicks(s32 mouseX, s32 mouseY, EMOUSE_INPUT_EVENT inputEvent ) IRR_OVERRIDE { // we just have to make it public return CIrrDeviceStub::checkSuccessiveClicks(mouseX, mouseY, inputEvent ); } //! Switch to fullscreen bool switchToFullScreen(bool reset=false); //! Check for and show last Windows API error to help internal debugging. //! Does call GetLastError and on errors formats the error text and displays it in a messagebox. static void ReportLastWinApiError(); //! Same function Windows offers in VersionHelpers.h, but we can't use that as it's not available before SDK 8.1 static bool isWindowsVistaOrGreater(); // convert an Irrlicht texture to a windows cursor HCURSOR TextureToCursor(HWND hwnd, irr::video::ITexture * tex, const core::rect& sourceRect, const core::position2d &hotspot); //! Implementation of the win32 cursor control class CCursorControl : public gui::ICursorControl { public: CCursorControl(CIrrDeviceWin32* device, const core::dimension2d& wsize, HWND hwnd, bool fullscreen); ~CCursorControl(); //! Changes the visible state of the mouse cursor. virtual void setVisible(bool visible) IRR_OVERRIDE { CURSORINFO info; info.cbSize = sizeof(CURSORINFO); BOOL gotCursorInfo = GetCursorInfo(&info); while ( gotCursorInfo ) { #ifdef CURSOR_SUPPRESSED // Since Windows 8 the cursor can be suppressed by a touch interface if (visible && info.flags == CURSOR_SUPPRESSED) { break; } #endif if ( (visible && info.flags == CURSOR_SHOWING) || // visible (!visible && info.flags == 0 ) ) // hidden { break; } // this only increases an internal // display counter in windows, so it // might have to be called some more const int showResult = ShowCursor(visible); // if result has correct sign we can // stop here as well if (( !visible && showResult < 0 ) || (visible && showResult >= 0)) break; // yes, it really must be set each time info.cbSize = sizeof(CURSORINFO); gotCursorInfo = GetCursorInfo(&info); #ifdef CURSOR_SUPPRESSED // Not sure if a cursor which we tried to hide still can be suppressed. // I have no touch-display for testing this and MSDN doesn't describe it. // But adding this check shouldn't hurt and might prevent an endless loop. if (!visible && info.flags == CURSOR_SUPPRESSED) { break; } #endif } IsVisible = visible; } //! Returns if the cursor is currently visible. virtual bool isVisible() const IRR_OVERRIDE { return IsVisible; } //! Sets the new position of the cursor. virtual void setPosition(const core::position2d &pos) IRR_OVERRIDE { setPosition(pos.X, pos.Y); } //! Sets the new position of the cursor. virtual void setPosition(f32 x, f32 y) IRR_OVERRIDE { if (!UseReferenceRect) setPosition(core::round32(x*WindowSize.Width), core::round32(y*WindowSize.Height)); else setPosition(core::round32(x*ReferenceRect.getWidth()), core::round32(y*ReferenceRect.getHeight())); } //! Sets the new position of the cursor. virtual void setPosition(const core::position2d &pos) IRR_OVERRIDE { setPosition(pos.X, pos.Y); } //! Sets the new position of the cursor. virtual void setPosition(s32 x, s32 y) IRR_OVERRIDE { if (UseReferenceRect) { SetCursorPos(ReferenceRect.UpperLeftCorner.X + x, ReferenceRect.UpperLeftCorner.Y + y); } else { RECT rect; if (GetWindowRect(HWnd, &rect)) SetCursorPos(x + rect.left + BorderX, y + rect.top + BorderY); } CursorPos.X = x; CursorPos.Y = y; } //! Returns the current position of the mouse cursor. virtual const core::position2d& getPosition(bool updateCursor) IRR_OVERRIDE { if ( updateCursor ) updateInternalCursorPosition(); return CursorPos; } //! Returns the current position of the mouse cursor. virtual core::position2d getRelativePosition(bool updateCursor) IRR_OVERRIDE { if ( updateCursor ) updateInternalCursorPosition(); if (!UseReferenceRect) { return core::position2d(CursorPos.X * InvWindowSize.Width, CursorPos.Y * InvWindowSize.Height); } return core::position2d(CursorPos.X / (f32)ReferenceRect.getWidth(), CursorPos.Y / (f32)ReferenceRect.getHeight()); } //! Sets an absolute reference rect for calculating the cursor position. virtual void setReferenceRect(core::rect* rect=0) IRR_OVERRIDE { if (rect) { ReferenceRect = *rect; UseReferenceRect = true; // prevent division through zero and uneven sizes if (!ReferenceRect.getHeight() || ReferenceRect.getHeight()%2) ReferenceRect.LowerRightCorner.Y += 1; if (!ReferenceRect.getWidth() || ReferenceRect.getWidth()%2) ReferenceRect.LowerRightCorner.X += 1; } else UseReferenceRect = false; } /** Used to notify the cursor that the window was resized. */ void OnResize(const core::dimension2d& size) { WindowSize = size; if (size.Width!=0) InvWindowSize.Width = 1.0f / size.Width; else InvWindowSize.Width = 0.f; if (size.Height!=0) InvWindowSize.Height = 1.0f / size.Height; else InvWindowSize.Height = 0.f; } /** Used to notify the cursor that the window resizable settings changed. */ void updateBorderSize(bool fullscreen, bool resizable) { if (!fullscreen) { s32 paddingBorder = 0; #if defined (SM_CXPADDEDBORDER) if (CIrrDeviceWin32::isWindowsVistaOrGreater()) paddingBorder = GetSystemMetrics(SM_CXPADDEDBORDER); #endif if (resizable) { BorderX = GetSystemMetrics(SM_CXSIZEFRAME) + paddingBorder; BorderY = GetSystemMetrics(SM_CYCAPTION) + GetSystemMetrics(SM_CYSIZEFRAME) + paddingBorder; } else { BorderX = GetSystemMetrics(SM_CXDLGFRAME) + paddingBorder; BorderY = GetSystemMetrics(SM_CYCAPTION) + GetSystemMetrics(SM_CYDLGFRAME) + paddingBorder; } } else { BorderX = BorderY = 0; } } //! Sets the active cursor icon virtual void setActiveIcon(gui::ECURSOR_ICON iconId) IRR_OVERRIDE; //! Gets the currently active icon virtual gui::ECURSOR_ICON getActiveIcon() const IRR_OVERRIDE { return ActiveIcon; } //! Add a custom sprite as cursor icon. virtual gui::ECURSOR_ICON addIcon(const gui::SCursorSprite& icon) IRR_OVERRIDE; //! replace the given cursor icon. virtual void changeIcon(gui::ECURSOR_ICON iconId, const gui::SCursorSprite& icon) IRR_OVERRIDE; //! Return a system-specific size which is supported for cursors. Larger icons will fail, smaller icons might work. virtual core::dimension2di getSupportedIconSize() const IRR_OVERRIDE; void update(); private: //! Updates the internal cursor position void updateInternalCursorPosition() { POINT p; if (!GetCursorPos(&p)) { DWORD xy = GetMessagePos(); p.x = GET_X_LPARAM(xy); p.y = GET_Y_LPARAM(xy); } if (UseReferenceRect) { CursorPos.X = p.x - ReferenceRect.UpperLeftCorner.X; CursorPos.Y = p.y - ReferenceRect.UpperLeftCorner.Y; } else { RECT rect; if (GetWindowRect(HWnd, &rect)) { CursorPos.X = p.x-rect.left-BorderX; CursorPos.Y = p.y-rect.top-BorderY; } else { // window seems not to be existent, so set cursor to // a negative value CursorPos.X = -1; CursorPos.Y = -1; } } } CIrrDeviceWin32* Device; core::position2d CursorPos; core::dimension2d WindowSize; core::dimension2d InvWindowSize; HWND HWnd; s32 BorderX, BorderY; core::rect ReferenceRect; bool UseReferenceRect; bool IsVisible; struct CursorFrameW32 { CursorFrameW32() : IconHW(0) {} CursorFrameW32(HCURSOR icon) : IconHW(icon) {} HCURSOR IconHW; // hardware cursor }; struct CursorW32 { CursorW32() {} explicit CursorW32(HCURSOR iconHw, u32 frameTime=0) : FrameTime(frameTime) { Frames.push_back( CursorFrameW32(iconHw) ); } core::array Frames; u32 FrameTime; }; core::array Cursors; gui::ECURSOR_ICON ActiveIcon; u32 ActiveIconStartTime; void initCursors(); }; //! returns the win32 cursor control CCursorControl* getWin32CursorControl(); private: //! create the driver void createDriver(); //! Process system events void handleSystemMessages(); void getWindowsVersion(core::stringc& version); void resizeIfNecessary(); DWORD getWindowStyle(bool fullscreen, bool resizable) const; HWND HWnd; bool ChangedToFullScreen; bool Resized; bool ExternalWindow; CCursorControl* Win32CursorControl; DEVMODE DesktopMode; SJoystickWin32Control* JoyControl; }; } // end namespace irr #endif // _IRR_COMPILE_WITH_WINDOWS_DEVICE_ #endif // __C_IRR_DEVICE_WIN32_H_INCLUDED__