Rev 1 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
| Rev 1 | Rev 8 | ||
|---|---|---|---|
| Line 1... | Line 1... | ||
| 1 | /* |
1 | /* |
| 2 | Simple DirectMedia Layer |
2 | Simple DirectMedia Layer |
| 3 | Copyright (C) 1997- |
3 | Copyright (C) 1997-2018 Sam Lantinga <slouken@libsdl.org> |
| 4 | 4 | ||
| 5 | This software is provided 'as-is', without any express or implied |
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 |
6 | warranty. In no event will the authors be held liable for any damages |
| 7 | arising from the use of this software. |
7 | arising from the use of this software. |
| 8 | 8 | ||
| Line 108... | Line 108... | ||
| 108 | SDL_WINDOW_INPUT_GRABBED = 0x00000100, /**< window has grabbed input focus */ |
108 | SDL_WINDOW_INPUT_GRABBED = 0x00000100, /**< window has grabbed input focus */ |
| 109 | SDL_WINDOW_INPUT_FOCUS = 0x00000200, /**< window has input focus */ |
109 | SDL_WINDOW_INPUT_FOCUS = 0x00000200, /**< window has input focus */ |
| 110 | SDL_WINDOW_MOUSE_FOCUS = 0x00000400, /**< window has mouse focus */ |
110 | SDL_WINDOW_MOUSE_FOCUS = 0x00000400, /**< window has mouse focus */ |
| 111 | SDL_WINDOW_FULLSCREEN_DESKTOP = ( SDL_WINDOW_FULLSCREEN | 0x00001000 ), |
111 | SDL_WINDOW_FULLSCREEN_DESKTOP = ( SDL_WINDOW_FULLSCREEN | 0x00001000 ), |
| 112 | SDL_WINDOW_FOREIGN = 0x00000800, /**< window not created by SDL */ |
112 | SDL_WINDOW_FOREIGN = 0x00000800, /**< window not created by SDL */ |
| 113 | SDL_WINDOW_ALLOW_HIGHDPI = 0x00002000, /**< window should be created in high-DPI mode if supported |
113 | SDL_WINDOW_ALLOW_HIGHDPI = 0x00002000, /**< window should be created in high-DPI mode if supported. |
| - | 114 | On macOS NSHighResolutionCapable must be set true in the |
|
| - | 115 | application's Info.plist for this to have any effect. */ |
|
| 114 | SDL_WINDOW_MOUSE_CAPTURE = 0x00004000, /**< window has mouse captured (unrelated to INPUT_GRABBED) */ |
116 | SDL_WINDOW_MOUSE_CAPTURE = 0x00004000, /**< window has mouse captured (unrelated to INPUT_GRABBED) */ |
| 115 | SDL_WINDOW_ALWAYS_ON_TOP = 0x00008000, /**< window should always be above others */ |
117 | SDL_WINDOW_ALWAYS_ON_TOP = 0x00008000, /**< window should always be above others */ |
| 116 | SDL_WINDOW_SKIP_TASKBAR = 0x00010000, /**< window should not be added to the taskbar */ |
118 | SDL_WINDOW_SKIP_TASKBAR = 0x00010000, /**< window should not be added to the taskbar */ |
| 117 | SDL_WINDOW_UTILITY = 0x00020000, /**< window should be treated as a utility window */ |
119 | SDL_WINDOW_UTILITY = 0x00020000, /**< window should be treated as a utility window */ |
| 118 | SDL_WINDOW_TOOLTIP = 0x00040000, /**< window should be treated as a tooltip */ |
120 | SDL_WINDOW_TOOLTIP = 0x00040000, /**< window should be treated as a tooltip */ |
| Line 164... | Line 166... | ||
| 164 | SDL_WINDOWEVENT_FOCUS_LOST, /**< Window has lost keyboard focus */ |
166 | SDL_WINDOWEVENT_FOCUS_LOST, /**< Window has lost keyboard focus */ |
| 165 | SDL_WINDOWEVENT_CLOSE, /**< The window manager requests that the window be closed */ |
167 | SDL_WINDOWEVENT_CLOSE, /**< The window manager requests that the window be closed */ |
| 166 | SDL_WINDOWEVENT_TAKE_FOCUS, /**< Window is being offered a focus (should SetWindowInputFocus() on itself or a subwindow, or ignore) */ |
168 | SDL_WINDOWEVENT_TAKE_FOCUS, /**< Window is being offered a focus (should SetWindowInputFocus() on itself or a subwindow, or ignore) */ |
| 167 | SDL_WINDOWEVENT_HIT_TEST /**< Window had a hit test that wasn't SDL_HITTEST_NORMAL. */ |
169 | SDL_WINDOWEVENT_HIT_TEST /**< Window had a hit test that wasn't SDL_HITTEST_NORMAL. */ |
| 168 | } SDL_WindowEventID; |
170 | } SDL_WindowEventID; |
| - | 171 | ||
| - | 172 | /** |
|
| - | 173 | * \brief Event subtype for display events |
|
| - | 174 | */ |
|
| - | 175 | typedef enum |
|
| - | 176 | { |
|
| - | 177 | SDL_DISPLAYEVENT_NONE, /**< Never used */ |
|
| - | 178 | SDL_DISPLAYEVENT_ORIENTATION /**< Display orientation has changed to data1 */ |
|
| - | 179 | } SDL_DisplayEventID; |
|
| - | 180 | ||
| - | 181 | typedef enum |
|
| - | 182 | { |
|
| - | 183 | SDL_ORIENTATION_UNKNOWN, /**< The display orientation can't be determined */ |
|
| - | 184 | SDL_ORIENTATION_LANDSCAPE, /**< The display is in landscape mode, with the right side up, relative to portrait mode */ |
|
| - | 185 | SDL_ORIENTATION_LANDSCAPE_FLIPPED, /**< The display is in landscape mode, with the left side up, relative to portrait mode */ |
|
| - | 186 | SDL_ORIENTATION_PORTRAIT, /**< The display is in portrait mode */ |
|
| - | 187 | SDL_ORIENTATION_PORTRAIT_FLIPPED /**< The display is in portrait mode, upside down */ |
|
| - | 188 | } SDL_DisplayOrientation; |
|
| 169 | 189 | ||
| 170 | /** |
190 | /** |
| 171 | * \brief An opaque handle to an OpenGL context. |
191 | * \brief An opaque handle to an OpenGL context. |
| 172 | */ |
192 | */ |
| 173 | typedef void *SDL_GLContext; |
193 | typedef void *SDL_GLContext; |
| Line 311... | Line 331... | ||
| 311 | * \return 0 on success, or -1 if the index is out of range. |
331 | * \return 0 on success, or -1 if the index is out of range. |
| 312 | * |
332 | * |
| 313 | * \sa SDL_GetNumVideoDisplays() |
333 | * \sa SDL_GetNumVideoDisplays() |
| 314 | */ |
334 | */ |
| 315 | extern DECLSPEC int SDLCALL SDL_GetDisplayBounds(int displayIndex, SDL_Rect * rect); |
335 | extern DECLSPEC int SDLCALL SDL_GetDisplayBounds(int displayIndex, SDL_Rect * rect); |
| 316 | - | ||
| 317 | /** |
- | |
| 318 | * \brief Get the dots/pixels-per-inch for a display |
- | |
| 319 | * |
- | |
| 320 | * \note Diagonal, horizontal and vertical DPI can all be optionally |
- | |
| 321 | * returned if the parameter is non-NULL. |
- | |
| 322 | * |
- | |
| 323 | * \return 0 on success, or -1 if no DPI information is available or the index is out of range. |
- | |
| 324 | * |
- | |
| 325 | * \sa SDL_GetNumVideoDisplays() |
- | |
| 326 | */ |
- | |
| 327 | extern DECLSPEC int SDLCALL SDL_GetDisplayDPI(int displayIndex, float * ddpi, float * hdpi, float * vdpi); |
- | |
| 328 | 336 | ||
| 329 | /** |
337 | /** |
| 330 | * \brief Get the usable desktop area represented by a display, with the |
338 | * \brief Get the usable desktop area represented by a display, with the |
| 331 | * primary display located at 0,0 |
339 | * primary display located at 0,0 |
| 332 | * |
340 | * |
| Line 342... | Line 350... | ||
| 342 | * |
350 | * |
| 343 | * \sa SDL_GetDisplayBounds() |
351 | * \sa SDL_GetDisplayBounds() |
| 344 | * \sa SDL_GetNumVideoDisplays() |
352 | * \sa SDL_GetNumVideoDisplays() |
| 345 | */ |
353 | */ |
| 346 | extern DECLSPEC int SDLCALL SDL_GetDisplayUsableBounds(int displayIndex, SDL_Rect * rect); |
354 | extern DECLSPEC int SDLCALL SDL_GetDisplayUsableBounds(int displayIndex, SDL_Rect * rect); |
| - | 355 | ||
| - | 356 | /** |
|
| - | 357 | * \brief Get the dots/pixels-per-inch for a display |
|
| - | 358 | * |
|
| - | 359 | * \note Diagonal, horizontal and vertical DPI can all be optionally |
|
| - | 360 | * returned if the parameter is non-NULL. |
|
| - | 361 | * |
|
| - | 362 | * \return 0 on success, or -1 if no DPI information is available or the index is out of range. |
|
| - | 363 | * |
|
| - | 364 | * \sa SDL_GetNumVideoDisplays() |
|
| - | 365 | */ |
|
| - | 366 | extern DECLSPEC int SDLCALL SDL_GetDisplayDPI(int displayIndex, float * ddpi, float * hdpi, float * vdpi); |
|
| - | 367 | ||
| - | 368 | /** |
|
| - | 369 | * \brief Get the orientation of a display |
|
| - | 370 | * |
|
| - | 371 | * \return The orientation of the display, or SDL_ORIENTATION_UNKNOWN if it isn't available. |
|
| - | 372 | * |
|
| - | 373 | * \sa SDL_GetNumVideoDisplays() |
|
| - | 374 | */ |
|
| - | 375 | extern DECLSPEC SDL_DisplayOrientation SDLCALL SDL_GetDisplayOrientation(int displayIndex); |
|
| 347 | 376 | ||
| 348 | /** |
377 | /** |
| 349 | * \brief Returns the number of available display modes. |
378 | * \brief Returns the number of available display modes. |
| 350 | * |
379 | * |
| 351 | * \sa SDL_GetDisplayMode() |
380 | * \sa SDL_GetDisplayMode() |
| Line 468... | Line 497... | ||
| 468 | * drawable size in pixels. |
497 | * drawable size in pixels. |
| 469 | * |
498 | * |
| 470 | * If the window is created with any of the SDL_WINDOW_OPENGL or |
499 | * If the window is created with any of the SDL_WINDOW_OPENGL or |
| 471 | * SDL_WINDOW_VULKAN flags, then the corresponding LoadLibrary function |
500 | * SDL_WINDOW_VULKAN flags, then the corresponding LoadLibrary function |
| 472 | * (SDL_GL_LoadLibrary or SDL_Vulkan_LoadLibrary) is called and the |
501 | * (SDL_GL_LoadLibrary or SDL_Vulkan_LoadLibrary) is called and the |
| 473 | * |
502 | * corresponding UnloadLibrary function is called by SDL_DestroyWindow(). |
| 474 | * |
503 | * |
| 475 | * If SDL_WINDOW_VULKAN is specified and there isn't a working Vulkan driver, |
504 | * If SDL_WINDOW_VULKAN is specified and there isn't a working Vulkan driver, |
| 476 | * SDL_CreateWindow() will fail because SDL_Vulkan_LoadLibrary() will fail. |
505 | * SDL_CreateWindow() will fail because SDL_Vulkan_LoadLibrary() will fail. |
| 477 | * |
506 | * |
| 478 | * \note On non-Apple devices, SDL requires you to either not link to the |
507 | * \note On non-Apple devices, SDL requires you to either not link to the |