Rev 1 | Details | Compare with Previous | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line | 
|---|---|---|---|
| 1 | pmbaty | 1 | /* | 
| 2 |   Simple DirectMedia Layer | ||
| 8 | pmbaty | 3 |   Copyright (C) 1997-2018 Sam Lantinga <slouken@libsdl.org> | 
| 1 | pmbaty | 4 | |
| 5 |   This software is provided 'as-is', without any express or implied | ||
| 6 |   warranty.  In no event will the authors be held liable for any damages | ||
| 7 |   arising from the use of this software. | ||
| 8 | |||
| 9 |   Permission is granted to anyone to use this software for any purpose, | ||
| 10 |   including commercial applications, and to alter it and redistribute it | ||
| 11 |   freely, subject to the following restrictions: | ||
| 12 | |||
| 13 |   1. The origin of this software must not be misrepresented; you must not | ||
| 14 |      claim that you wrote the original software. If you use this software | ||
| 15 |      in a product, an acknowledgment in the product documentation would be | ||
| 16 |      appreciated but is not required. | ||
| 17 |   2. Altered source versions must be plainly marked as such, and must not be | ||
| 18 |      misrepresented as being the original software. | ||
| 19 |   3. This notice may not be removed or altered from any source distribution. | ||
| 20 | */ | ||
| 21 | |||
| 22 | /** | ||
| 23 |  *  \file SDL_syswm.h | ||
| 24 |  * | ||
| 25 |  *  Include file for SDL custom system window manager hooks. | ||
| 26 |  */ | ||
| 27 | |||
| 28 | #ifndef SDL_syswm_h_ | ||
| 29 | #define SDL_syswm_h_ | ||
| 30 | |||
| 31 | #include "SDL_stdinc.h" | ||
| 32 | #include "SDL_error.h" | ||
| 33 | #include "SDL_video.h" | ||
| 34 | #include "SDL_version.h" | ||
| 35 | |||
| 36 | /** | ||
| 37 |  *  \file SDL_syswm.h | ||
| 38 |  * | ||
| 39 |  *  Your application has access to a special type of event ::SDL_SYSWMEVENT, | ||
| 40 |  *  which contains window-manager specific information and arrives whenever | ||
| 41 |  *  an unhandled window event occurs.  This event is ignored by default, but | ||
| 42 |  *  you can enable it with SDL_EventState(). | ||
| 43 |  */ | ||
| 44 | #ifdef SDL_PROTOTYPES_ONLY | ||
| 45 | struct SDL_SysWMinfo; | ||
| 46 | #else | ||
| 47 | |||
| 48 | #if defined(SDL_VIDEO_DRIVER_WINDOWS) | ||
| 49 | #ifndef WIN32_LEAN_AND_MEAN | ||
| 50 | #define WIN32_LEAN_AND_MEAN | ||
| 51 | #endif | ||
| 52 | #include <windows.h> | ||
| 53 | #endif | ||
| 54 | |||
| 55 | #if defined(SDL_VIDEO_DRIVER_WINRT) | ||
| 56 | #include <Inspectable.h> | ||
| 57 | #endif | ||
| 58 | |||
| 59 | /* This is the structure for custom window manager events */ | ||
| 60 | #if defined(SDL_VIDEO_DRIVER_X11) | ||
| 61 | #if defined(__APPLE__) && defined(__MACH__) | ||
| 62 | /* conflicts with Quickdraw.h */ | ||
| 63 | #define Cursor X11Cursor | ||
| 64 | #endif | ||
| 65 | |||
| 66 | #include <X11/Xlib.h> | ||
| 67 | #include <X11/Xatom.h> | ||
| 68 | |||
| 69 | #if defined(__APPLE__) && defined(__MACH__) | ||
| 70 | /* matches the re-define above */ | ||
| 71 | #undef Cursor | ||
| 72 | #endif | ||
| 73 | |||
| 74 | #endif /* defined(SDL_VIDEO_DRIVER_X11) */ | ||
| 75 | |||
| 76 | #if defined(SDL_VIDEO_DRIVER_DIRECTFB) | ||
| 77 | #include <directfb.h> | ||
| 78 | #endif | ||
| 79 | |||
| 80 | #if defined(SDL_VIDEO_DRIVER_COCOA) | ||
| 81 | #ifdef __OBJC__ | ||
| 82 | @class NSWindow; | ||
| 83 | #else | ||
| 84 | typedef struct _NSWindow NSWindow; | ||
| 85 | #endif | ||
| 86 | #endif | ||
| 87 | |||
| 88 | #if defined(SDL_VIDEO_DRIVER_UIKIT) | ||
| 89 | #ifdef __OBJC__ | ||
| 90 | #include <UIKit/UIKit.h> | ||
| 91 | #else | ||
| 92 | typedef struct _UIWindow UIWindow; | ||
| 93 | typedef struct _UIViewController UIViewController; | ||
| 94 | #endif | ||
| 95 | typedef Uint32 GLuint; | ||
| 96 | #endif | ||
| 97 | |||
| 98 | #if defined(SDL_VIDEO_DRIVER_ANDROID) | ||
| 99 | typedef struct ANativeWindow ANativeWindow; | ||
| 100 | typedef void *EGLSurface; | ||
| 101 | #endif | ||
| 102 | |||
| 103 | #if defined(SDL_VIDEO_DRIVER_VIVANTE) | ||
| 104 | #include "SDL_egl.h" | ||
| 105 | #endif | ||
| 106 | |||
| 8 | pmbaty | 107 | #include "begin_code.h" | 
| 108 | /* Set up for C function definitions, even when using C++ */ | ||
| 109 | #ifdef __cplusplus | ||
| 110 | extern "C" { | ||
| 111 | #endif | ||
| 112 | |||
| 1 | pmbaty | 113 | /** | 
| 114 |  *  These are the various supported windowing subsystems | ||
| 115 |  */ | ||
| 116 | typedef enum | ||
| 117 | { | ||
| 118 | SDL_SYSWM_UNKNOWN, | ||
| 119 | SDL_SYSWM_WINDOWS, | ||
| 120 | SDL_SYSWM_X11, | ||
| 121 | SDL_SYSWM_DIRECTFB, | ||
| 122 | SDL_SYSWM_COCOA, | ||
| 123 | SDL_SYSWM_UIKIT, | ||
| 124 | SDL_SYSWM_WAYLAND, | ||
| 125 | SDL_SYSWM_MIR, | ||
| 126 | SDL_SYSWM_WINRT, | ||
| 127 | SDL_SYSWM_ANDROID, | ||
| 128 | SDL_SYSWM_VIVANTE, | ||
| 129 | SDL_SYSWM_OS2 | ||
| 130 | } SDL_SYSWM_TYPE; | ||
| 131 | |||
| 132 | /** | ||
| 133 |  *  The custom event structure. | ||
| 134 |  */ | ||
| 135 | struct SDL_SysWMmsg | ||
| 136 | { | ||
| 137 |     SDL_version version; | ||
| 138 |     SDL_SYSWM_TYPE subsystem; | ||
| 139 |     union | ||
| 140 |     { | ||
| 141 | #if defined(SDL_VIDEO_DRIVER_WINDOWS) | ||
| 142 | struct { | ||
| 143 | HWND hwnd; /**< The window for the message */ | ||
| 144 | UINT msg; /**< The type of message */ | ||
| 145 | WPARAM wParam; /**< WORD message parameter */ | ||
| 146 | LPARAM lParam; /**< LONG message parameter */ | ||
| 147 | } win; | ||
| 148 | #endif | ||
| 149 | #if defined(SDL_VIDEO_DRIVER_X11) | ||
| 150 | struct { | ||
| 151 |             XEvent event; | ||
| 152 | } x11; | ||
| 153 | #endif | ||
| 154 | #if defined(SDL_VIDEO_DRIVER_DIRECTFB) | ||
| 155 | struct { | ||
| 156 |             DFBEvent event; | ||
| 157 | } dfb; | ||
| 158 | #endif | ||
| 159 | #if defined(SDL_VIDEO_DRIVER_COCOA) | ||
| 160 |         struct | ||
| 161 |         { | ||
| 162 |             /* Latest version of Xcode clang complains about empty structs in C v. C++: | ||
| 163 |                  error: empty struct has size 0 in C, size 1 in C++ | ||
| 164 |              */ | ||
| 165 | int dummy; | ||
| 166 |             /* No Cocoa window events yet */ | ||
| 167 | } cocoa; | ||
| 168 | #endif | ||
| 169 | #if defined(SDL_VIDEO_DRIVER_UIKIT) | ||
| 170 |         struct | ||
| 171 |         { | ||
| 172 | int dummy; | ||
| 173 |             /* No UIKit window events yet */ | ||
| 174 | } uikit; | ||
| 175 | #endif | ||
| 176 | #if defined(SDL_VIDEO_DRIVER_VIVANTE) | ||
| 177 |         struct | ||
| 178 |         { | ||
| 179 | int dummy; | ||
| 180 |             /* No Vivante window events yet */ | ||
| 181 | } vivante; | ||
| 182 | #endif | ||
| 183 |         /* Can't have an empty union */ | ||
| 184 | int dummy; | ||
| 185 | } msg; | ||
| 186 | }; | ||
| 187 | |||
| 188 | /** | ||
| 189 |  *  The custom window manager information structure. | ||
| 190 |  * | ||
| 191 |  *  When this structure is returned, it holds information about which | ||
| 192 |  *  low level system it is using, and will be one of SDL_SYSWM_TYPE. | ||
| 193 |  */ | ||
| 194 | struct SDL_SysWMinfo | ||
| 195 | { | ||
| 196 |     SDL_version version; | ||
| 197 |     SDL_SYSWM_TYPE subsystem; | ||
| 198 |     union | ||
| 199 |     { | ||
| 200 | #if defined(SDL_VIDEO_DRIVER_WINDOWS) | ||
| 201 |         struct | ||
| 202 |         { | ||
| 203 | HWND window; /**< The window handle */ | ||
| 204 | HDC hdc; /**< The window device context */ | ||
| 205 | HINSTANCE hinstance; /**< The instance handle */ | ||
| 206 | } win; | ||
| 207 | #endif | ||
| 208 | #if defined(SDL_VIDEO_DRIVER_WINRT) | ||
| 209 |         struct | ||
| 210 |         { | ||
| 211 | IInspectable * window; /**< The WinRT CoreWindow */ | ||
| 212 | } winrt; | ||
| 213 | #endif | ||
| 214 | #if defined(SDL_VIDEO_DRIVER_X11) | ||
| 215 |         struct | ||
| 216 |         { | ||
| 217 | Display *display; /**< The X11 display */ | ||
| 218 | Window window; /**< The X11 window */ | ||
| 219 | } x11; | ||
| 220 | #endif | ||
| 221 | #if defined(SDL_VIDEO_DRIVER_DIRECTFB) | ||
| 222 |         struct | ||
| 223 |         { | ||
| 224 | IDirectFB *dfb; /**< The directfb main interface */ | ||
| 225 | IDirectFBWindow *window; /**< The directfb window handle */ | ||
| 226 | IDirectFBSurface *surface; /**< The directfb client surface */ | ||
| 227 | } dfb; | ||
| 228 | #endif | ||
| 229 | #if defined(SDL_VIDEO_DRIVER_COCOA) | ||
| 230 |         struct | ||
| 231 |         { | ||
| 232 | #if defined(__OBJC__) && defined(__has_feature) && __has_feature(objc_arc) | ||
| 233 | NSWindow __unsafe_unretained *window; /**< The Cocoa window */ | ||
| 234 | #else | ||
| 235 | NSWindow *window; /**< The Cocoa window */ | ||
| 236 | #endif | ||
| 237 | } cocoa; | ||
| 238 | #endif | ||
| 239 | #if defined(SDL_VIDEO_DRIVER_UIKIT) | ||
| 240 |         struct | ||
| 241 |         { | ||
| 242 | #if defined(__OBJC__) && defined(__has_feature) && __has_feature(objc_arc) | ||
| 243 | UIWindow __unsafe_unretained *window; /**< The UIKit window */ | ||
| 244 | #else | ||
| 245 | UIWindow *window; /**< The UIKit window */ | ||
| 246 | #endif | ||
| 247 | GLuint framebuffer; /**< The GL view's Framebuffer Object. It must be bound when rendering to the screen using GL. */ | ||
| 248 | GLuint colorbuffer; /**< The GL view's color Renderbuffer Object. It must be bound when SDL_GL_SwapWindow is called. */ | ||
| 249 | GLuint resolveFramebuffer; /**< The Framebuffer Object which holds the resolve color Renderbuffer, when MSAA is used. */ | ||
| 250 | } uikit; | ||
| 251 | #endif | ||
| 252 | #if defined(SDL_VIDEO_DRIVER_WAYLAND) | ||
| 253 |         struct | ||
| 254 |         { | ||
| 255 | struct wl_display *display; /**< Wayland display */ | ||
| 256 | struct wl_surface *surface; /**< Wayland surface */ | ||
| 257 | struct wl_shell_surface *shell_surface; /**< Wayland shell_surface (window manager handle) */ | ||
| 258 | } wl; | ||
| 259 | #endif | ||
| 260 | #if defined(SDL_VIDEO_DRIVER_MIR) | ||
| 261 |         struct | ||
| 262 |         { | ||
| 263 | struct MirConnection *connection; /**< Mir display server connection */ | ||
| 264 | struct MirSurface *surface; /**< Mir surface */ | ||
| 265 | } mir; | ||
| 266 | #endif | ||
| 267 | |||
| 268 | #if defined(SDL_VIDEO_DRIVER_ANDROID) | ||
| 269 |         struct | ||
| 270 |         { | ||
| 271 | ANativeWindow *window; | ||
| 272 |             EGLSurface surface; | ||
| 273 | } android; | ||
| 274 | #endif | ||
| 275 | |||
| 276 | #if defined(SDL_VIDEO_DRIVER_VIVANTE) | ||
| 277 |         struct | ||
| 278 |         { | ||
| 279 |             EGLNativeDisplayType display; | ||
| 280 |             EGLNativeWindowType window; | ||
| 281 | } vivante; | ||
| 282 | #endif | ||
| 283 | |||
| 284 |         /* Make sure this union is always 64 bytes (8 64-bit pointers). */ | ||
| 285 |         /* Be careful not to overflow this if you add a new target! */ | ||
| 286 | Uint8 dummy[64]; | ||
| 287 | } info; | ||
| 288 | }; | ||
| 289 | |||
| 290 | #endif /* SDL_PROTOTYPES_ONLY */ | ||
| 291 | |||
| 292 | typedef struct SDL_SysWMinfo SDL_SysWMinfo; | ||
| 293 | |||
| 294 | /* Function prototypes */ | ||
| 295 | /** | ||
| 296 |  *  \brief This function allows access to driver-dependent window information. | ||
| 297 |  * | ||
| 298 |  *  \param window The window about which information is being requested | ||
| 299 |  *  \param info This structure must be initialized with the SDL version, and is | ||
| 300 |  *              then filled in with information about the given window. | ||
| 301 |  * | ||
| 302 |  *  \return SDL_TRUE if the function is implemented and the version member of | ||
| 303 |  *          the \c info struct is valid, SDL_FALSE otherwise. | ||
| 304 |  * | ||
| 305 |  *  You typically use this function like this: | ||
| 306 |  *  \code | ||
| 307 |  *  SDL_SysWMinfo info; | ||
| 308 |  *  SDL_VERSION(&info.version); | ||
| 309 |  *  if ( SDL_GetWindowWMInfo(window, &info) ) { ... } | ||
| 310 |  *  \endcode | ||
| 311 |  */ | ||
| 312 | extern DECLSPEC SDL_bool SDLCALL SDL_GetWindowWMInfo(SDL_Window * window, | ||
| 313 | SDL_SysWMinfo * info); | ||
| 314 | |||
| 315 | |||
| 316 | /* Ends C function definitions when using C++ */ | ||
| 317 | #ifdef __cplusplus | ||
| 318 | } | ||
| 319 | #endif | ||
| 320 | #include "close_code.h" | ||
| 321 | |||
| 322 | #endif /* SDL_syswm_h_ */ | ||
| 323 | |||
| 324 | /* vi: set ts=4 sw=4 expandtab: */ |