SDL3pp
A slim C++ wrapper for SDL3
Loading...
Searching...
No Matches
SDL3pp_hints.h
1#ifndef SDL3PP_HINTS_H_
2#define SDL3PP_HINTS_H_
3
4#include <SDL3/SDL_hints.h>
5#include "SDL3pp_callbackWrapper.h"
6#include "SDL3pp_error.h"
7#include "SDL3pp_strings.h"
8
9namespace SDL {
10
27
28#ifdef SDL3PP_DOC
29
47#define SDL_HINT_ALLOW_ALT_TAB_WHILE_GRABBED "SDL_ALLOW_ALT_TAB_WHILE_GRABBED"
48
67#define SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY \
68 "SDL_ANDROID_ALLOW_RECREATE_ACTIVITY"
69
83#define SDL_HINT_ANDROID_BLOCK_ON_PAUSE "SDL_ANDROID_BLOCK_ON_PAUSE"
84
100#define SDL_HINT_ANDROID_LOW_LATENCY_AUDIO "SDL_ANDROID_LOW_LATENCY_AUDIO"
101
122#define SDL_HINT_ANDROID_TRAP_BACK_BUTTON "SDL_ANDROID_TRAP_BACK_BUTTON"
123
138#define SDL_HINT_APP_ID "SDL_APP_ID"
139
155#define SDL_HINT_APP_NAME "SDL_APP_NAME"
156
178#define SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS \
179 "SDL_APPLE_TV_CONTROLLER_UI_EVENTS"
180
194#define SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION \
195 "SDL_APPLE_TV_REMOTE_ALLOW_ROTATION"
196
215#define SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE "SDL_AUDIO_ALSA_DEFAULT_DEVICE"
216
233#define SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE \
234 "SDL_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE"
235
252#define SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE \
253 "SDL_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE"
254
271#define SDL_HINT_AUDIO_CATEGORY "SDL_AUDIO_CATEGORY"
272
284#define SDL_HINT_AUDIO_CHANNELS "SDL_AUDIO_CHANNELS"
285
307#define SDL_HINT_AUDIO_DEVICE_APP_ICON_NAME "SDL_AUDIO_DEVICE_APP_ICON_NAME"
308
329#define SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES "SDL_AUDIO_DEVICE_SAMPLE_FRAMES"
330
356#define SDL_HINT_AUDIO_DEVICE_STREAM_NAME "SDL_AUDIO_DEVICE_STREAM_NAME"
357
400#define SDL_HINT_AUDIO_DEVICE_STREAM_ROLE "SDL_AUDIO_DEVICE_STREAM_ROLE"
401
402#if SDL_VERSION_ATLEAST(3, 4, 0)
403
422#define SDL_HINT_AUDIO_DEVICE_RAW_STREAM "SDL_AUDIO_DEVICE_RAW_STREAM"
423
424#endif // SDL_VERSION_ATLEAST(3, 4, 0)
425
435#define SDL_HINT_AUDIO_DISK_INPUT_FILE "SDL_AUDIO_DISK_INPUT_FILE"
436
446#define SDL_HINT_AUDIO_DISK_OUTPUT_FILE "SDL_AUDIO_DISK_OUTPUT_FILE"
447
459#define SDL_HINT_AUDIO_DISK_TIMESCALE "SDL_AUDIO_DISK_TIMESCALE"
460
473#define SDL_HINT_AUDIO_DRIVER "SDL_AUDIO_DRIVER"
474
486#define SDL_HINT_AUDIO_DUMMY_TIMESCALE "SDL_AUDIO_DUMMY_TIMESCALE"
487
512#define SDL_HINT_AUDIO_FORMAT "SDL_AUDIO_FORMAT"
513
525#define SDL_HINT_AUDIO_FREQUENCY "SDL_AUDIO_FREQUENCY"
526
547#define SDL_HINT_AUDIO_INCLUDE_MONITORS "SDL_AUDIO_INCLUDE_MONITORS"
548
562#define SDL_HINT_AUTO_UPDATE_JOYSTICKS "SDL_AUTO_UPDATE_JOYSTICKS"
563
577#define SDL_HINT_AUTO_UPDATE_SENSORS "SDL_AUTO_UPDATE_SENSORS"
578
599#define SDL_HINT_BMP_SAVE_LEGACY_FORMAT "SDL_BMP_SAVE_LEGACY_FORMAT"
600
615#define SDL_HINT_CAMERA_DRIVER "SDL_CAMERA_DRIVER"
616
647#define SDL_HINT_CPU_FEATURE_MASK "SDL_CPU_FEATURE_MASK"
648
661#define SDL_HINT_JOYSTICK_DIRECTINPUT "SDL_JOYSTICK_DIRECTINPUT"
662
690#define SDL_HINT_FILE_DIALOG_DRIVER "SDL_FILE_DIALOG_DRIVER"
691
707#define SDL_HINT_DISPLAY_USABLE_BOUNDS "SDL_DISPLAY_USABLE_BOUNDS"
708
709#if SDL_VERSION_ATLEAST(3, 4, 0)
710
724#define SDL_HINT_INVALID_PARAM_CHECKS "SDL_INVALID_PARAM_CHECKS"
725
726#endif // SDL_VERSION_ATLEAST(3, 4, 0)
727
747#define SDL_HINT_EMSCRIPTEN_ASYNCIFY "SDL_EMSCRIPTEN_ASYNCIFY"
748
758#define SDL_HINT_EMSCRIPTEN_CANVAS_SELECTOR "SDL_EMSCRIPTEN_CANVAS_SELECTOR"
759
779#define SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT "SDL_EMSCRIPTEN_KEYBOARD_ELEMENT"
780
796#define SDL_HINT_ENABLE_SCREEN_KEYBOARD "SDL_ENABLE_SCREEN_KEYBOARD"
797
813#define SDL_HINT_EVDEV_DEVICES "SDL_EVDEV_DEVICES"
814
835#define SDL_HINT_EVENT_LOGGING "SDL_EVENT_LOGGING"
836
854#define SDL_HINT_FORCE_RAISEWINDOW "SDL_FORCE_RAISEWINDOW"
855
875#define SDL_HINT_FRAMEBUFFER_ACCELERATION "SDL_FRAMEBUFFER_ACCELERATION"
876
890#define SDL_HINT_GAMECONTROLLERCONFIG "SDL_GAMECONTROLLERCONFIG"
891
905#define SDL_HINT_GAMECONTROLLERCONFIG_FILE "SDL_GAMECONTROLLERCONFIG_FILE"
906
929#define SDL_HINT_GAMECONTROLLERTYPE "SDL_GAMECONTROLLERTYPE"
930
947#define SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES \
948 "SDL_GAMECONTROLLER_IGNORE_DEVICES"
949
966#define SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT \
967 "SDL_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT"
968
990#define SDL_HINT_GAMECONTROLLER_SENSOR_FUSION "SDL_GAMECONTROLLER_SENSOR_FUSION"
991
1001#define SDL_HINT_GDK_TEXTINPUT_DEFAULT_TEXT "SDL_GDK_TEXTINPUT_DEFAULT_TEXT"
1002
1012#define SDL_HINT_GDK_TEXTINPUT_DESCRIPTION "SDL_GDK_TEXTINPUT_DESCRIPTION"
1013
1027#define SDL_HINT_GDK_TEXTINPUT_MAX_LENGTH "SDL_GDK_TEXTINPUT_MAX_LENGTH"
1028
1042#define SDL_HINT_GDK_TEXTINPUT_SCOPE "SDL_GDK_TEXTINPUT_SCOPE"
1043
1053#define SDL_HINT_GDK_TEXTINPUT_TITLE "SDL_GDK_TEXTINPUT_TITLE"
1054
1070#define SDL_HINT_HIDAPI_LIBUSB "SDL_HIDAPI_LIBUSB"
1071
1072#if SDL_VERSION_ATLEAST(3, 4, 0)
1073
1086#define SDL_HINT_HIDAPI_LIBUSB_GAMECUBE "SDL_HIDAPI_LIBUSB_GAMECUBE"
1087
1088#endif // SDL_VERSION_ATLEAST(3, 4, 0)
1089
1106#define SDL_HINT_HIDAPI_LIBUSB_WHITELIST "SDL_HIDAPI_LIBUSB_WHITELIST"
1107
1120#define SDL_HINT_HIDAPI_UDEV "SDL_HIDAPI_UDEV"
1121
1134#define SDL_HINT_GPU_DRIVER "SDL_GPU_DRIVER"
1135
1153#define SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS \
1154 "SDL_HIDAPI_ENUMERATE_ONLY_CONTROLLERS"
1155
1171#define SDL_HINT_HIDAPI_IGNORE_DEVICES "SDL_HIDAPI_IGNORE_DEVICES"
1172
1194#define SDL_HINT_IME_IMPLEMENTED_UI "SDL_IME_IMPLEMENTED_UI"
1195
1213#define SDL_HINT_IOS_HIDE_HOME_INDICATOR "SDL_IOS_HIDE_HOME_INDICATOR"
1214
1230#define SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS \
1231 "SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS"
1232
1248#define SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES "SDL_JOYSTICK_ARCADESTICK_DEVICES"
1249
1269#define SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES_EXCLUDED \
1270 "SDL_JOYSTICK_ARCADESTICK_DEVICES_EXCLUDED"
1271
1288#define SDL_HINT_JOYSTICK_BLACKLIST_DEVICES "SDL_JOYSTICK_BLACKLIST_DEVICES"
1289
1308#define SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED \
1309 "SDL_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED"
1310
1318#define SDL_HINT_JOYSTICK_DEVICE "SDL_JOYSTICK_DEVICE"
1319
1342#define SDL_HINT_JOYSTICK_ENHANCED_REPORTS "SDL_JOYSTICK_ENHANCED_REPORTS"
1343
1359#define SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES "SDL_JOYSTICK_FLIGHTSTICK_DEVICES"
1360
1380#define SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES_EXCLUDED \
1381 "SDL_JOYSTICK_FLIGHTSTICK_DEVICES_EXCLUDED"
1382
1398#define SDL_HINT_JOYSTICK_GAMEINPUT "SDL_JOYSTICK_GAMEINPUT"
1399
1400#if SDL_VERSION_ATLEAST(3, 4, 4)
1401
1420#define SDL_HINT_JOYSTICK_GAMEINPUT_RAW "SDL_JOYSTICK_GAMEINPUT_RAW"
1421
1422#endif // SDL_VERSION_ATLEAST(3, 4, 4)
1423
1439#define SDL_HINT_JOYSTICK_GAMECUBE_DEVICES "SDL_JOYSTICK_GAMECUBE_DEVICES"
1440
1460#define SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED \
1461 "SDL_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED"
1462
1478#define SDL_HINT_JOYSTICK_HIDAPI "SDL_JOYSTICK_HIDAPI"
1479
1495#define SDL_HINT_JOYSTICK_HIDAPI_COMBINE_JOY_CONS \
1496 "SDL_JOYSTICK_HIDAPI_COMBINE_JOY_CONS"
1497
1513#define SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE "SDL_JOYSTICK_HIDAPI_GAMECUBE"
1514
1534#define SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE \
1535 "SDL_JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE"
1536
1552#define SDL_HINT_JOYSTICK_HIDAPI_JOY_CONS "SDL_JOYSTICK_HIDAPI_JOY_CONS"
1553
1571#define SDL_HINT_JOYSTICK_HIDAPI_JOYCON_HOME_LED \
1572 "SDL_JOYSTICK_HIDAPI_JOYCON_HOME_LED"
1573
1589#define SDL_HINT_JOYSTICK_HIDAPI_LUNA "SDL_JOYSTICK_HIDAPI_LUNA"
1590
1606#define SDL_HINT_JOYSTICK_HIDAPI_NINTENDO_CLASSIC \
1607 "SDL_JOYSTICK_HIDAPI_NINTENDO_CLASSIC"
1608
1629#define SDL_HINT_JOYSTICK_HIDAPI_PS3 "SDL_JOYSTICK_HIDAPI_PS3"
1630
1646#define SDL_HINT_JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER \
1647 "SDL_JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER"
1648
1664#define SDL_HINT_JOYSTICK_HIDAPI_PS4 "SDL_JOYSTICK_HIDAPI_PS4"
1665
1679#define SDL_HINT_JOYSTICK_HIDAPI_PS4_REPORT_INTERVAL \
1680 "SDL_JOYSTICK_HIDAPI_PS4_REPORT_INTERVAL"
1681
1697#define SDL_HINT_JOYSTICK_HIDAPI_PS5 "SDL_JOYSTICK_HIDAPI_PS5"
1698
1710#define SDL_HINT_JOYSTICK_HIDAPI_PS5_PLAYER_LED \
1711 "SDL_JOYSTICK_HIDAPI_PS5_PLAYER_LED"
1712
1728#define SDL_HINT_JOYSTICK_HIDAPI_SHIELD "SDL_JOYSTICK_HIDAPI_SHIELD"
1729
1743#define SDL_HINT_JOYSTICK_HIDAPI_STADIA "SDL_JOYSTICK_HIDAPI_STADIA"
1744
1759#define SDL_HINT_JOYSTICK_HIDAPI_STEAM "SDL_JOYSTICK_HIDAPI_STEAM"
1760
1778#define SDL_HINT_JOYSTICK_HIDAPI_STEAM_HOME_LED \
1779 "SDL_JOYSTICK_HIDAPI_STEAM_HOME_LED"
1780
1796#define SDL_HINT_JOYSTICK_HIDAPI_STEAMDECK "SDL_JOYSTICK_HIDAPI_STEAMDECK"
1797
1813#define SDL_HINT_JOYSTICK_HIDAPI_STEAM_HORI "SDL_JOYSTICK_HIDAPI_STEAM_HORI"
1814
1815#if SDL_VERSION_ATLEAST(3, 4, 0)
1816
1832#define SDL_HINT_JOYSTICK_HIDAPI_LG4FF "SDL_JOYSTICK_HIDAPI_LG4FF"
1833
1849#define SDL_HINT_JOYSTICK_HIDAPI_8BITDO "SDL_JOYSTICK_HIDAPI_8BITDO"
1850
1868#define SDL_HINT_JOYSTICK_HIDAPI_SINPUT "SDL_JOYSTICK_HIDAPI_SINPUT"
1869
1885#define SDL_HINT_JOYSTICK_HIDAPI_ZUIKI "SDL_JOYSTICK_HIDAPI_ZUIKI"
1886
1902#define SDL_HINT_JOYSTICK_HIDAPI_FLYDIGI "SDL_JOYSTICK_HIDAPI_FLYDIGI"
1903
1904#endif // SDL_VERSION_ATLEAST(3, 4, 0)
1905
1921#define SDL_HINT_JOYSTICK_HIDAPI_SWITCH "SDL_JOYSTICK_HIDAPI_SWITCH"
1922
1940#define SDL_HINT_JOYSTICK_HIDAPI_SWITCH_HOME_LED \
1941 "SDL_JOYSTICK_HIDAPI_SWITCH_HOME_LED"
1942
1956#define SDL_HINT_JOYSTICK_HIDAPI_SWITCH_PLAYER_LED \
1957 "SDL_JOYSTICK_HIDAPI_SWITCH_PLAYER_LED"
1958
1959#if SDL_VERSION_ATLEAST(3, 4, 0)
1960
1976#define SDL_HINT_JOYSTICK_HIDAPI_SWITCH2 "SDL_JOYSTICK_HIDAPI_SWITCH2"
1977
1978#endif // SDL_VERSION_ATLEAST(3, 4, 0)
1979
1994#define SDL_HINT_JOYSTICK_HIDAPI_VERTICAL_JOY_CONS \
1995 "SDL_JOYSTICK_HIDAPI_VERTICAL_JOY_CONS"
1996
2013#define SDL_HINT_JOYSTICK_HIDAPI_WII "SDL_JOYSTICK_HIDAPI_WII"
2014
2028#define SDL_HINT_JOYSTICK_HIDAPI_WII_PLAYER_LED \
2029 "SDL_JOYSTICK_HIDAPI_WII_PLAYER_LED"
2030
2047#define SDL_HINT_JOYSTICK_HIDAPI_XBOX "SDL_JOYSTICK_HIDAPI_XBOX"
2048
2064#define SDL_HINT_JOYSTICK_HIDAPI_XBOX_360 "SDL_JOYSTICK_HIDAPI_XBOX_360"
2065
2079#define SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED \
2080 "SDL_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED"
2081
2097#define SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS \
2098 "SDL_JOYSTICK_HIDAPI_XBOX_360_WIRELESS"
2099
2115#define SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE "SDL_JOYSTICK_HIDAPI_XBOX_ONE"
2116
2134#define SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE_HOME_LED \
2135 "SDL_JOYSTICK_HIDAPI_XBOX_ONE_HOME_LED"
2136
2137#if SDL_VERSION_ATLEAST(3, 4, 0)
2138
2154#define SDL_HINT_JOYSTICK_HIDAPI_GIP "SDL_JOYSTICK_HIDAPI_GIP"
2155
2172#define SDL_HINT_JOYSTICK_HIDAPI_GIP_RESET_FOR_METADATA \
2173 "SDL_JOYSTICK_HIDAPI_GIP_RESET_FOR_METADATA"
2174
2175#endif // SDL_VERSION_ATLEAST(3, 4, 0)
2176
2189#define SDL_HINT_JOYSTICK_IOKIT "SDL_JOYSTICK_IOKIT"
2190
2204#define SDL_HINT_JOYSTICK_LINUX_CLASSIC "SDL_JOYSTICK_LINUX_CLASSIC"
2205
2219#define SDL_HINT_JOYSTICK_LINUX_DEADZONES "SDL_JOYSTICK_LINUX_DEADZONES"
2220
2237#define SDL_HINT_JOYSTICK_LINUX_DIGITAL_HATS "SDL_JOYSTICK_LINUX_DIGITAL_HATS"
2238
2253#define SDL_HINT_JOYSTICK_LINUX_HAT_DEADZONES "SDL_JOYSTICK_LINUX_HAT_DEADZONES"
2254
2268#define SDL_HINT_JOYSTICK_MFI "SDL_JOYSTICK_MFI"
2269
2283#define SDL_HINT_JOYSTICK_RAWINPUT "SDL_JOYSTICK_RAWINPUT"
2284
2300#define SDL_HINT_JOYSTICK_RAWINPUT_CORRELATE_XINPUT \
2301 "SDL_JOYSTICK_RAWINPUT_CORRELATE_XINPUT"
2302
2316#define SDL_HINT_JOYSTICK_ROG_CHAKRAM "SDL_JOYSTICK_ROG_CHAKRAM"
2317
2331#define SDL_HINT_JOYSTICK_THREAD "SDL_JOYSTICK_THREAD"
2332
2348#define SDL_HINT_JOYSTICK_THROTTLE_DEVICES "SDL_JOYSTICK_THROTTLE_DEVICES"
2349
2369#define SDL_HINT_JOYSTICK_THROTTLE_DEVICES_EXCLUDED \
2370 "SDL_JOYSTICK_THROTTLE_DEVICES_EXCLUDED"
2371
2385#define SDL_HINT_JOYSTICK_WGI "SDL_JOYSTICK_WGI"
2386
2402#define SDL_HINT_JOYSTICK_WHEEL_DEVICES "SDL_JOYSTICK_WHEEL_DEVICES"
2403
2422#define SDL_HINT_JOYSTICK_WHEEL_DEVICES_EXCLUDED \
2423 "SDL_JOYSTICK_WHEEL_DEVICES_EXCLUDED"
2424
2441#define SDL_HINT_JOYSTICK_ZERO_CENTERED_DEVICES \
2442 "SDL_JOYSTICK_ZERO_CENTERED_DEVICES"
2443
2444#if SDL_VERSION_ATLEAST(3, 2, 5)
2445
2466#define SDL_HINT_JOYSTICK_HAPTIC_AXES "SDL_JOYSTICK_HAPTIC_AXES"
2467
2468#endif // SDL_VERSION_ATLEAST(3, 2, 5)
2469
2501#define SDL_HINT_KEYCODE_OPTIONS "SDL_KEYCODE_OPTIONS"
2502
2515#define SDL_HINT_KMSDRM_DEVICE_INDEX "SDL_KMSDRM_DEVICE_INDEX"
2516
2541#define SDL_HINT_KMSDRM_REQUIRE_DRM_MASTER "SDL_KMSDRM_REQUIRE_DRM_MASTER"
2542
2543#if SDL_VERSION_ATLEAST(3, 4, 0)
2544
2564#define SDL_HINT_KMSDRM_ATOMIC "SDL_KMSDRM_ATOMIC"
2565
2566#endif // SDL_VERSION_ATLEAST(3, 4, 0)
2567
2597#define SDL_HINT_LOGGING "SDL_LOGGING"
2598
2612#define SDL_HINT_MAC_BACKGROUND_APP "SDL_MAC_BACKGROUND_APP"
2613
2628#define SDL_HINT_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK \
2629 "SDL_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK"
2630
2652#define SDL_HINT_MAC_OPENGL_ASYNC_DISPATCH "SDL_MAC_OPENGL_ASYNC_DISPATCH"
2653
2677#define SDL_HINT_MAC_OPTION_AS_ALT "SDL_MAC_OPTION_AS_ALT"
2678
2692#define SDL_HINT_MAC_SCROLL_MOMENTUM "SDL_MAC_SCROLL_MOMENTUM"
2693
2694#if SDL_VERSION_ATLEAST(3, 4, 0)
2695
2709#define SDL_HINT_MAC_PRESS_AND_HOLD "SDL_MAC_PRESS_AND_HOLD"
2710
2711#endif // SDL_VERSION_ATLEAST(3, 4, 0)
2712
2741#define SDL_HINT_MAIN_CALLBACK_RATE "SDL_MAIN_CALLBACK_RATE"
2742
2760#define SDL_HINT_MOUSE_AUTO_CAPTURE "SDL_MOUSE_AUTO_CAPTURE"
2761
2769#define SDL_HINT_MOUSE_DOUBLE_CLICK_RADIUS "SDL_MOUSE_DOUBLE_CLICK_RADIUS"
2770
2778#define SDL_HINT_MOUSE_DOUBLE_CLICK_TIME "SDL_MOUSE_DOUBLE_CLICK_TIME"
2779
2790#define SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR "SDL_MOUSE_DEFAULT_SYSTEM_CURSOR"
2791
2792#if SDL_VERSION_ATLEAST(3, 4, 0)
2793
2810#define SDL_HINT_MOUSE_DPI_SCALE_CURSORS "SDL_MOUSE_DPI_SCALE_CURSORS"
2811
2812#endif // SDL_VERSION_ATLEAST(3, 4, 0)
2813
2844#define SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE \
2845 "SDL_MOUSE_EMULATE_WARP_WITH_RELATIVE"
2846
2859#define SDL_HINT_MOUSE_FOCUS_CLICKTHROUGH "SDL_MOUSE_FOCUS_CLICKTHROUGH"
2860
2869#define SDL_HINT_MOUSE_NORMAL_SPEED_SCALE "SDL_MOUSE_NORMAL_SPEED_SCALE"
2870
2890#define SDL_HINT_MOUSE_RELATIVE_MODE_CENTER "SDL_MOUSE_RELATIVE_MODE_CENTER"
2891
2900#define SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE "SDL_MOUSE_RELATIVE_SPEED_SCALE"
2901
2919#define SDL_HINT_MOUSE_RELATIVE_SYSTEM_SCALE "SDL_MOUSE_RELATIVE_SYSTEM_SCALE"
2920
2938#define SDL_HINT_MOUSE_RELATIVE_WARP_MOTION "SDL_MOUSE_RELATIVE_WARP_MOTION"
2939
2957#define SDL_HINT_MOUSE_RELATIVE_CURSOR_VISIBLE \
2958 "SDL_MOUSE_RELATIVE_CURSOR_VISIBLE"
2959
2975#define SDL_HINT_MOUSE_TOUCH_EVENTS "SDL_MOUSE_TOUCH_EVENTS"
2976
2993#define SDL_HINT_MUTE_CONSOLE_KEYBOARD "SDL_MUTE_CONSOLE_KEYBOARD"
2994
3008#define SDL_HINT_NO_SIGNAL_HANDLERS "SDL_NO_SIGNAL_HANDLERS"
3009
3018#define SDL_HINT_OPENGL_LIBRARY "SDL_OPENGL_LIBRARY"
3019
3030#define SDL_HINT_EGL_LIBRARY "SDL_EGL_LIBRARY"
3031
3063#define SDL_HINT_OPENGL_ES_DRIVER "SDL_OPENGL_ES_DRIVER"
3064
3065#if SDL_VERSION_ATLEAST(3, 4, 2)
3066
3105#define SDL_HINT_OPENGL_FORCE_SRGB_FRAMEBUFFER \
3106 "SDL_OPENGL_FORCE_SRGB_FRAMEBUFFER"
3107
3108#endif // SDL_VERSION_ATLEAST(3, 4, 2)
3109
3120#define SDL_HINT_OPENVR_LIBRARY "SDL_OPENVR_LIBRARY"
3121
3139#define SDL_HINT_ORIENTATIONS "SDL_ORIENTATIONS"
3140
3159#define SDL_HINT_POLL_SENTINEL "SDL_POLL_SENTINEL"
3160
3177#define SDL_HINT_PREFERRED_LOCALES "SDL_PREFERRED_LOCALES"
3178
3200#define SDL_HINT_QUIT_ON_LAST_WINDOW_CLOSE "SDL_QUIT_ON_LAST_WINDOW_CLOSE"
3201
3215#define SDL_HINT_RENDER_DIRECT3D_THREADSAFE "SDL_RENDER_DIRECT3D_THREADSAFE"
3216
3231#define SDL_HINT_RENDER_DIRECT3D11_DEBUG "SDL_RENDER_DIRECT3D11_DEBUG"
3232
3233#if SDL_VERSION_ATLEAST(3, 4, 0)
3234
3251#define SDL_HINT_RENDER_DIRECT3D11_WARP "SDL_RENDER_DIRECT3D11_WARP"
3252
3253#endif // SDL_VERSION_ATLEAST(3, 4, 0)
3254
3267#define SDL_HINT_RENDER_VULKAN_DEBUG "SDL_RENDER_VULKAN_DEBUG"
3268
3281#define SDL_HINT_RENDER_GPU_DEBUG "SDL_RENDER_GPU_DEBUG"
3282
3296#define SDL_HINT_RENDER_GPU_LOW_POWER "SDL_RENDER_GPU_LOW_POWER"
3297
3329#define SDL_HINT_RENDER_DRIVER "SDL_RENDER_DRIVER"
3330
3347#define SDL_HINT_RENDER_LINE_METHOD "SDL_RENDER_LINE_METHOD"
3348
3362#define SDL_HINT_RENDER_METAL_PREFER_LOW_POWER_DEVICE \
3363 "SDL_RENDER_METAL_PREFER_LOW_POWER_DEVICE"
3364
3380#define SDL_HINT_RENDER_VSYNC "SDL_RENDER_VSYNC"
3381
3397#define SDL_HINT_RETURN_KEY_HIDES_IME "SDL_RETURN_KEY_HIDES_IME"
3398
3416#define SDL_HINT_ROG_GAMEPAD_MICE "SDL_ROG_GAMEPAD_MICE"
3417
3436#define SDL_HINT_ROG_GAMEPAD_MICE_EXCLUDED "SDL_ROG_GAMEPAD_MICE_EXCLUDED"
3437
3438#if SDL_VERSION_ATLEAST(3, 4, 0)
3439
3447#define SDL_HINT_PS2_GS_WIDTH "SDL_PS2_GS_WIDTH"
3448
3456#define SDL_HINT_PS2_GS_HEIGHT "SDL_PS2_GS_HEIGHT"
3457
3468#define SDL_HINT_PS2_GS_PROGRESSIVE "SDL_PS2_GS_PROGRESSIVE"
3469
3481#define SDL_HINT_PS2_GS_MODE "SDL_PS2_GS_MODE"
3482
3483#endif // SDL_VERSION_ATLEAST(3, 4, 0)
3484
3495#define SDL_HINT_RPI_VIDEO_LAYER "SDL_RPI_VIDEO_LAYER"
3496
3517#define SDL_HINT_SCREENSAVER_INHIBIT_ACTIVITY_NAME \
3518 "SDL_SCREENSAVER_INHIBIT_ACTIVITY_NAME"
3519
3537#define SDL_HINT_SHUTDOWN_DBUS_ON_QUIT "SDL_SHUTDOWN_DBUS_ON_QUIT"
3538
3551#define SDL_HINT_STORAGE_TITLE_DRIVER "SDL_STORAGE_TITLE_DRIVER"
3552
3565#define SDL_HINT_STORAGE_USER_DRIVER "SDL_STORAGE_USER_DRIVER"
3566
3592#define SDL_HINT_THREAD_FORCE_REALTIME_TIME_CRITICAL \
3593 "SDL_THREAD_FORCE_REALTIME_TIME_CRITICAL"
3594
3616#define SDL_HINT_THREAD_PRIORITY_POLICY "SDL_THREAD_PRIORITY_POLICY"
3617
3636#define SDL_HINT_TIMER_RESOLUTION "SDL_TIMER_RESOLUTION"
3637
3651#define SDL_HINT_TOUCH_MOUSE_EVENTS "SDL_TOUCH_MOUSE_EVENTS"
3652
3670#define SDL_HINT_TRACKPAD_IS_TOUCH_ONLY "SDL_TRACKPAD_IS_TOUCH_ONLY"
3671
3685#define SDL_HINT_TV_REMOTE_AS_JOYSTICK "SDL_TV_REMOTE_AS_JOYSTICK"
3686
3699#define SDL_HINT_VIDEO_ALLOW_SCREENSAVER "SDL_VIDEO_ALLOW_SCREENSAVER"
3700
3726#define SDL_HINT_VIDEO_DISPLAY_PRIORITY "SDL_VIDEO_DISPLAY_PRIORITY"
3727
3749#define SDL_HINT_VIDEO_DOUBLE_BUFFER "SDL_VIDEO_DOUBLE_BUFFER"
3750
3767#define SDL_HINT_VIDEO_DRIVER "SDL_VIDEO_DRIVER"
3768
3780#define SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES "SDL_VIDEO_DUMMY_SAVE_FRAMES"
3781
3794#define SDL_HINT_VIDEO_EGL_ALLOW_GETDISPLAY_FALLBACK \
3795 "SDL_VIDEO_EGL_ALLOW_GETDISPLAY_FALLBACK"
3796
3810#define SDL_HINT_VIDEO_FORCE_EGL "SDL_VIDEO_FORCE_EGL"
3811
3828#define SDL_HINT_VIDEO_MAC_FULLSCREEN_SPACES "SDL_VIDEO_MAC_FULLSCREEN_SPACES"
3829
3847#define SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY \
3848 "SDL_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY"
3849
3850#if SDL_VERSION_ATLEAST(3, 4, 0)
3851
3867#define SDL_HINT_VIDEO_METAL_AUTO_RESIZE_DRAWABLE \
3868 "SDL_VIDEO_METAL_AUTO_RESIZE_DRAWABLE"
3869
3888#define SDL_HINT_VIDEO_MATCH_EXCLUSIVE_MODE_ON_MOVE \
3889 "SDL_VIDEO_MATCH_EXCLUSIVE_MODE_ON_MOVE"
3890
3891#endif // SDL_VERSION_ATLEAST(3, 4, 0)
3892
3909#define SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS "SDL_VIDEO_MINIMIZE_ON_FOCUS_LOSS"
3910
3926#define SDL_HINT_VIDEO_OFFSCREEN_SAVE_FRAMES "SDL_VIDEO_OFFSCREEN_SAVE_FRAMES"
3927
3952#define SDL_HINT_VIDEO_SYNC_WINDOW_OPERATIONS "SDL_VIDEO_SYNC_WINDOW_OPERATIONS"
3953
3969#define SDL_HINT_VIDEO_WAYLAND_ALLOW_LIBDECOR "SDL_VIDEO_WAYLAND_ALLOW_LIBDECOR"
3970
3988#define SDL_HINT_VIDEO_WAYLAND_MODE_EMULATION "SDL_VIDEO_WAYLAND_MODE_EMULATION"
3989
4010#define SDL_HINT_VIDEO_WAYLAND_MODE_SCALING "SDL_VIDEO_WAYLAND_MODE_SCALING"
4011
4030#define SDL_HINT_VIDEO_WAYLAND_PREFER_LIBDECOR \
4031 "SDL_VIDEO_WAYLAND_PREFER_LIBDECOR"
4032
4070#define SDL_HINT_VIDEO_WAYLAND_SCALE_TO_DISPLAY \
4071 "SDL_VIDEO_WAYLAND_SCALE_TO_DISPLAY"
4072
4093#define SDL_HINT_VIDEO_WIN_D3DCOMPILER "SDL_VIDEO_WIN_D3DCOMPILER"
4094
4095#if SDL_VERSION_ATLEAST(3, 2, 10)
4096
4111#define SDL_HINT_VIDEO_X11_EXTERNAL_WINDOW_INPUT \
4112 "SDL_VIDEO_X11_EXTERNAL_WINDOW_INPUT"
4113
4114#endif // SDL_VERSION_ATLEAST(3, 2, 10)
4115
4129#define SDL_HINT_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR \
4130 "SDL_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR"
4131
4149#define SDL_HINT_VIDEO_X11_NET_WM_PING "SDL_VIDEO_X11_NET_WM_PING"
4150
4163#define SDL_HINT_VIDEO_X11_NODIRECTCOLOR "SDL_VIDEO_X11_NODIRECTCOLOR"
4164
4174#define SDL_HINT_VIDEO_X11_SCALING_FACTOR "SDL_VIDEO_X11_SCALING_FACTOR"
4175
4183#define SDL_HINT_VIDEO_X11_VISUALID "SDL_VIDEO_X11_VISUALID"
4184
4192#define SDL_HINT_VIDEO_X11_WINDOW_VISUALID "SDL_VIDEO_X11_WINDOW_VISUALID"
4193
4206#define SDL_HINT_VIDEO_X11_XRANDR "SDL_VIDEO_X11_XRANDR"
4207
4221#define SDL_HINT_VITA_ENABLE_BACK_TOUCH "SDL_VITA_ENABLE_BACK_TOUCH"
4222
4236#define SDL_HINT_VITA_ENABLE_FRONT_TOUCH "SDL_VITA_ENABLE_FRONT_TOUCH"
4237
4247#define SDL_HINT_VITA_MODULE_PATH "SDL_VITA_MODULE_PATH"
4248
4260#define SDL_HINT_VITA_PVR_INIT "SDL_VITA_PVR_INIT"
4261
4275#define SDL_HINT_VITA_RESOLUTION "SDL_VITA_RESOLUTION"
4276
4290#define SDL_HINT_VITA_PVR_OPENGL "SDL_VITA_PVR_OPENGL"
4291
4305#define SDL_HINT_VITA_TOUCH_MOUSE_DEVICE "SDL_VITA_TOUCH_MOUSE_DEVICE"
4306
4316#define SDL_HINT_VULKAN_DISPLAY "SDL_VULKAN_DISPLAY"
4317
4326#define SDL_HINT_VULKAN_LIBRARY "SDL_VULKAN_LIBRARY"
4327
4357#define SDL_HINT_WAVE_FACT_CHUNK "SDL_WAVE_FACT_CHUNK"
4358
4369#define SDL_HINT_WAVE_CHUNK_LIMIT "SDL_WAVE_CHUNK_LIMIT"
4370
4397#define SDL_HINT_WAVE_RIFF_CHUNK_SIZE "SDL_WAVE_RIFF_CHUNK_SIZE"
4398
4417#define SDL_HINT_WAVE_TRUNCATION "SDL_WAVE_TRUNCATION"
4418
4433#define SDL_HINT_WINDOW_ACTIVATE_WHEN_RAISED "SDL_WINDOW_ACTIVATE_WHEN_RAISED"
4434
4449#define SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN "SDL_WINDOW_ACTIVATE_WHEN_SHOWN"
4450
4467#define SDL_HINT_WINDOW_ALLOW_TOPMOST "SDL_WINDOW_ALLOW_TOPMOST"
4468
4483#define SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN \
4484 "SDL_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN"
4485
4499#define SDL_HINT_WINDOWS_CLOSE_ON_ALT_F4 "SDL_WINDOWS_CLOSE_ON_ALT_F4"
4500
4527#define SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS \
4528 "SDL_WINDOWS_ENABLE_MENU_MNEMONICS"
4529
4542#define SDL_HINT_WINDOWS_ENABLE_MESSAGELOOP "SDL_WINDOWS_ENABLE_MESSAGELOOP"
4543
4557#define SDL_HINT_WINDOWS_GAMEINPUT "SDL_WINDOWS_GAMEINPUT"
4558
4571#define SDL_HINT_WINDOWS_RAW_KEYBOARD "SDL_WINDOWS_RAW_KEYBOARD"
4572
4573#if SDL_VERSION_ATLEAST(3, 4, 0)
4574
4595#define SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS \
4596 "SDL_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS"
4597
4598#endif // SDL_VERSION_ATLEAST(3, 4, 0)
4599
4600#if SDL_VERSION_ATLEAST(3, 4, 4)
4601
4618#define SDL_HINT_WINDOWS_RAW_KEYBOARD_INPUTSINK \
4619 "SDL_WINDOWS_RAW_KEYBOARD_INPUTSINK"
4620
4621#endif // SDL_VERSION_ATLEAST(3, 4, 4)
4622
4642#define SDL_HINT_WINDOWS_FORCE_SEMAPHORE_KERNEL \
4643 "SDL_WINDOWS_FORCE_SEMAPHORE_KERNEL"
4644
4653#define SDL_HINT_WINDOWS_INTRESOURCE_ICON "SDL_WINDOWS_INTRESOURCE_ICON"
4654
4663#define SDL_HINT_WINDOWS_INTRESOURCE_ICON_SMALL \
4664 "SDL_WINDOWS_INTRESOURCE_ICON_SMALL"
4665
4692#define SDL_HINT_WINDOWS_USE_D3D9EX "SDL_WINDOWS_USE_D3D9EX"
4693
4709#define SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE \
4710 "SDL_WINDOWS_ERASE_BACKGROUND_MODE"
4711
4731#define SDL_HINT_X11_FORCE_OVERRIDE_REDIRECT "SDL_X11_FORCE_OVERRIDE_REDIRECT"
4732
4747#define SDL_HINT_X11_WINDOW_TYPE "SDL_X11_WINDOW_TYPE"
4748
4758#define SDL_HINT_X11_XCB_LIBRARY "SDL_X11_XCB_LIBRARY"
4759
4772#define SDL_HINT_XINPUT_ENABLED "SDL_XINPUT_ENABLED"
4773
4795#define SDL_HINT_ASSERT "SDL_ASSERT"
4796
4810#define SDL_HINT_PEN_MOUSE_EVENTS "SDL_PEN_MOUSE_EVENTS"
4811
4825#define SDL_HINT_PEN_TOUCH_EVENTS "SDL_PEN_TOUCH_EVENTS"
4826
4827#endif // SDL3PP_DOC
4828
4834using HintPriority = SDL_HintPriority;
4835
4836constexpr HintPriority HINT_DEFAULT = SDL_HINT_DEFAULT;
4837
4838constexpr HintPriority HINT_NORMAL = SDL_HINT_NORMAL;
4839
4840constexpr HintPriority HINT_OVERRIDE = SDL_HINT_OVERRIDE;
4841
4863 StringParam value,
4864 HintPriority priority)
4865{
4866 CheckError(SDL_SetHintWithPriority(name, value, priority));
4867}
4868
4888inline void SetHint(StringParam name, StringParam value)
4889{
4890 CheckError(SDL_SetHint(name, value));
4891}
4892
4910inline void ResetHint(StringParam name) { CheckError(SDL_ResetHint(name)); }
4911
4925inline void ResetHints() { SDL_ResetHints(); }
4926
4940inline const char* GetHint(StringParam name) { return SDL_GetHint(name); }
4941
4957inline bool GetHintBoolean(StringParam name, bool default_value)
4958{
4959 return SDL_GetHintBoolean(name, default_value);
4960}
4961
4982using HintCallback = void(SDLCALL*)(void* userdata,
4983 const char* name,
4984 const char* oldValue,
4985 const char* newValue);
4986
5009 void(const char* name, const char* oldValue, const char* newValue)>;
5010
5030 HintCallback callback,
5031 void* userdata)
5032{
5033 CheckError(SDL_AddHintCallback(name, callback, userdata));
5034}
5035
5053inline void AddHintCallback(StringParam name, HintCB callback)
5054{
5055 AddHintCallback(std::move(name), callback.wrapper, callback.data);
5056}
5057
5073 HintCallback callback,
5074 void* userdata)
5075{
5076 SDL_RemoveHintCallback(name, callback, userdata);
5077}
5078
5080
5081} // namespace SDL
5082
5083#endif /* SDL3PP_HINTS_H_ */
Helpers to use C++ strings parameters.
Definition SDL3pp_strings.h:43
constexpr void CheckError(bool result)
Check and throw if returned value from SDL is an error.
Definition SDL3pp_error.h:199
MakeFrontCallback< void(const char *name, const char *oldValue, const char *newValue)> HintCB
A callback used to send notifications of hint value changes.
Definition SDL3pp_hints.h:5008
void(SDLCALL *)(void *userdata, const char *name, const char *oldValue, const char *newValue) HintCallback
A callback used to send notifications of hint value changes.
Definition SDL3pp_hints.h:4982
void SetHint(StringParam name, StringParam value)
Set a hint with normal priority.
Definition SDL3pp_hints.h:4888
void AddHintCallback(StringParam name, HintCallback callback, void *userdata)
Add a function to watch a particular hint.
Definition SDL3pp_hints.h:5029
constexpr HintPriority HINT_NORMAL
NORMAL.
Definition SDL3pp_hints.h:4838
constexpr HintPriority HINT_OVERRIDE
OVERRIDE.
Definition SDL3pp_hints.h:4840
bool GetHintBoolean(StringParam name, bool default_value)
Get the boolean value of a hint variable.
Definition SDL3pp_hints.h:4957
void SetHintWithPriority(StringParam name, StringParam value, HintPriority priority)
Set a hint with a specific priority.
Definition SDL3pp_hints.h:4862
SDL_HintPriority HintPriority
An enumeration of hint priorities.
Definition SDL3pp_hints.h:4834
void RemoveHintCallback(StringParam name, HintCallback callback, void *userdata)
Remove a function watching a particular hint.
Definition SDL3pp_hints.h:5072
const char * GetHint(StringParam name)
Get the value of a hint.
Definition SDL3pp_hints.h:4940
void ResetHint(StringParam name)
Reset a hint to the default value.
Definition SDL3pp_hints.h:4910
void ResetHints()
Reset all hints to the default values.
Definition SDL3pp_hints.h:4925
constexpr HintPriority HINT_DEFAULT
DEFAULT.
Definition SDL3pp_hints.h:4836
Main include header for the SDL3pp library.
Definition SDL3pp_callbackWrapper.h:169