123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325 |
- /*
- Simple DirectMedia Layer
- Copyright (C) 1997-2017 Sam Lantinga <slouken@libsdl.org>
- This software is provided 'as-is', without any express or implied
- warranty. In no event will the authors be held liable for any damages
- arising from the use of this software.
- Permission is granted to anyone to use this software for any purpose,
- including commercial applications, and to alter it and redistribute it
- freely, subject to the following restrictions:
- 1. The origin of this software must not be misrepresented; you must not
- claim that you wrote the original software. If you use this software
- in a product, an acknowledgment in the product documentation would be
- appreciated but is not required.
- 2. Altered source versions must be plainly marked as such, and must not be
- misrepresented as being the original software.
- 3. This notice may not be removed or altered from any source distribution.
- */
- /**
- * \file SDL_syswm.h
- *
- * Include file for SDL custom system window manager hooks.
- */
- #ifndef SDL_syswm_h_
- #define SDL_syswm_h_
- #include "SDL_stdinc.h"
- #include "SDL_error.h"
- #include "SDL_video.h"
- #include "SDL_version.h"
- #include "begin_code.h"
- /* Set up for C function definitions, even when using C++ */
- #ifdef __cplusplus
- extern "C" {
- #endif
- /**
- * \file SDL_syswm.h
- *
- * Your application has access to a special type of event ::SDL_SYSWMEVENT,
- * which contains window-manager specific information and arrives whenever
- * an unhandled window event occurs. This event is ignored by default, but
- * you can enable it with SDL_EventState().
- */
- #ifdef SDL_PROTOTYPES_ONLY
- struct SDL_SysWMinfo;
- #else
- #if defined(SDL_VIDEO_DRIVER_WINDOWS)
- #ifndef WIN32_LEAN_AND_MEAN
- #define WIN32_LEAN_AND_MEAN
- #endif
- #include <windows.h>
- #endif
- #if defined(SDL_VIDEO_DRIVER_WINRT)
- #include <Inspectable.h>
- #endif
- /* This is the structure for custom window manager events */
- #if defined(SDL_VIDEO_DRIVER_X11)
- #if defined(__APPLE__) && defined(__MACH__)
- /* conflicts with Quickdraw.h */
- #define Cursor X11Cursor
- #endif
- #include <X11/Xlib.h>
- #include <X11/Xatom.h>
- #if defined(__APPLE__) && defined(__MACH__)
- /* matches the re-define above */
- #undef Cursor
- #endif
- #endif /* defined(SDL_VIDEO_DRIVER_X11) */
- #if defined(SDL_VIDEO_DRIVER_DIRECTFB)
- #include <directfb.h>
- #endif
- #if defined(SDL_VIDEO_DRIVER_COCOA)
- #ifdef __OBJC__
- @class NSWindow;
- #else
- typedef struct _NSWindow NSWindow;
- #endif
- #endif
- #if defined(SDL_VIDEO_DRIVER_UIKIT)
- #ifdef __OBJC__
- #include <UIKit/UIKit.h>
- #else
- typedef struct _UIWindow UIWindow;
- typedef struct _UIViewController UIViewController;
- #endif
- typedef Uint32 GLuint;
- #endif
- #if defined(SDL_VIDEO_DRIVER_ANDROID)
- typedef struct ANativeWindow ANativeWindow;
- typedef void *EGLSurface;
- #endif
- #if defined(SDL_VIDEO_DRIVER_VIVANTE)
- #include "SDL_egl.h"
- #endif
- /**
- * These are the various supported windowing subsystems
- */
- typedef enum
- {
- SDL_SYSWM_UNKNOWN,
- SDL_SYSWM_WINDOWS,
- SDL_SYSWM_X11,
- SDL_SYSWM_DIRECTFB,
- SDL_SYSWM_COCOA,
- SDL_SYSWM_UIKIT,
- SDL_SYSWM_WAYLAND,
- SDL_SYSWM_MIR,
- SDL_SYSWM_WINRT,
- SDL_SYSWM_ANDROID,
- SDL_SYSWM_VIVANTE,
- SDL_SYSWM_OS2
- } SDL_SYSWM_TYPE;
- /**
- * The custom event structure.
- */
- struct SDL_SysWMmsg
- {
- SDL_version version;
- SDL_SYSWM_TYPE subsystem;
- union
- {
- #if defined(SDL_VIDEO_DRIVER_WINDOWS)
- struct {
- HWND hwnd; /**< The window for the message */
- UINT msg; /**< The type of message */
- WPARAM wParam; /**< WORD message parameter */
- LPARAM lParam; /**< LONG message parameter */
- } win;
- #endif
- #if defined(SDL_VIDEO_DRIVER_X11)
- struct {
- XEvent event;
- } x11;
- #endif
- #if defined(SDL_VIDEO_DRIVER_DIRECTFB)
- struct {
- DFBEvent event;
- } dfb;
- #endif
- #if defined(SDL_VIDEO_DRIVER_COCOA)
- struct
- {
- /* Latest version of Xcode clang complains about empty structs in C v. C++:
- error: empty struct has size 0 in C, size 1 in C++
- */
- int dummy;
- /* No Cocoa window events yet */
- } cocoa;
- #endif
- #if defined(SDL_VIDEO_DRIVER_UIKIT)
- struct
- {
- int dummy;
- /* No UIKit window events yet */
- } uikit;
- #endif
- #if defined(SDL_VIDEO_DRIVER_VIVANTE)
- struct
- {
- int dummy;
- /* No Vivante window events yet */
- } vivante;
- #endif
- /* Can't have an empty union */
- int dummy;
- } msg;
- };
- /**
- * The custom window manager information structure.
- *
- * When this structure is returned, it holds information about which
- * low level system it is using, and will be one of SDL_SYSWM_TYPE.
- */
- struct SDL_SysWMinfo
- {
- SDL_version version;
- SDL_SYSWM_TYPE subsystem;
- union
- {
- #if defined(SDL_VIDEO_DRIVER_WINDOWS)
- struct
- {
- HWND window; /**< The window handle */
- HDC hdc; /**< The window device context */
- HINSTANCE hinstance; /**< The instance handle */
- } win;
- #endif
- #if defined(SDL_VIDEO_DRIVER_WINRT)
- struct
- {
- IInspectable * window; /**< The WinRT CoreWindow */
- } winrt;
- #endif
- #if defined(SDL_VIDEO_DRIVER_X11)
- struct
- {
- Display *display; /**< The X11 display */
- Window window; /**< The X11 window */
- } x11;
- #endif
- #if defined(SDL_VIDEO_DRIVER_DIRECTFB)
- struct
- {
- IDirectFB *dfb; /**< The directfb main interface */
- IDirectFBWindow *window; /**< The directfb window handle */
- IDirectFBSurface *surface; /**< The directfb client surface */
- } dfb;
- #endif
- #if defined(SDL_VIDEO_DRIVER_COCOA)
- struct
- {
- #if defined(__OBJC__) && defined(__has_feature) && __has_feature(objc_arc)
- NSWindow __unsafe_unretained *window; /**< The Cocoa window */
- #else
- NSWindow *window; /**< The Cocoa window */
- #endif
- } cocoa;
- #endif
- #if defined(SDL_VIDEO_DRIVER_UIKIT)
- struct
- {
- #if defined(__OBJC__) && defined(__has_feature) && __has_feature(objc_arc)
- UIWindow __unsafe_unretained *window; /**< The UIKit window */
- #else
- UIWindow *window; /**< The UIKit window */
- #endif
- GLuint framebuffer; /**< The GL view's Framebuffer Object. It must be bound when rendering to the screen using GL. */
- GLuint colorbuffer; /**< The GL view's color Renderbuffer Object. It must be bound when SDL_GL_SwapWindow is called. */
- GLuint resolveFramebuffer; /**< The Framebuffer Object which holds the resolve color Renderbuffer, when MSAA is used. */
- } uikit;
- #endif
- #if defined(SDL_VIDEO_DRIVER_WAYLAND)
- struct
- {
- struct wl_display *display; /**< Wayland display */
- struct wl_surface *surface; /**< Wayland surface */
- struct wl_shell_surface *shell_surface; /**< Wayland shell_surface (window manager handle) */
- } wl;
- #endif
- #if defined(SDL_VIDEO_DRIVER_MIR)
- struct
- {
- struct MirConnection *connection; /**< Mir display server connection */
- struct MirSurface *surface; /**< Mir surface */
- } mir;
- #endif
- #if defined(SDL_VIDEO_DRIVER_ANDROID)
- struct
- {
- ANativeWindow *window;
- EGLSurface surface;
- } android;
- #endif
- #if defined(SDL_VIDEO_DRIVER_VIVANTE)
- struct
- {
- EGLNativeDisplayType display;
- EGLNativeWindowType window;
- } vivante;
- #endif
- /* Make sure this union is always 64 bytes (8 64-bit pointers). */
- /* Be careful not to overflow this if you add a new target! */
- Uint8 dummy[64];
- } info;
- };
- #endif /* SDL_PROTOTYPES_ONLY */
- typedef struct SDL_SysWMinfo SDL_SysWMinfo;
- /* Function prototypes */
- /**
- * \brief This function allows access to driver-dependent window information.
- *
- * \param window The window about which information is being requested
- * \param info This structure must be initialized with the SDL version, and is
- * then filled in with information about the given window.
- *
- * \return SDL_TRUE if the function is implemented and the version member of
- * the \c info struct is valid, SDL_FALSE otherwise.
- *
- * You typically use this function like this:
- * \code
- * SDL_SysWMinfo info;
- * SDL_VERSION(&info.version);
- * if ( SDL_GetWindowWMInfo(window, &info) ) { ... }
- * \endcode
- */
- extern DECLSPEC SDL_bool SDLCALL SDL_GetWindowWMInfo(SDL_Window * window,
- SDL_SysWMinfo * info);
- /* Ends C function definitions when using C++ */
- #ifdef __cplusplus
- }
- #endif
- #include "close_code.h"
- #endif /* SDL_syswm_h_ */
- /* vi: set ts=4 sw=4 expandtab: */
|