4#include <SDL3/SDL_video.h>
5#include "SDL3pp_properties.h"
6#include "SDL3pp_rect.h"
7#include "SDL3pp_surface.h"
70 constexpr explicit operator bool()
const {
return !!
value; }
106 constexpr explicit operator bool()
const {
return !!
value; }
126 SDL_ORIENTATION_UNKNOWN;
139 SDL_ORIENTATION_LANDSCAPE_FLIPPED;
142 SDL_ORIENTATION_PORTRAIT;
145 SDL_ORIENTATION_PORTRAIT_FLIPPED;
182 : m_displayID(displayID)
191 constexpr operator DisplayID()
const {
return m_displayID; }
428 bool include_high_density_modes)
const;
480namespace prop::Global {
494constexpr auto VIDEO_WAYLAND_WL_DISPLAY_POINTER =
495 SDL_PROP_GLOBAL_VIDEO_WAYLAND_WL_DISPLAY_POINTER;
507 SDL_SYSTEM_THEME_UNKNOWN;
510 SDL_SYSTEM_THEME_LIGHT;
513 SDL_SYSTEM_THEME_DARK;
541 SDL_WINDOW_FULLSCREEN;
556 SDL_WINDOW_BORDERLESS;
559 SDL_WINDOW_RESIZABLE;
562 SDL_WINDOW_MINIMIZED;
565 SDL_WINDOW_MAXIMIZED;
568 SDL_WINDOW_MOUSE_GRABBED;
571 SDL_WINDOW_INPUT_FOCUS;
574 SDL_WINDOW_MOUSE_FOCUS;
588 SDL_WINDOW_MOUSE_RELATIVE_MODE;
591 SDL_WINDOW_ALWAYS_ON_TOP;
609 SDL_WINDOW_KEYBOARD_GRABBED;
618 SDL_WINDOW_TRANSPARENT;
621 SDL_WINDOW_NOT_FOCUSABLE;
637 SDL_FLASH_UNTIL_FOCUSED;
655 SDL_HITTEST_DRAGGABLE;
658 SDL_HITTEST_RESIZE_TOPLEFT;
662 SDL_HITTEST_RESIZE_TOP;
665 SDL_HITTEST_RESIZE_TOPRIGHT;
669 SDL_HITTEST_RESIZE_RIGHT;
673 SDL_HITTEST_RESIZE_BOTTOMRIGHT;
676 SDL_HITTEST_RESIZE_BOTTOM;
679 SDL_HITTEST_RESIZE_BOTTOMLEFT;
683 SDL_HITTEST_RESIZE_LEFT;
744 : m_resource(resource)
848 : m_resource(SDL_CreateWindow(title, size.x, size.y, flags))
927 : m_resource(SDL_CreatePopupWindow(parent,
1061 : m_resource(SDL_CreateWindowWithProperties(props))
1071 std::swap(m_resource, other.m_resource);
1081 auto r = m_resource;
1082 m_resource =
nullptr;
1090 constexpr bool operator==(std::nullptr_t _)
const {
return !m_resource; }
1093 constexpr explicit operator bool()
const {
return !!m_resource; }
1635 void GetSize(
int* w,
int* h)
const;
1791 void GetBordersSize(
int* top,
int* left,
int* bottom,
int* right)
const;
3000 return SDL_WINDOWPOS_UNDEFINED_DISPLAY(X);
3021 return SDL_WINDOWPOS_ISUNDEFINED(X);
3046 return SDL_WINDOWPOS_CENTERED_DISPLAY(X);
3067 return SDL_WINDOWPOS_ISCENTERED(X);
3093 : m_resource(resource)
3129 : m_resource(SDL_GL_CreateContext(window))
3139 std::swap(m_resource, other.m_resource);
3149 auto r = m_resource;
3150 m_resource =
nullptr;
3158 constexpr bool operator==(std::nullptr_t _)
const {
return !m_resource; }
3161 constexpr explicit operator bool()
const {
return !!m_resource; }
3454 SDL_GL_RETAINED_BACKING;
3457 SDL_GL_CONTEXT_MAJOR_VERSION;
3460 SDL_GL_CONTEXT_MINOR_VERSION;
3475 SDL_GL_SHARE_WITH_CURRENT_CONTEXT;
3478 SDL_GL_FRAMEBUFFER_SRGB_CAPABLE;
3492 SDL_GL_CONTEXT_RESET_NOTIFICATION;
3495 SDL_GL_CONTEXT_NO_ERROR;
3509 SDL_GL_CONTEXT_PROFILE_CORE;
3512 SDL_GL_CONTEXT_PROFILE_COMPATIBILITY;
3516 SDL_GL_CONTEXT_PROFILE_ES;
3526 SDL_GL_CONTEXT_DEBUG_FLAG;
3529 SDL_GL_CONTEXT_FORWARD_COMPATIBLE_FLAG;
3532 SDL_GL_CONTEXT_ROBUST_ACCESS_FLAG;
3535 SDL_GL_CONTEXT_RESET_ISOLATION_FLAG;
3545 SDL_GL_CONTEXT_RELEASE_BEHAVIOR_NONE;
3548 SDL_GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH;
3558 SDL_GL_CONTEXT_RESET_NO_NOTIFICATION;
3561 SDL_GL_CONTEXT_RESET_LOSE_CONTEXT;
3597 return SDL_GetVideoDriver(index);
3619 return SDL_GetCurrentVideoDriver();
3646 auto data =
reinterpret_cast<DisplayID*
>(SDL_GetDisplays(&count));
3698 return {
CheckError(SDL_GetDisplayProperties(displayID))};
3706namespace prop::Display {
3708constexpr auto HDR_ENABLED_BOOLEAN = SDL_PROP_DISPLAY_HDR_ENABLED_BOOLEAN;
3710constexpr auto KMSDRM_PANEL_ORIENTATION_NUMBER =
3711 SDL_PROP_DISPLAY_KMSDRM_PANEL_ORIENTATION_NUMBER;
3730 return SDL_GetDisplayName(displayID);
3758 SDL_GetDisplayBounds(displayID, &bounds);
3792 SDL_GetDisplayUsableBounds(displayID, &bounds);
3816 return SDL_GetNaturalDisplayOrientation(displayID);
3839 return SDL_GetCurrentDisplayOrientation(displayID);
3874 return SDL_GetDisplayContentScale(displayID);
3907 auto data =
CheckError(SDL_GetFullscreenDisplayModes(displayID, &count));
3946 bool include_high_density_modes)
3949 CheckError(SDL_GetClosestFullscreenDisplayMode(displayID,
3953 include_high_density_modes,
3961 bool include_high_density_modes)
const
3964 m_displayID, size, refresh_rate, include_high_density_modes);
3988 return *SDL_GetDesktopDisplayMode(displayID);
4017 return *SDL_GetCurrentDisplayMode(displayID);
4041 return SDL_GetDisplayForPoint(&point);
4066 return CheckError(SDL_GetDisplayForRect(&rect));
4091 return CheckError(SDL_GetDisplayForWindow(window));
4118 return SDL_GetWindowPixelDensity(window);
4149 return SDL_GetWindowDisplayScale(window);
4191 CheckError(SDL_SetWindowFullscreenMode(window, mode));
4215 return *SDL_GetWindowFullscreenMode(window);
4258 return CheckError(SDL_GetWindowPixelFormat(window));
4279 auto data =
CheckError(SDL_GetWindows(&count));
4372 return Window(std::move(title), size, flags);
4451 return Window(parent, offset, size, flags);
4583namespace prop::Window {
4585constexpr auto CREATE_ALWAYS_ON_TOP_BOOLEAN =
4586 SDL_PROP_WINDOW_CREATE_ALWAYS_ON_TOP_BOOLEAN;
4588constexpr auto CREATE_BORDERLESS_BOOLEAN =
4589 SDL_PROP_WINDOW_CREATE_BORDERLESS_BOOLEAN;
4591#if SDL_VERSION_ATLEAST(3, 2, 18)
4593constexpr auto CREATE_CONSTRAIN_POPUP_BOOLEAN =
4594 SDL_PROP_WINDOW_CREATE_CONSTRAIN_POPUP_BOOLEAN;
4598constexpr auto CREATE_FOCUSABLE_BOOLEAN =
4599 SDL_PROP_WINDOW_CREATE_FOCUSABLE_BOOLEAN;
4601constexpr auto CREATE_EXTERNAL_GRAPHICS_CONTEXT_BOOLEAN =
4602 SDL_PROP_WINDOW_CREATE_EXTERNAL_GRAPHICS_CONTEXT_BOOLEAN;
4604constexpr auto CREATE_FLAGS_NUMBER = SDL_PROP_WINDOW_CREATE_FLAGS_NUMBER;
4606constexpr auto CREATE_FULLSCREEN_BOOLEAN =
4607 SDL_PROP_WINDOW_CREATE_FULLSCREEN_BOOLEAN;
4609constexpr auto CREATE_HEIGHT_NUMBER = SDL_PROP_WINDOW_CREATE_HEIGHT_NUMBER;
4611constexpr auto CREATE_HIDDEN_BOOLEAN = SDL_PROP_WINDOW_CREATE_HIDDEN_BOOLEAN;
4613constexpr auto CREATE_HIGH_PIXEL_DENSITY_BOOLEAN =
4614 SDL_PROP_WINDOW_CREATE_HIGH_PIXEL_DENSITY_BOOLEAN;
4616constexpr auto CREATE_MAXIMIZED_BOOLEAN =
4617 SDL_PROP_WINDOW_CREATE_MAXIMIZED_BOOLEAN;
4619constexpr auto CREATE_MENU_BOOLEAN = SDL_PROP_WINDOW_CREATE_MENU_BOOLEAN;
4621constexpr auto CREATE_METAL_BOOLEAN = SDL_PROP_WINDOW_CREATE_METAL_BOOLEAN;
4623constexpr auto CREATE_MINIMIZED_BOOLEAN =
4624 SDL_PROP_WINDOW_CREATE_MINIMIZED_BOOLEAN;
4626constexpr auto CREATE_MODAL_BOOLEAN = SDL_PROP_WINDOW_CREATE_MODAL_BOOLEAN;
4628constexpr auto CREATE_MOUSE_GRABBED_BOOLEAN =
4629 SDL_PROP_WINDOW_CREATE_MOUSE_GRABBED_BOOLEAN;
4631constexpr auto CREATE_OPENGL_BOOLEAN = SDL_PROP_WINDOW_CREATE_OPENGL_BOOLEAN;
4633constexpr auto CREATE_PARENT_POINTER = SDL_PROP_WINDOW_CREATE_PARENT_POINTER;
4635constexpr auto CREATE_RESIZABLE_BOOLEAN =
4636 SDL_PROP_WINDOW_CREATE_RESIZABLE_BOOLEAN;
4638constexpr auto CREATE_TITLE_STRING = SDL_PROP_WINDOW_CREATE_TITLE_STRING;
4640constexpr auto CREATE_TRANSPARENT_BOOLEAN =
4641 SDL_PROP_WINDOW_CREATE_TRANSPARENT_BOOLEAN;
4643constexpr auto CREATE_TOOLTIP_BOOLEAN = SDL_PROP_WINDOW_CREATE_TOOLTIP_BOOLEAN;
4645constexpr auto CREATE_UTILITY_BOOLEAN = SDL_PROP_WINDOW_CREATE_UTILITY_BOOLEAN;
4647constexpr auto CREATE_VULKAN_BOOLEAN = SDL_PROP_WINDOW_CREATE_VULKAN_BOOLEAN;
4649constexpr auto CREATE_WIDTH_NUMBER = SDL_PROP_WINDOW_CREATE_WIDTH_NUMBER;
4651constexpr auto CREATE_X_NUMBER = SDL_PROP_WINDOW_CREATE_X_NUMBER;
4653constexpr auto CREATE_Y_NUMBER = SDL_PROP_WINDOW_CREATE_Y_NUMBER;
4655constexpr auto CREATE_COCOA_WINDOW_POINTER =
4656 SDL_PROP_WINDOW_CREATE_COCOA_WINDOW_POINTER;
4658constexpr auto CREATE_COCOA_VIEW_POINTER =
4659 SDL_PROP_WINDOW_CREATE_COCOA_VIEW_POINTER;
4661constexpr auto CREATE_WAYLAND_SURFACE_ROLE_CUSTOM_BOOLEAN =
4662 SDL_PROP_WINDOW_CREATE_WAYLAND_SURFACE_ROLE_CUSTOM_BOOLEAN;
4664constexpr auto CREATE_WAYLAND_CREATE_EGL_WINDOW_BOOLEAN =
4665 SDL_PROP_WINDOW_CREATE_WAYLAND_CREATE_EGL_WINDOW_BOOLEAN;
4667constexpr auto CREATE_WAYLAND_WL_SURFACE_POINTER =
4668 SDL_PROP_WINDOW_CREATE_WAYLAND_WL_SURFACE_POINTER;
4670constexpr auto CREATE_WIN32_HWND_POINTER =
4671 SDL_PROP_WINDOW_CREATE_WIN32_HWND_POINTER;
4673constexpr auto CREATE_WIN32_PIXEL_FORMAT_HWND_POINTER =
4674 SDL_PROP_WINDOW_CREATE_WIN32_PIXEL_FORMAT_HWND_POINTER;
4676constexpr auto CREATE_X11_WINDOW_NUMBER =
4677 SDL_PROP_WINDOW_CREATE_X11_WINDOW_NUMBER;
4679constexpr auto SHAPE_POINTER = SDL_PROP_WINDOW_SHAPE_POINTER;
4681constexpr auto HDR_ENABLED_BOOLEAN = SDL_PROP_WINDOW_HDR_ENABLED_BOOLEAN;
4683constexpr auto SDR_WHITE_LEVEL_FLOAT = SDL_PROP_WINDOW_SDR_WHITE_LEVEL_FLOAT;
4685constexpr auto HDR_HEADROOM_FLOAT = SDL_PROP_WINDOW_HDR_HEADROOM_FLOAT;
4687constexpr auto ANDROID_WINDOW_POINTER = SDL_PROP_WINDOW_ANDROID_WINDOW_POINTER;
4689constexpr auto ANDROID_SURFACE_POINTER =
4690 SDL_PROP_WINDOW_ANDROID_SURFACE_POINTER;
4692constexpr auto UIKIT_WINDOW_POINTER = SDL_PROP_WINDOW_UIKIT_WINDOW_POINTER;
4694constexpr auto UIKIT_METAL_VIEW_TAG_NUMBER =
4695 SDL_PROP_WINDOW_UIKIT_METAL_VIEW_TAG_NUMBER;
4697constexpr auto UIKIT_OPENGL_FRAMEBUFFER_NUMBER =
4698 SDL_PROP_WINDOW_UIKIT_OPENGL_FRAMEBUFFER_NUMBER;
4700constexpr auto UIKIT_OPENGL_RENDERBUFFER_NUMBER =
4701 SDL_PROP_WINDOW_UIKIT_OPENGL_RENDERBUFFER_NUMBER;
4703constexpr auto UIKIT_OPENGL_RESOLVE_FRAMEBUFFER_NUMBER =
4704 SDL_PROP_WINDOW_UIKIT_OPENGL_RESOLVE_FRAMEBUFFER_NUMBER;
4706constexpr auto KMSDRM_DEVICE_INDEX_NUMBER =
4707 SDL_PROP_WINDOW_KMSDRM_DEVICE_INDEX_NUMBER;
4709constexpr auto KMSDRM_DRM_FD_NUMBER = SDL_PROP_WINDOW_KMSDRM_DRM_FD_NUMBER;
4711constexpr auto KMSDRM_GBM_DEVICE_POINTER =
4712 SDL_PROP_WINDOW_KMSDRM_GBM_DEVICE_POINTER;
4714constexpr auto COCOA_WINDOW_POINTER = SDL_PROP_WINDOW_COCOA_WINDOW_POINTER;
4716constexpr auto COCOA_METAL_VIEW_TAG_NUMBER =
4717 SDL_PROP_WINDOW_COCOA_METAL_VIEW_TAG_NUMBER;
4719constexpr auto OPENVR_OVERLAY_ID = SDL_PROP_WINDOW_OPENVR_OVERLAY_ID;
4721constexpr auto VIVANTE_DISPLAY_POINTER =
4722 SDL_PROP_WINDOW_VIVANTE_DISPLAY_POINTER;
4724constexpr auto VIVANTE_WINDOW_POINTER = SDL_PROP_WINDOW_VIVANTE_WINDOW_POINTER;
4726constexpr auto VIVANTE_SURFACE_POINTER =
4727 SDL_PROP_WINDOW_VIVANTE_SURFACE_POINTER;
4729constexpr auto WIN32_HWND_POINTER = SDL_PROP_WINDOW_WIN32_HWND_POINTER;
4731constexpr auto WIN32_HDC_POINTER = SDL_PROP_WINDOW_WIN32_HDC_POINTER;
4733constexpr auto WIN32_INSTANCE_POINTER = SDL_PROP_WINDOW_WIN32_INSTANCE_POINTER;
4735constexpr auto WAYLAND_DISPLAY_POINTER =
4736 SDL_PROP_WINDOW_WAYLAND_DISPLAY_POINTER;
4738constexpr auto WAYLAND_SURFACE_POINTER =
4739 SDL_PROP_WINDOW_WAYLAND_SURFACE_POINTER;
4741constexpr auto WAYLAND_VIEWPORT_POINTER =
4742 SDL_PROP_WINDOW_WAYLAND_VIEWPORT_POINTER;
4744constexpr auto WAYLAND_EGL_WINDOW_POINTER =
4745 SDL_PROP_WINDOW_WAYLAND_EGL_WINDOW_POINTER;
4747constexpr auto WAYLAND_XDG_SURFACE_POINTER =
4748 SDL_PROP_WINDOW_WAYLAND_XDG_SURFACE_POINTER;
4750constexpr auto WAYLAND_XDG_TOPLEVEL_POINTER =
4751 SDL_PROP_WINDOW_WAYLAND_XDG_TOPLEVEL_POINTER;
4753constexpr auto WAYLAND_XDG_TOPLEVEL_EXPORT_HANDLE_STRING =
4754 SDL_PROP_WINDOW_WAYLAND_XDG_TOPLEVEL_EXPORT_HANDLE_STRING;
4756constexpr auto WAYLAND_XDG_POPUP_POINTER =
4757 SDL_PROP_WINDOW_WAYLAND_XDG_POPUP_POINTER;
4759constexpr auto WAYLAND_XDG_POSITIONER_POINTER =
4760 SDL_PROP_WINDOW_WAYLAND_XDG_POSITIONER_POINTER;
4762constexpr auto X11_DISPLAY_POINTER = SDL_PROP_WINDOW_X11_DISPLAY_POINTER;
4764constexpr auto X11_SCREEN_NUMBER = SDL_PROP_WINDOW_X11_SCREEN_NUMBER;
4766constexpr auto X11_WINDOW_NUMBER = SDL_PROP_WINDOW_X11_WINDOW_NUMBER;
4811 return {SDL_GetWindowFromID(
id)};
4834 return {
CheckError(SDL_GetWindowParent(window))};
4961 return {
CheckError(SDL_GetWindowProperties(window))};
4989 return SDL_GetWindowFlags(window);
5014 CheckError(SDL_SetWindowTitle(window, title));
5036 return SDL_GetWindowTitle(window);
5112 CheckError(SDL_SetWindowPosition(window, p.x, p.y));
5144 CheckError(SDL_GetWindowPosition(window, x, y));
5218 CheckError(SDL_SetWindowSize(window, size.x, size.y));
5345 CheckError(SDL_GetWindowSafeArea(window, &rect));
5395 CheckError(SDL_SetWindowAspectRatio(window, min_aspect, max_aspect));
5423 CheckError(SDL_GetWindowAspectRatio(window, min_aspect, max_aspect));
5470 CheckError(SDL_GetWindowBordersSize(window, top, left, bottom, right));
5500 CheckError(SDL_GetWindowSizeInPixels(window, w, h));
5551 CheckError(SDL_SetWindowMinimumSize(window, p.x, p.y));
5578 CheckError(SDL_GetWindowMinimumSize(window, w, h));
5602 CheckError(SDL_SetWindowMaximumSize(window, p.x, p.y));
5629 CheckError(SDL_GetWindowMaximumSize(window, w, h));
5658 CheckError(SDL_SetWindowBordered(window, bordered));
5687 CheckError(SDL_SetWindowResizable(window, resizable));
5713 CheckError(SDL_SetWindowAlwaysOnTop(window, on_top));
5920 CheckError(SDL_SetWindowFullscreen(window, fullscreen));
5978 return SDL_WindowHasSurface(window);
6048 CheckError(SDL_SetWindowSurfaceVSync(window, vsync));
6077 CheckError(SDL_GetWindowSurfaceVSync(window, &vsync));
6162 CheckError(SDL_DestroyWindowSurface(window));
6198 CheckError(SDL_SetWindowKeyboardGrab(window, grabbed));
6226 CheckError(SDL_SetWindowMouseGrab(window, grabbed));
6248 return SDL_GetWindowKeyboardGrab(window);
6273 return SDL_GetWindowMouseGrab(window);
6318 CheckError(SDL_SetWindowMouseRect(window, &rect));
6343 return SDL_GetWindowMouseRect(window);
6371 CheckError(SDL_SetWindowOpacity(window, opacity));
6397 return SDL_GetWindowOpacity(window);
6438 CheckError(SDL_SetWindowParent(window, parent));
6465 CheckError(SDL_SetWindowModal(window, modal));
6486 CheckError(SDL_SetWindowFocusable(window, focusable));
6516 CheckError(SDL_ShowWindowSystemMenu(window, p.x, p.y));
6567 void* callback_data)
6570 Wrapper::erase(window);
6571 CheckError(SDL_SetWindowHitTest(window, callback, callback_data));
6617 void* cbHandle = Wrapper::Wrap(window, std::move(callback));
6620 [](SDL_Window* win,
const SDL_Point* area,
void* data) {
6621 return Wrapper::Call(data, win,
Point(*area));
6662 CheckError(SDL_SetWindowShape(window, shape));
6683 CheckError(SDL_FlashWindow(window, operation));
6713 Wrapper::erase(window);
6714 SDL_DestroyWindow(window);
6852 return SDL_GL_GetProcAddress(proc);
6874 return SDL_EGL_GetProcAddress(proc);
6910 return SDL_GL_ExtensionSupported(extension);
6946 CheckError(SDL_GL_SetAttribute(attr, value));
6965 CheckError(SDL_GL_GetAttribute(attr, value));
7040 return {
CheckError(SDL_GL_GetCurrentWindow())};
7069 return SDL_EGL_GetCurrentDisplay();
7097 return SDL_EGL_GetWindowSurface(window);
7131 SDL_EGL_SetAttributeCallbacks(platformAttribCallback,
7132 surfaceAttribCallback,
7133 contextAttribCallback,
7167 CheckError(SDL_GL_SetSwapInterval(interval));
7190 CheckError(SDL_GL_GetSwapInterval(interval));
This is a unique ID for a display for the time it is connected to the system, and is never reused for...
Definition: SDL3pp_video.h:172
constexpr Display(DisplayID displayID={})
Wraps Display.
Definition: SDL3pp_video.h:181
An opaque handle to an OpenGL context.
Definition: SDL3pp_video.h:3080
constexpr GLContextRaw release()
Retrieves underlying GLContextRaw and clear this.
Definition: SDL3pp_video.h:3147
constexpr GLContext(const GLContext &other)=default
Copy constructor.
constexpr GLContext()=default
Default ctor.
constexpr auto operator<=>(const GLContext &other) const =default
Comparison.
GLContext(WindowParam window)
Create an OpenGL context for an OpenGL window, and make it current.
Definition: SDL3pp_video.h:3128
constexpr GLContext(GLContext &&other)
Move constructor.
Definition: SDL3pp_video.h:3101
constexpr bool operator==(std::nullptr_t _) const
Comparison.
Definition: SDL3pp_video.h:3158
~GLContext()
Destructor.
Definition: SDL3pp_video.h:3134
constexpr GLContext(const GLContextRaw resource)
Constructs from GLContextParam.
Definition: SDL3pp_video.h:3092
constexpr GLContextRaw get() const
Retrieves underlying GLContextRaw.
Definition: SDL3pp_video.h:3144
GLContext & operator=(GLContext other)
Assignment operator.
Definition: SDL3pp_video.h:3137
Optional-like shim for references.
Definition: SDL3pp_optionalRef.h:20
Base class for SDL memory allocated array wrap.
Definition: SDL3pp_ownPtr.h:44
span-like for empty-derived structs
Definition: SDL3pp_spanRef.h:24
constexpr T * data() const
Retrieves contained data.
Definition: SDL3pp_spanRef.h:75
constexpr size_t size() const
Retrieves contained size.
Definition: SDL3pp_spanRef.h:69
Helpers to use C++ strings parameters.
Definition: SDL3pp_strings.h:43
A collection of pixels used in software blitting.
Definition: SDL3pp_surface.h:201
static constexpr Surface Borrow(SurfaceParam resource)
Safely borrows the from SurfaceParam.
Definition: SDL3pp_surface.h:378
The struct used as an opaque handle to a window.
Definition: SDL3pp_video.h:729
constexpr WindowRaw get() const
Retrieves underlying WindowRaw.
Definition: SDL3pp_video.h:1076
constexpr Window(const WindowRaw resource)
Constructs from WindowParam.
Definition: SDL3pp_video.h:743
constexpr WindowRaw release()
Retrieves underlying WindowRaw and clear this.
Definition: SDL3pp_video.h:1079
Window(WindowParam parent, const PointRaw &offset, const PointRaw &size, WindowFlags flags=0)
Create a child popup window of the specified parent window.
Definition: SDL3pp_video.h:923
constexpr Window(Window &&other)
Move constructor.
Definition: SDL3pp_video.h:752
constexpr Window(const Window &other)=delete
Copy constructor.
Window & operator=(Window other)
Assignment operator.
Definition: SDL3pp_video.h:1069
constexpr auto operator<=>(const Window &other) const =default
Comparison.
Window(StringParam title, const PointRaw &size, WindowFlags flags=0)
Create a window with the specified dimensions and flags.
Definition: SDL3pp_video.h:847
~Window()
Destructor.
Definition: SDL3pp_video.h:1066
constexpr bool operator==(std::nullptr_t _) const
Comparison.
Definition: SDL3pp_video.h:1090
Window(PropertiesParam props)
Create a window with the specified properties.
Definition: SDL3pp_video.h:1060
constexpr Window()=default
Default ctor.
constexpr void CheckError(bool result)
Check and throw if returned value from SDL is an error.
Definition: SDL3pp_error.h:197
void GetTextInputArea(RectRaw *rect, int *cursor)
Get the area used to type Unicode text input.
Definition: SDL3pp_keyboard.h:342
void ClearComposition()
Dismiss the composition window/IME without disabling the subsystem.
Definition: SDL3pp_keyboard.h:332
void StartTextInput()
Start accepting Unicode text input events in a window.
Definition: SDL3pp_keyboard.h:227
bool IsTextInputActive() const
Check whether or not Unicode text input events are enabled for a window.
Definition: SDL3pp_keyboard.h:322
void StopTextInput()
Stop receiving any text input events in a window.
Definition: SDL3pp_keyboard.h:327
bool IsScreenKeyboardShown() const
Check whether the screen keyboard is shown for given window.
Definition: SDL3pp_keyboard.h:365
void SetTextInputArea(const RectRaw &rect, int cursor)
Set the area used to type Unicode text input.
Definition: SDL3pp_keyboard.h:337
bool GetRelativeMouseMode() const
Query whether relative mouse mode is enabled for a window.
Definition: SDL3pp_mouse.h:721
void SetRelativeMouseMode(bool enabled)
Set relative mouse mode for a window.
Definition: SDL3pp_mouse.h:705
void WarpMouse(const FPointRaw &p)
Move the mouse cursor to the given position within the window.
Definition: SDL3pp_mouse.h:651
std::unique_ptr< T, PtrDeleter > OwnPtr
Handle to an owned SDL memory allocated pointer.
Definition: SDL3pp_ownPtr.h:33
SDL_FPoint FPointRaw
Alias to raw representation for FPoint.
Definition: SDL3pp_rect.h:28
SDL_Rect RectRaw
Alias to raw representation for Rect.
Definition: SDL3pp_rect.h:34
SDL_Point PointRaw
Alias to raw representation for Point.
Definition: SDL3pp_rect.h:22
RendererRef GetRenderer() const
Get the renderer associated with a window.
Definition: SDL3pp_render.h:3415
SDL_FunctionPointer FunctionPointer
A generic function pointer.
Definition: SDL3pp_stdinc.h:6265
::Uint32 Uint32
An unsigned 32-bit integer type.
Definition: SDL3pp_stdinc.h:341
::Uint64 Uint64
An unsigned 64-bit integer type.
Definition: SDL3pp_stdinc.h:371
void DisableScreenSaver()
Prevent the screen from being blanked by a screen saver.
Definition: SDL3pp_video.h:6769
constexpr GLContextFlag GL_CONTEXT_RESET_ISOLATION_FLAG
RESET_ISOLATION_FLAG.
Definition: SDL3pp_video.h:3534
Rect GetBounds() const
Get the desktop area represented by a display.
Definition: SDL3pp_video.h:3762
void SetWindowSurfaceVSync(WindowParam window, int vsync)
Toggle VSync for the window surface.
Definition: SDL3pp_video.h:6046
void GetMaximumSize(int *w, int *h) const
Get the maximum size of a window's client area.
Definition: SDL3pp_video.h:5632
float GetPixelDensity() const
Get the pixel density of a window.
Definition: SDL3pp_video.h:4121
void SetHitTest(HitTest callback, void *callback_data)
Provide a callback that decides if a window region has special properties.
Definition: SDL3pp_video.h:6626
Rect GetWindowSafeArea(WindowParam window)
Get the safe area for this window.
Definition: SDL3pp_video.h:5342
constexpr int WINDOWPOS_CENTERED
Used to indicate that the window position should be centered.
Definition: SDL3pp_video.h:3056
SDL_DisplayOrientation DisplayOrientation
Display orientation values; the way a display is rotated.
Definition: SDL3pp_video.h:123
constexpr GLAttr GL_CONTEXT_RELEASE_BEHAVIOR
sets context the release behavior.
Definition: SDL3pp_video.h:3485
void GetMinimumSize(int *w, int *h) const
Get the minimum size of a window's client area.
Definition: SDL3pp_video.h:5581
Rect GetWindowRect(WindowParam window)
Get the position and client size of a window.
Definition: SDL3pp_video.h:5318
void SetFocusable(bool focusable)
Set whether the window may have input focus.
Definition: SDL3pp_video.h:6489
void GL_SetSwapInterval(int interval)
Set the swap interval for the current OpenGL context.
Definition: SDL3pp_video.h:7165
constexpr HitTestResult HITTEST_DRAGGABLE
Region can drag entire window.
Definition: SDL3pp_video.h:654
constexpr HitTestResult HITTEST_RESIZE_BOTTOMLEFT
Region is the resizable bottom-left corner border.
Definition: SDL3pp_video.h:678
SDL_GLAttr GLAttr
An enumeration of OpenGL configuration attributes.
Definition: SDL3pp_video.h:3370
DisplayOrientation GetNaturalDisplayOrientation(DisplayID displayID)
Get the orientation of a display when it is unrotated.
Definition: SDL3pp_video.h:3814
void GL_DestroyContext(GLContextRaw context)
Delete an OpenGL context.
Definition: SDL3pp_video.h:7229
constexpr FlashOperation FLASH_CANCEL
Cancel any window flash state.
Definition: SDL3pp_video.h:630
int GetWindowSurfaceVSync(WindowParam window)
Get VSync for the window surface.
Definition: SDL3pp_video.h:6074
DisplayMode GetClosestFullscreenDisplayMode(Display displayID, const PointRaw &size, float refresh_rate, bool include_high_density_modes)
Get the closest match to the requested display mode.
Definition: SDL3pp_video.h:3942
void UpdateSurface()
Copy the window surface to the screen.
Definition: SDL3pp_video.h:6109
OwnArray< DisplayMode * > GetFullscreenModes() const
Get a list of fullscreen display modes available on a display.
Definition: SDL3pp_video.h:3911
constexpr bool WINDOWPOS_ISUNDEFINED(int X)
A macro to test if the window position is marked as "undefined.".
Definition: SDL3pp_video.h:3019
constexpr SystemTheme SYSTEM_THEME_LIGHT
Light colored system theme.
Definition: SDL3pp_video.h:509
constexpr WindowFlags WINDOW_MAXIMIZED
window is maximized
Definition: SDL3pp_video.h:564
void EnableScreenSaver()
Allow the screen to be blanked by a screen saver.
Definition: SDL3pp_video.h:6749
void SetRect(Rect rect)
Request the window's position and size to be set.
Definition: SDL3pp_video.h:5302
void GL_GetSwapInterval(int *interval)
Get the swap interval for the current OpenGL context.
Definition: SDL3pp_video.h:7188
void SetAspectRatio(float min_aspect, float max_aspect)
Request that the aspect ratio of a window's client area be set.
Definition: SDL3pp_video.h:5398
void UpdateWindowSurfaceRects(WindowParam window, SpanRef< const RectRaw > rects)
Copy areas of the window surface to the screen.
Definition: SDL3pp_video.h:6136
void SetMinimumSize(const PointRaw &p)
Set the minimum size of a window's client area.
Definition: SDL3pp_video.h:5554
void SetWindowIcon(WindowParam window, SurfaceParam icon)
Set the icon for a window.
Definition: SDL3pp_video.h:5065
Window CreateWindowWithProperties(PropertiesParam props)
Create a window with the specified properties.
Definition: SDL3pp_video.h:4578
constexpr GLAttr GL_FRAMEBUFFER_SRGB_CAPABLE
requests sRGB capable visual; defaults to 0.
Definition: SDL3pp_video.h:3477
constexpr GLAttr GL_MULTISAMPLESAMPLES
the number of samples used around the current pixel used for multisample anti-aliasing.
Definition: SDL3pp_video.h:3445
constexpr SystemTheme SYSTEM_THEME_DARK
Dark colored system theme.
Definition: SDL3pp_video.h:512
WindowID GetID() const
Get the numeric ID of a window.
Definition: SDL3pp_video.h:4791
float GetDisplayScale() const
Get the content display scale relative to a window's pixel size.
Definition: SDL3pp_video.h:4152
Uint64 WindowFlags
The flags on a window.
Definition: SDL3pp_video.h:538
bool GetWindowMouseGrab(WindowParam window)
Get a window's mouse grab mode.
Definition: SDL3pp_video.h:6271
constexpr WindowFlags WINDOW_UTILITY
window should be treated as a utility window, not showing in the task bar and window list
Definition: SDL3pp_video.h:597
constexpr WindowFlags WINDOW_MOUSE_FOCUS
window has mouse focus
Definition: SDL3pp_video.h:573
constexpr GLAttr GL_STENCIL_SIZE
the minimum number of bits in the stencil buffer; defaults to 0.
Definition: SDL3pp_video.h:3409
void SetWindowPosition(WindowParam window, const PointRaw &p)
Request that the window's position be set.
Definition: SDL3pp_video.h:5110
void Restore()
Request that the size and position of a minimized or maximized window be restored.
Definition: SDL3pp_video.h:5887
void GetWindowPosition(WindowParam window, int *x, int *y)
Get the position of a window.
Definition: SDL3pp_video.h:5142
SDL_Window * WindowRaw
Alias to raw representation for Window.
Definition: SDL3pp_video.h:47
void SetWindowFullscreenMode(WindowParam window, OptionalRef< const DisplayMode > mode)
Set the display mode to use when a window is visible and fullscreen.
Definition: SDL3pp_video.h:4188
WindowRef GetWindowParent(WindowParam window)
Get parent of a window.
Definition: SDL3pp_video.h:4832
EGLSurface GetEGLSurface()
Get the EGL surface associated with the window.
Definition: SDL3pp_video.h:7100
void SetWindowSize(WindowParam window, const PointRaw &size)
Request that the size of a window's client area be set.
Definition: SDL3pp_video.h:5216
PropertiesRef GetProperties() const
Get the properties associated with a display.
Definition: SDL3pp_video.h:3701
Uint32 GLContextReleaseFlag
Possible values to be set for the GL_CONTEXT_RELEASE_BEHAVIOR attribute.
Definition: SDL3pp_video.h:3542
constexpr WindowFlags WINDOW_TRANSPARENT
window with transparent buffer
Definition: SDL3pp_video.h:617
void DestroySurface()
Destroy the surface associated with the window.
Definition: SDL3pp_video.h:6165
Point GetSize() const
Get the size of a window's client area.
Definition: SDL3pp_video.h:5282
DisplayMode GetClosestFullscreenMode(const PointRaw &size, float refresh_rate, bool include_high_density_modes) const
Get the closest match to the requested display mode.
Definition: SDL3pp_video.h:3958
const DisplayMode & GetDesktopDisplayMode(DisplayID displayID)
Get information about the desktop's display mode.
Definition: SDL3pp_video.h:3986
FunctionPointer EGL_GetProcAddress(StringParam proc)
Get an EGL library function by name.
Definition: SDL3pp_video.h:6872
constexpr GLProfile GL_CONTEXT_PROFILE_CORE
OpenGL Core Profile context.
Definition: SDL3pp_video.h:3508
constexpr DisplayOrientation ORIENTATION_UNKNOWN
The display orientation can't be determined.
Definition: SDL3pp_video.h:125
constexpr int WINDOWPOS_UNDEFINED_MASK
A magic value used with WINDOWPOS_UNDEFINED.
Definition: SDL3pp_video.h:2986
void FlashWindow(WindowParam window, FlashOperation operation)
Request a window to demand attention from the user.
Definition: SDL3pp_video.h:6681
static WindowRef GetGrabbed()
Get the window that currently has an input grab enabled.
Definition: SDL3pp_video.h:6295
void GL_SwapWindow(WindowParam window)
Update a window with OpenGL rendering.
Definition: SDL3pp_video.h:7210
SDL_HitTest HitTest
Callback used for hit-testing.
Definition: SDL3pp_video.h:695
constexpr int WINDOW_SURFACE_VSYNC_ADAPTIVE
Constant to enable adaptive vsync.
Definition: SDL3pp_video.h:6060
void GetWindowAspectRatio(WindowParam window, float *min_aspect, float *max_aspect)
Get the size of a window's client area.
Definition: SDL3pp_video.h:5419
constexpr HitTestResult HITTEST_RESIZE_TOPRIGHT
Region is the resizable top-right corner border.
Definition: SDL3pp_video.h:664
constexpr GLAttr GL_CONTEXT_MAJOR_VERSION
OpenGL context major version.
Definition: SDL3pp_video.h:3456
constexpr HitTestResult HITTEST_NORMAL
Region is normal. No special properties.
Definition: SDL3pp_video.h:651
void GL_Swap()
Update a window with OpenGL rendering.
Definition: SDL3pp_video.h:7215
void SetPosition(const PointRaw &p)
Request that the window's position be set.
Definition: SDL3pp_video.h:5115
Surface GetSurface()
Get the SDL surface associated with the window.
Definition: SDL3pp_video.h:6018
constexpr GLContextFlag GL_CONTEXT_FORWARD_COMPATIBLE_FLAG
FORWARD_COMPATIBLE_FLAG.
Definition: SDL3pp_video.h:3528
constexpr int WINDOWPOS_UNDEFINED_DISPLAY(int X)
Used to indicate that you don't care what the window position is.
Definition: SDL3pp_video.h:2998
WindowRef GL_GetCurrentWindow()
Get the currently active OpenGL window.
Definition: SDL3pp_video.h:7038
constexpr GLAttr GL_RETAINED_BACKING
not used (deprecated).
Definition: SDL3pp_video.h:3453
Rect GetDisplayUsableBounds(Display displayID)
Get the usable desktop area represented by a display, in screen coordinates.
Definition: SDL3pp_video.h:3789
Display GetDisplay() const
Get the display associated with a window.
Definition: SDL3pp_video.h:4094
constexpr HitTestResult HITTEST_RESIZE_RIGHT
Region is the resizable right border.
Definition: SDL3pp_video.h:668
float GetContentScale() const
Get the content scale of a display.
Definition: SDL3pp_video.h:3877
float GetOpacity() const
Get the opacity of a window.
Definition: SDL3pp_video.h:6400
constexpr FlashOperation FLASH_BRIEFLY
Flash the window briefly to get attention.
Definition: SDL3pp_video.h:633
void DestroyWindowSurface(WindowParam window)
Destroy the surface associated with the window.
Definition: SDL3pp_video.h:6160
void GL_UnloadLibrary()
Unload the OpenGL library previously loaded by GL_LoadLibrary().
Definition: SDL3pp_video.h:6886
bool GetWindowKeyboardGrab(WindowParam window)
Get a window's keyboard grab mode.
Definition: SDL3pp_video.h:6246
constexpr GLAttr GL_STEREO
whether the output is stereo 3D; defaults to off.
Definition: SDL3pp_video.h:3435
constexpr GLAttr GL_CONTEXT_MINOR_VERSION
OpenGL context minor version.
Definition: SDL3pp_video.h:3459
constexpr GLAttr GL_CONTEXT_PROFILE_MASK
type of GL context (Core, Compatibility, ES).
Definition: SDL3pp_video.h:3472
DisplayOrientation GetCurrentDisplayOrientation(DisplayID displayID)
Get the orientation of a display.
Definition: SDL3pp_video.h:3837
constexpr GLAttr GL_RED_SIZE
the minimum number of bits for the red channel of the color buffer; defaults to 8.
Definition: SDL3pp_video.h:3376
Display GetDisplayForRect(const RectRaw &rect)
Get the display primarily containing a rect.
Definition: SDL3pp_video.h:4064
constexpr WindowFlags WINDOW_MOUSE_GRABBED
window has grabbed mouse input
Definition: SDL3pp_video.h:567
bool ScreenSaverEnabled()
Check whether the screensaver is currently enabled.
Definition: SDL3pp_video.h:6735
Display GetDisplayForPoint(const PointRaw &point)
Get the display containing a point.
Definition: SDL3pp_video.h:4039
constexpr GLAttr GL_GREEN_SIZE
the minimum number of bits for the green channel of the color buffer; defaults to 8.
Definition: SDL3pp_video.h:3382
FunctionPointer GL_GetProcAddress(StringParam proc)
Get an OpenGL function by name.
Definition: SDL3pp_video.h:6850
SDL_EGLAttribArrayCallback EGLAttribArrayCallback
EGL platform attribute initialization callback.
Definition: SDL3pp_video.h:3262
constexpr GLAttr GL_CONTEXT_RESET_NOTIFICATION
set context reset notification.
Definition: SDL3pp_video.h:3491
Window CreateWindow(StringParam title, const PointRaw &size, WindowFlags flags)
Create a window with the specified dimensions and flags.
Definition: SDL3pp_video.h:4368
SDL_DisplayID DisplayID
Alias to raw representation for Display.
Definition: SDL3pp_video.h:38
constexpr GLProfile GL_CONTEXT_PROFILE_COMPATIBILITY
OpenGL Compatibility Profile context.
Definition: SDL3pp_video.h:3511
float GetDisplayContentScale(DisplayID displayID)
Get the content scale of a display.
Definition: SDL3pp_video.h:3872
GLContext GL_CreateContext(WindowParam window)
Create an OpenGL context for an OpenGL window, and make it current.
Definition: SDL3pp_video.h:6990
void SetWindowMinimumSize(WindowParam window, const PointRaw &p)
Set the minimum size of a window's client area.
Definition: SDL3pp_video.h:5549
SDL_DisplayMode DisplayMode
The structure that defines a display mode.
Definition: SDL3pp_video.h:159
void EGL_SetAttributeCallbacks(EGLAttribArrayCallback platformAttribCallback, EGLIntArrayCallback surfaceAttribCallback, EGLIntArrayCallback contextAttribCallback, void *userdata)
Sets the callbacks for defining custom EGLAttrib arrays for EGL initialization.
Definition: SDL3pp_video.h:7125
GLContext CreateGLContext()
Create an OpenGL context for an OpenGL window, and make it current.
Definition: SDL3pp_video.h:6995
const DisplayMode & GetCurrentDisplayMode(DisplayID displayID)
Get information about the current display mode.
Definition: SDL3pp_video.h:4015
void Flash(FlashOperation operation)
Request a window to demand attention from the user.
Definition: SDL3pp_video.h:6686
SDL_HitTestResult HitTestResult
Possible return values from the HitTest callback.
Definition: SDL3pp_video.h:649
Rect GetDisplayBounds(Display displayID)
Get the desktop area represented by a display.
Definition: SDL3pp_video.h:3755
void SetWindowAspectRatio(WindowParam window, float min_aspect, float max_aspect)
Request that the aspect ratio of a window's client area be set.
Definition: SDL3pp_video.h:5391
constexpr WindowFlags WINDOW_METAL
window usable for Metal view
Definition: SDL3pp_video.h:614
constexpr WindowFlags WINDOW_MINIMIZED
window is minimized
Definition: SDL3pp_video.h:561
constexpr GLAttr GL_ACCUM_ALPHA_SIZE
the minimum number of bits for the alpha channel of the accumulation buffer; defaults to 0.
Definition: SDL3pp_video.h:3433
constexpr int WINDOW_SURFACE_VSYNC_DISABLED
Constant to disable vsync.
Definition: SDL3pp_video.h:6057
bool GetMouseGrab() const
Get a window's mouse grab mode.
Definition: SDL3pp_video.h:6276
constexpr DisplayOrientation ORIENTATION_PORTRAIT
The display is in portrait mode.
Definition: SDL3pp_video.h:141
float GetWindowPixelDensity(WindowParam window)
Get the pixel density of a window.
Definition: SDL3pp_video.h:4116
constexpr GLAttr GL_ACCUM_RED_SIZE
the minimum number of bits for the red channel of the accumulation buffer; defaults to 0.
Definition: SDL3pp_video.h:3415
OwnArray< DisplayMode * > GetFullscreenDisplayModes(Display displayID)
Get a list of fullscreen display modes available on a display.
Definition: SDL3pp_video.h:3904
const DisplayMode & GetWindowFullscreenMode(WindowParam window)
Query the display mode to use when a window is visible at fullscreen.
Definition: SDL3pp_video.h:4213
void SetWindowFullscreen(WindowParam window, bool fullscreen)
Request that the window's fullscreen state be changed.
Definition: SDL3pp_video.h:5918
void SetKeyboardGrab(bool grabbed)
Set a window's keyboard grab mode.
Definition: SDL3pp_video.h:6201
SDL_SystemTheme SystemTheme
System theme.
Definition: SDL3pp_video.h:504
void RestoreWindow(WindowParam window)
Request that the size and position of a minimized or maximized window be restored.
Definition: SDL3pp_video.h:5882
constexpr WindowFlags WINDOW_HIGH_PIXEL_DENSITY
window uses high pixel density back buffer if possible
Definition: SDL3pp_video.h:582
constexpr GLAttr GL_CONTEXT_FLAGS
some combination of 0 or more of elements of the GLContextFlag enumeration; defaults to 0.
Definition: SDL3pp_video.h:3466
void SetAlwaysOnTop(bool on_top)
Set the window to always be above the others.
Definition: SDL3pp_video.h:5716
void SetWindowShape(WindowParam window, SurfaceParam shape)
Set the shape of a transparent window.
Definition: SDL3pp_video.h:6660
constexpr GLProfile GL_CONTEXT_PROFILE_ES
GLX_CONTEXT_ES2_PROFILE_BIT_EXT.
Definition: SDL3pp_video.h:3515
constexpr GLAttr GL_DOUBLEBUFFER
whether the output is single or double buffered; defaults to double buffering on.
Definition: SDL3pp_video.h:3403
float GetWindowDisplayScale(WindowParam window)
Get the content display scale relative to a window's pixel size.
Definition: SDL3pp_video.h:4147
Display GetPrimaryDisplay()
Return the primary display.
Definition: SDL3pp_video.h:3663
SDL_DisplayModeData DisplayModeData
Internal display mode data.
Definition: SDL3pp_video.h:524
constexpr HitTestResult HITTEST_RESIZE_LEFT
Region is the resizable left border.
Definition: SDL3pp_video.h:682
Point GetPosition() const
Get the position of a window.
Definition: SDL3pp_video.h:5178
void SetWindowBordered(WindowParam window, bool bordered)
Set the border state of a window.
Definition: SDL3pp_video.h:5656
float GetWindowOpacity(WindowParam window)
Get the opacity of a window.
Definition: SDL3pp_video.h:6395
PixelFormat GetWindowPixelFormat(WindowParam window)
Get the pixel format associated with the window.
Definition: SDL3pp_video.h:4256
void GL_GetAttribute(GLAttr attr, int *value)
Get the actual value for an attribute from the current context.
Definition: SDL3pp_video.h:6963
void Show()
Show a window.
Definition: SDL3pp_video.h:5739
void MakeCurrent(GLContext context)
Set up an OpenGL context for rendering into an OpenGL window.
Definition: SDL3pp_video.h:7017
PropertiesRef GetDisplayProperties(DisplayID displayID)
Get the properties associated with a display.
Definition: SDL3pp_video.h:3696
void SetWindowHitTest(WindowParam window, HitTest callback, void *callback_data)
Provide a callback that decides if a window region has special properties.
Definition: SDL3pp_video.h:6565
void Minimize()
Request that the window be minimized to an iconic representation.
Definition: SDL3pp_video.h:5853
void MaximizeWindow(WindowParam window)
Request that the window be made as large as possible.
Definition: SDL3pp_video.h:5815
void GL_SetAttribute(GLAttr attr, int value)
Set an OpenGL window attribute before window creation.
Definition: SDL3pp_video.h:6944
void SetSize(const PointRaw &size)
Request that the size of a window's client area be set.
Definition: SDL3pp_video.h:5221
const char * GetCurrentVideoDriver()
Get the name of the currently initialized video driver.
Definition: SDL3pp_video.h:3617
Point GetSizeInPixels() const
Get the size of a window's client area, in pixels.
Definition: SDL3pp_video.h:5530
constexpr GLAttr GL_MULTISAMPLEBUFFERS
the number of buffers used for multisample anti-aliasing; defaults to 0.
Definition: SDL3pp_video.h:3439
PropertiesRef GetProperties() const
Get the properties associated with a window.
Definition: SDL3pp_video.h:4964
void ShowSystemMenu(const PointRaw &p)
Display the system-level window menu.
Definition: SDL3pp_video.h:6519
const DisplayMode & GetCurrentMode() const
Get information about the current display mode.
Definition: SDL3pp_video.h:4020
constexpr GLAttr GL_ALPHA_SIZE
the minimum number of bits for the alpha channel of the color buffer; defaults to 8.
Definition: SDL3pp_video.h:3394
constexpr WindowFlags WINDOW_MODAL
window is modal
Definition: SDL3pp_video.h:579
int GetNumVideoDrivers()
Get the number of video drivers compiled into SDL.
Definition: SDL3pp_video.h:3574
std::function< HitTestResult(WindowRaw window, const Point &area)> HitTestCB
Callback used for hit-testing.
Definition: SDL3pp_video.h:710
void SetWindowMouseRect(WindowParam window, const RectRaw &rect)
Confines the cursor to the specified area of a window.
Definition: SDL3pp_video.h:6316
bool GL_ExtensionSupported(StringParam extension)
Check if an OpenGL extension is supported for the current context.
Definition: SDL3pp_video.h:6908
constexpr WindowFlags WINDOW_INPUT_FOCUS
window has input focus
Definition: SDL3pp_video.h:570
void SetWindowRect(WindowParam window, Rect rect)
Request the window's position and size to be set.
Definition: SDL3pp_video.h:5296
int GetSurfaceVSync() const
Get VSync for the window surface.
Definition: SDL3pp_video.h:6081
void SetOpacity(float opacity)
Set the opacity for a window.
Definition: SDL3pp_video.h:6374
constexpr GLAttr GL_ACCUM_GREEN_SIZE
the minimum number of bits for the green channel of the accumulation buffer; defaults to 0.
Definition: SDL3pp_video.h:3421
constexpr GLContextFlag GL_CONTEXT_DEBUG_FLAG
DEBUG_FLAG.
Definition: SDL3pp_video.h:3525
Uint32 GLContextFlag
Possible flags to be set for the GL_CONTEXT_FLAGS attribute.
Definition: SDL3pp_video.h:3523
SDL_WindowID WindowID
This is a unique ID for a window.
Definition: SDL3pp_video.h:478
const char * GetName() const
Get the name of a display in UTF-8 encoding.
Definition: SDL3pp_video.h:3733
void SetWindowResizable(WindowParam window, bool resizable)
Set the user-resizable state of a window.
Definition: SDL3pp_video.h:5685
void SetBordered(bool bordered)
Set the border state of a window.
Definition: SDL3pp_video.h:5661
DisplayOrientation GetNaturalOrientation() const
Get the orientation of a display when it is unrotated.
Definition: SDL3pp_video.h:3819
void ShowWindow(WindowParam window)
Show a window.
Definition: SDL3pp_video.h:5734
void SetTitle(StringParam title)
Set the title of a window.
Definition: SDL3pp_video.h:5017
void SetWindowParent(WindowParam window, WindowParam parent)
Set the window as a child of a parent window.
Definition: SDL3pp_video.h:6436
constexpr HitTestResult HITTEST_RESIZE_TOP
Region is the resizable top border.
Definition: SDL3pp_video.h:661
void ShowWindowSystemMenu(WindowParam window, const PointRaw &p)
Display the system-level window menu.
Definition: SDL3pp_video.h:6514
const char * GetVideoDriver(int index)
Get the name of a built in video driver.
Definition: SDL3pp_video.h:3595
void GetWindowMaximumSize(WindowParam window, int *w, int *h)
Get the maximum size of a window's client area.
Definition: SDL3pp_video.h:5627
EGLSurface EGL_GetWindowSurface(WindowParam window)
Get the EGL surface associated with the window.
Definition: SDL3pp_video.h:7095
constexpr int WINDOWPOS_CENTERED_DISPLAY(int X)
Used to indicate that the window position should be centered.
Definition: SDL3pp_video.h:3044
void Maximize()
Request that the window be made as large as possible.
Definition: SDL3pp_video.h:5820
SDL_EGLSurface EGLSurface
Opaque type for an EGL surface.
Definition: SDL3pp_video.h:717
const char * GetDisplayName(DisplayID displayID)
Get the name of a display in UTF-8 encoding.
Definition: SDL3pp_video.h:3728
SDL_FlashOperation FlashOperation
Window flash operation.
Definition: SDL3pp_video.h:628
constexpr WindowFlags WINDOW_VULKAN
window usable for Vulkan surface
Definition: SDL3pp_video.h:611
Rect GetRect() const
Get the position and client size of a window.
Definition: SDL3pp_video.h:5323
bool WindowHasSurface(WindowParam window)
Return whether the window has a surface associated with it.
Definition: SDL3pp_video.h:5976
constexpr HitTestResult HITTEST_RESIZE_TOPLEFT
Region is the resizable top-left corner border.
Definition: SDL3pp_video.h:657
constexpr HitTestResult HITTEST_RESIZE_BOTTOMRIGHT
Region is the resizable bottom-right corner border.
Definition: SDL3pp_video.h:672
SDL_EGLConfig EGLConfig
Opaque type for an EGL config.
Definition: SDL3pp_video.h:3223
constexpr SystemTheme SYSTEM_THEME_UNKNOWN
Unknown system theme.
Definition: SDL3pp_video.h:506
constexpr WindowFlags WINDOW_KEYBOARD_GRABBED
window has grabbed keyboard input
Definition: SDL3pp_video.h:608
constexpr GLAttr GL_BLUE_SIZE
the minimum number of bits for the blue channel of the color buffer; defaults to 8.
Definition: SDL3pp_video.h:3388
constexpr GLAttr GL_EGL_PLATFORM
GL_EGL_PLATFORM.
Definition: SDL3pp_video.h:3499
constexpr WindowFlags WINDOW_BORDERLESS
no window decoration
Definition: SDL3pp_video.h:555
const DisplayMode & GetDesktopMode() const
Get information about the desktop's display mode.
Definition: SDL3pp_video.h:3991
void SetWindowFocusable(WindowParam window, bool focusable)
Set whether the window may have input focus.
Definition: SDL3pp_video.h:6484
SDL_EGLDisplay EGLDisplay
Opaque type for an EGL display.
Definition: SDL3pp_video.h:3216
void GetWindowSizeInPixels(WindowParam window, int *w, int *h)
Get the size of a window's client area, in pixels.
Definition: SDL3pp_video.h:5498
constexpr WindowFlags WINDOW_TOOLTIP
window should be treated as a tooltip and does not get mouse or keyboard focus, requires a parent win...
Definition: SDL3pp_video.h:603
constexpr WindowFlags WINDOW_MOUSE_CAPTURE
window has mouse captured (unrelated to MOUSE_GRABBED)
Definition: SDL3pp_video.h:585
Window CreatePopupWindow(WindowParam parent, const PointRaw &offset, const PointRaw &size, WindowFlags flags)
Create a child popup window of the specified parent window.
Definition: SDL3pp_video.h:4446
void GetWindowBordersSize(WindowParam window, int *top, int *left, int *bottom, int *right)
Get the size of a window's borders (decorations) around the client area.
Definition: SDL3pp_video.h:5464
WindowRef GetGrabbedWindow()
Get the window that currently has an input grab enabled.
Definition: SDL3pp_video.h:6293
void UpdateWindowSurface(WindowParam window)
Copy the window surface to the screen.
Definition: SDL3pp_video.h:6104
constexpr GLAttr GL_BUFFER_SIZE
the minimum number of bits for frame buffer size; defaults to 0.
Definition: SDL3pp_video.h:3397
constexpr DisplayOrientation ORIENTATION_LANDSCAPE
The display is in landscape mode, with the right side up, relative to portrait mode.
Definition: SDL3pp_video.h:132
constexpr DisplayOrientation ORIENTATION_PORTRAIT_FLIPPED
The display is in portrait mode, upside down.
Definition: SDL3pp_video.h:144
constexpr WindowFlags WINDOW_OPENGL
window usable with OpenGL context
Definition: SDL3pp_video.h:543
bool GetKeyboardGrab() const
Get a window's keyboard grab mode.
Definition: SDL3pp_video.h:6251
constexpr GLAttr GL_CONTEXT_NO_ERROR
GL_CONTEXT_NO_ERROR.
Definition: SDL3pp_video.h:3494
const char * GetWindowTitle(WindowParam window)
Get the title of a window.
Definition: SDL3pp_video.h:5034
void SetWindowAlwaysOnTop(WindowParam window, bool on_top)
Set the window to always be above the others.
Definition: SDL3pp_video.h:5711
void GetWindowSize(WindowParam window, int *w, int *h)
Get the size of a window's client area.
Definition: SDL3pp_video.h:5246
SDL_EGLint EGLint
An EGL integer attribute, used when creating an EGL surface.
Definition: SDL3pp_video.h:3237
WindowFlags GetWindowFlags(WindowParam window)
Get the window flags.
Definition: SDL3pp_video.h:4987
constexpr GLContextFlag GL_CONTEXT_ROBUST_ACCESS_FLAG
ROBUST_ACCESS_FLAG.
Definition: SDL3pp_video.h:3531
constexpr DisplayOrientation ORIENTATION_LANDSCAPE_FLIPPED
The display is in landscape mode, with the left side up, relative to portrait mode.
Definition: SDL3pp_video.h:138
Surface GetWindowSurface(WindowParam window)
Get the SDL surface associated with the window.
Definition: SDL3pp_video.h:6013
constexpr int WINDOWPOS_UNDEFINED
Used to indicate that you don't care what the window position/display is.
Definition: SDL3pp_video.h:3010
const char * GetTitle() const
Get the title of a window.
Definition: SDL3pp_video.h:5039
constexpr WindowFlags WINDOW_MOUSE_RELATIVE_MODE
window has relative mode enabled
Definition: SDL3pp_video.h:587
constexpr WindowFlags WINDOW_OCCLUDED
window is occluded
Definition: SDL3pp_video.h:546
constexpr FlashOperation FLASH_UNTIL_FOCUSED
Flash the window until it gets focus.
Definition: SDL3pp_video.h:636
static Display GetForPoint(const PointRaw &point)
Get the display containing a point.
Definition: SDL3pp_video.h:4044
void SetWindowOpacity(WindowParam window, float opacity)
Set the opacity for a window.
Definition: SDL3pp_video.h:6369
SDL_GLContext GLContextRaw
Alias to raw representation for GLContext.
Definition: SDL3pp_video.h:83
Uint32 GLProfile
Possible values to be set for the GL_CONTEXT_PROFILE_MASK attribute.
Definition: SDL3pp_video.h:3506
void SetMouseRect(const RectRaw &rect)
Confines the cursor to the specified area of a window.
Definition: SDL3pp_video.h:6321
void SetWindowModal(WindowParam window, bool modal)
Toggle the state of the window as modal.
Definition: SDL3pp_video.h:6463
void Destroy()
Destroy a window.
Definition: SDL3pp_video.h:6717
SystemTheme GetSystemTheme()
Get the current system theme.
Definition: SDL3pp_video.h:3631
static Display GetForRect(const RectRaw &rect)
Get the display primarily containing a rect.
Definition: SDL3pp_video.h:4069
DisplayOrientation GetCurrentOrientation() const
Get the orientation of a display.
Definition: SDL3pp_video.h:3842
OwnPtr< void > GetICCProfile() const
Get the raw ICC profile data for the screen the window is currently on.
Definition: SDL3pp_video.h:4240
static WindowRef FromID(WindowID id)
Get a window from a stored ID.
Definition: SDL3pp_video.h:4814
PropertiesRef GetWindowProperties(WindowParam window)
Get the properties associated with a window.
Definition: SDL3pp_video.h:4959
void GetAspectRatio(float *min_aspect, float *max_aspect) const
Get the size of a window's client area.
Definition: SDL3pp_video.h:5426
void GetWindowMinimumSize(WindowParam window, int *w, int *h)
Get the minimum size of a window's client area.
Definition: SDL3pp_video.h:5576
constexpr WindowFlags WINDOW_NOT_FOCUSABLE
window should not be focusable
Definition: SDL3pp_video.h:620
void SetWindowKeyboardGrab(WindowParam window, bool grabbed)
Set a window's keyboard grab mode.
Definition: SDL3pp_video.h:6196
constexpr GLContextResetNotification GL_CONTEXT_RESET_NO_NOTIFICATION
NO_NOTIFICATION.
Definition: SDL3pp_video.h:3557
constexpr GLAttr GL_FLOATBUFFERS
GL_FLOATBUFFERS.
Definition: SDL3pp_video.h:3497
void GL_MakeCurrent(WindowParam window, GLContext context)
Set up an OpenGL context for rendering into an OpenGL window.
Definition: SDL3pp_video.h:7012
void Raise()
Request that a window be raised above other windows and gain the input focus.
Definition: SDL3pp_video.h:5782
void SetMaximumSize(const PointRaw &p)
Set the maximum size of a window's client area.
Definition: SDL3pp_video.h:5605
GLContext GL_GetCurrentContext()
Get the currently active OpenGL context.
Definition: SDL3pp_video.h:7055
constexpr WindowFlags WINDOW_RESIZABLE
window can be resized
Definition: SDL3pp_video.h:558
OwnArray< WindowRef > GetWindows()
Get a list of valid windows.
Definition: SDL3pp_video.h:4276
PixelFormat GetPixelFormat() const
Get the pixel format associated with the window.
Definition: SDL3pp_video.h:4261
constexpr WindowFlags WINDOW_POPUP_MENU
window should be treated as a popup menu, requires a parent window
Definition: SDL3pp_video.h:606
void Hide()
Hide a window.
Definition: SDL3pp_video.h:5759
void SetParent(WindowParam parent)
Set the window as a child of a parent window.
Definition: SDL3pp_video.h:6441
constexpr GLContextResetNotification GL_CONTEXT_RESET_LOSE_CONTEXT
LOSE_CONTEXT.
Definition: SDL3pp_video.h:3560
Display GetDisplayForWindow(WindowParam window)
Get the display associated with a window.
Definition: SDL3pp_video.h:4089
void SetModal(bool modal)
Toggle the state of the window as modal.
Definition: SDL3pp_video.h:6468
void GL_ResetAttributes()
Reset all previously set OpenGL context attributes to their default values.
Definition: SDL3pp_video.h:6923
Uint32 GLContextResetNotification
Possible values to be set GL_CONTEXT_RESET_NOTIFICATION attribute.
Definition: SDL3pp_video.h:3555
void Destroy()
Delete an OpenGL context.
Definition: SDL3pp_video.h:7234
constexpr WindowFlags WINDOW_EXTERNAL
window not created by SDL
Definition: SDL3pp_video.h:576
Rect GetSafeArea() const
Get the safe area for this window.
Definition: SDL3pp_video.h:5349
void SetWindowMaximumSize(WindowParam window, const PointRaw &p)
Set the maximum size of a window's client area.
Definition: SDL3pp_video.h:5600
WindowFlags GetFlags() const
Get the window flags.
Definition: SDL3pp_video.h:4992
void SyncWindow(WindowParam window)
Block until any pending window state is finalized.
Definition: SDL3pp_video.h:5956
OwnArray< DisplayID > GetDisplays()
Get a list of currently connected displays.
Definition: SDL3pp_video.h:3643
const RectRaw * GetMouseRect() const
Get the mouse confinement rectangle of a window.
Definition: SDL3pp_video.h:6346
constexpr WindowFlags WINDOW_ALWAYS_ON_TOP
window should always be above others
Definition: SDL3pp_video.h:590
std::function< SDL_EGLAttrib *()> EGLAttribArrayCB
EGL platform attribute initialization callback.
Definition: SDL3pp_video.h:3288
const DisplayMode & GetFullscreenMode() const
Query the display mode to use when a window is visible at fullscreen.
Definition: SDL3pp_video.h:4218
constexpr WindowFlags WINDOW_HIDDEN
window is neither mapped onto the desktop nor shown in the taskbar/dock/window list; Window....
Definition: SDL3pp_video.h:553
constexpr GLAttr GL_SHARE_WITH_CURRENT_CONTEXT
OpenGL context sharing; defaults to 0.
Definition: SDL3pp_video.h:3474
void SetWindowTitle(WindowParam window, StringParam title)
Set the title of a window.
Definition: SDL3pp_video.h:5012
void Sync()
Block until any pending window state is finalized.
Definition: SDL3pp_video.h:5961
WindowID GetWindowID(WindowParam window)
Get the numeric ID of a window.
Definition: SDL3pp_video.h:4786
EGLConfig EGL_GetCurrentConfig()
Get the currently active EGL config.
Definition: SDL3pp_video.h:7082
void HideWindow(WindowParam window)
Hide a window.
Definition: SDL3pp_video.h:5754
static Display GetPrimary()
Return the primary display.
Definition: SDL3pp_video.h:3668
constexpr HitTestResult HITTEST_RESIZE_BOTTOM
Region is the resizable bottom border.
Definition: SDL3pp_video.h:675
OwnPtr< void > GetWindowICCProfile(WindowParam window)
Get the raw ICC profile data for the screen the window is currently on.
Definition: SDL3pp_video.h:4234
void RaiseWindow(WindowParam window)
Request that a window be raised above other windows and gain the input focus.
Definition: SDL3pp_video.h:5777
bool HasSurface() const
Return whether the window has a surface associated with it.
Definition: SDL3pp_video.h:5981
Rect GetUsableBounds() const
Get the usable desktop area represented by a display, in screen coordinates.
Definition: SDL3pp_video.h:3796
void SetResizable(bool resizable)
Set the user-resizable state of a window.
Definition: SDL3pp_video.h:5690
void DestroyWindow(WindowRaw window)
Destroy a window.
Definition: SDL3pp_video.h:6710
constexpr GLAttr GL_ACCUM_BLUE_SIZE
the minimum number of bits for the blue channel of the accumulation buffer; defaults to 0.
Definition: SDL3pp_video.h:3427
const RectRaw * GetWindowMouseRect(WindowParam window)
Get the mouse confinement rectangle of a window.
Definition: SDL3pp_video.h:6341
WindowRef GetWindowFromID(WindowID id)
Get a window from a stored ID.
Definition: SDL3pp_video.h:4809
void GetBordersSize(int *top, int *left, int *bottom, int *right) const
Get the size of a window's borders (decorations) around the client area.
Definition: SDL3pp_video.h:5473
constexpr WindowFlags WINDOW_FULLSCREEN
window is in fullscreen mode
Definition: SDL3pp_video.h:540
void UpdateSurfaceRects(SpanRef< const RectRaw > rects)
Copy areas of the window surface to the screen.
Definition: SDL3pp_video.h:6142
constexpr GLContextReleaseFlag GL_CONTEXT_RELEASE_BEHAVIOR_NONE
BEHAVIOR_NONE.
Definition: SDL3pp_video.h:3544
void SetShape(SurfaceParam shape)
Set the shape of a transparent window.
Definition: SDL3pp_video.h:6665
WindowRef GetParent() const
Get parent of a window.
Definition: SDL3pp_video.h:4837
SDL_EGLAttrib EGLAttrib
An EGL attribute, used when creating an EGL context.
Definition: SDL3pp_video.h:3230
void GL_LoadLibrary(StringParam path)
Dynamically load an OpenGL library.
Definition: SDL3pp_video.h:6792
void SetFullscreen(bool fullscreen)
Request that the window's fullscreen state be changed.
Definition: SDL3pp_video.h:5923
void MakeCurrent(WindowParam window)
Set up an OpenGL context for rendering into an OpenGL window.
Definition: SDL3pp_video.h:7022
void SetFullscreenMode(OptionalRef< const DisplayMode > mode)
Set the display mode to use when a window is visible and fullscreen.
Definition: SDL3pp_video.h:4194
constexpr GLAttr GL_DEPTH_SIZE
the minimum number of bits in the depth buffer; defaults to 16.
Definition: SDL3pp_video.h:3406
void SetIcon(SurfaceParam icon)
Set the icon for a window.
Definition: SDL3pp_video.h:5070
std::function< SDL_EGLint *(SDL_EGLDisplay, SDL_EGLConfig)> EGLIntArrayCB
EGL surface/context attribute initialization callback types.
Definition: SDL3pp_video.h:3351
constexpr int WINDOWPOS_CENTERED_MASK
A magic value used with WINDOWPOS_CENTERED.
Definition: SDL3pp_video.h:3032
EGLDisplay EGL_GetCurrentDisplay()
Get the currently active EGL display.
Definition: SDL3pp_video.h:7067
void SetMouseGrab(bool grabbed)
Set a window's mouse grab mode.
Definition: SDL3pp_video.h:6229
void MinimizeWindow(WindowParam window)
Request that the window be minimized to an iconic representation.
Definition: SDL3pp_video.h:5848
constexpr GLContextReleaseFlag GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH
BEHAVIOR_FLUSH.
Definition: SDL3pp_video.h:3547
void SetSurfaceVSync(int vsync)
Toggle VSync for the window surface.
Definition: SDL3pp_video.h:6051
constexpr GLAttr GL_ACCELERATED_VISUAL
set to 1 to require hardware acceleration, set to 0 to force software rendering; defaults to allow ei...
Definition: SDL3pp_video.h:3451
void SetWindowMouseGrab(WindowParam window, bool grabbed)
Set a window's mouse grab mode.
Definition: SDL3pp_video.h:6224
constexpr bool WINDOWPOS_ISCENTERED(int X)
A macro to test if the window position is marked as "centered.".
Definition: SDL3pp_video.h:3065
SDL_EGLIntArrayCallback EGLIntArrayCallback
EGL surface/context attribute initialization callback types.
Definition: SDL3pp_video.h:3319
Main include header for the SDL3pp library.
Safely wrap GLContext for non owning parameters.
Definition: SDL3pp_video.h:90
GLContextRaw value
parameter's GLContextRaw
Definition: SDL3pp_video.h:91
constexpr GLContextParam(GLContextRaw value)
Constructs from GLContextRaw.
Definition: SDL3pp_video.h:94
constexpr auto operator<=>(const GLContextParam &other) const =default
Comparison.
constexpr GLContextParam(std::nullptr_t _=nullptr)
Constructs null/invalid.
Definition: SDL3pp_video.h:100
RAII owning version GLContext.
Definition: SDL3pp_video.h:3196
constexpr GLContextScoped(GLContext &&other)
Move constructor.
Definition: SDL3pp_video.h:3202
~GLContextScoped()
Destructor.
Definition: SDL3pp_video.h:3208
Store callbacks by key.
Definition: SDL3pp_callbackWrapper.h:222
The structure that defines a point (using integers).
Definition: SDL3pp_rect.h:83
Safely wrap Properties for non owning parameters.
Definition: SDL3pp_properties.h:52
Semi-safe reference for Properties.
Definition: SDL3pp_properties.h:701
A rectangle, with the origin at the upper left (using integers).
Definition: SDL3pp_rect.h:839
constexpr Point GetTopLeft() const
Get top left corner of the rect.
Definition: SDL3pp_rect.h:1088
constexpr Point GetSize() const
Get size of the rect.
Definition: SDL3pp_rect.h:1120
Semi-safe reference for Renderer.
Definition: SDL3pp_render.h:2100
Safely wrap Surface for non owning parameters.
Definition: SDL3pp_surface.h:46
Safely wrap Window for non owning parameters.
Definition: SDL3pp_video.h:54
constexpr WindowParam(WindowRaw value)
Constructs from WindowRaw.
Definition: SDL3pp_video.h:58
constexpr auto operator<=>(const WindowParam &other) const =default
Comparison.
WindowRaw value
parameter's WindowRaw
Definition: SDL3pp_video.h:55
constexpr WindowParam(std::nullptr_t _=nullptr)
Constructs null/invalid.
Definition: SDL3pp_video.h:64
Semi-safe reference for Window.
Definition: SDL3pp_video.h:2955
~WindowRef()
Destructor.
Definition: SDL3pp_video.h:2975
WindowRef(WindowParam resource)
Constructs from WindowParam.
Definition: SDL3pp_video.h:2963
WindowRef(const WindowRef &other)
Copy constructor.
Definition: SDL3pp_video.h:2969