You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
331 lines
9.1 KiB
331 lines
9.1 KiB
/* |
|
Simple DirectMedia Layer |
|
Copyright (C) 1997-2020 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" |
|
|
|
/** |
|
* \brief 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(). |
|
*/ |
|
struct SDL_SysWMinfo; |
|
|
|
#if !defined(SDL_PROTOTYPES_ONLY) |
|
|
|
#if defined(SDL_VIDEO_DRIVER_WINDOWS) |
|
#ifndef WIN32_LEAN_AND_MEAN |
|
#define WIN32_LEAN_AND_MEAN |
|
#endif |
|
#ifndef NOMINMAX /* don't define min() and max(). */ |
|
#define NOMINMAX |
|
#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 |
|
#endif /* SDL_PROTOTYPES_ONLY */ |
|
|
|
|
|
#include "begin_code.h" |
|
/* Set up for C function definitions, even when using C++ */ |
|
#ifdef __cplusplus |
|
extern "C" { |
|
#endif |
|
|
|
#if !defined(SDL_PROTOTYPES_ONLY) |
|
/** |
|
* 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, /* no longer available, left for API/ABI compatibility. Remove in 2.1! */ |
|
SDL_SYSWM_WINRT, |
|
SDL_SYSWM_ANDROID, |
|
SDL_SYSWM_VIVANTE, |
|
SDL_SYSWM_OS2, |
|
SDL_SYSWM_HAIKU |
|
} 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) /* no longer available, left for API/ABI compatibility. Remove in 2.1! */ |
|
struct |
|
{ |
|
void *connection; /**< Mir display server connection */ |
|
void *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: */
|
|
|