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: */ |