1use super::*;
4
5pub const METADATA_SDL_HINT_ALLOW_ALT_TAB_WHILE_GRABBED: Hint = Hint {
6 module: "hints",
7 name: "SDL_HINT_ALLOW_ALT_TAB_WHILE_GRABBED",
8 short_name: "ALLOW_ALT_TAB_WHILE_GRABBED",
9 value: crate::hints::SDL_HINT_ALLOW_ALT_TAB_WHILE_GRABBED,
10 doc: Some(
11 "Specify the behavior of Alt+Tab while the keyboard is grabbed.\n\nBy default, SDL emulates Alt+Tab functionality while the keyboard is\ngrabbed and your window is full-screen. This prevents the user from getting\nstuck in your application if you've enabled keyboard grab.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will not handle Alt+Tab. Your application is responsible for\nhandling Alt+Tab while the keyboard is grabbed.\n- \"1\": SDL will minimize your window when Alt+Tab is pressed (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
12 ),
13 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
14};
15pub const METADATA_SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY: Hint = Hint {
16 module: "hints",
17 name: "SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY",
18 short_name: "ANDROID_ALLOW_RECREATE_ACTIVITY",
19 value: crate::hints::SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY,
20 doc: Some(
21 "A variable to control whether the SDL activity is allowed to be re-created.\n\nIf this hint is true, the activity can be recreated on demand by the OS,\nand Java static data and C++ static data remain with their current values.\nIf this hint is false, then SDL will call exit() when you return from your\nmain function and the application will be terminated and then started fresh\neach time.\n\nThe variable can be set to the following values:\n\n- \"0\": The application starts fresh at each launch. (default)\n- \"1\": The application activity can be recreated by the OS.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
22 ),
23 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
24};
25pub const METADATA_SDL_HINT_ANDROID_BLOCK_ON_PAUSE: Hint = Hint {
26 module: "hints",
27 name: "SDL_HINT_ANDROID_BLOCK_ON_PAUSE",
28 short_name: "ANDROID_BLOCK_ON_PAUSE",
29 value: crate::hints::SDL_HINT_ANDROID_BLOCK_ON_PAUSE,
30 doc: Some(
31 "A variable to control whether the event loop will block itself when the app\nis paused.\n\nThe variable can be set to the following values:\n\n- \"0\": Non blocking.\n- \"1\": Blocking. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
32 ),
33 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
34};
35pub const METADATA_SDL_HINT_ANDROID_LOW_LATENCY_AUDIO: Hint = Hint {
36 module: "hints",
37 name: "SDL_HINT_ANDROID_LOW_LATENCY_AUDIO",
38 short_name: "ANDROID_LOW_LATENCY_AUDIO",
39 value: crate::hints::SDL_HINT_ANDROID_LOW_LATENCY_AUDIO,
40 doc: Some(
41 "A variable to control whether low latency audio should be enabled.\n\nSome devices have poor quality output when this is enabled, but this is\nusually an improvement in audio latency.\n\nThe variable can be set to the following values:\n\n- \"0\": Low latency audio is not enabled.\n- \"1\": Low latency audio is enabled. (default)\n\nThis hint should be set before SDL audio is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
42 ),
43 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
44};
45pub const METADATA_SDL_HINT_ANDROID_TRAP_BACK_BUTTON: Hint = Hint {
46 module: "hints",
47 name: "SDL_HINT_ANDROID_TRAP_BACK_BUTTON",
48 short_name: "ANDROID_TRAP_BACK_BUTTON",
49 value: crate::hints::SDL_HINT_ANDROID_TRAP_BACK_BUTTON,
50 doc: Some(
51 "A variable to control whether we trap the Android back button to handle it\nmanually.\n\nThis is necessary for the right mouse button to work on some Android\ndevices, or to be able to trap the back button for use in your code\nreliably. If this hint is true, the back button will show up as an\n[`SDL_EVENT_KEY_DOWN`] / [`SDL_EVENT_KEY_UP`] pair with a keycode of\n[`SDL_SCANCODE_AC_BACK`].\n\nThe variable can be set to the following values:\n\n- \"0\": Back button will be handled as usual for system. (default)\n- \"1\": Back button will be trapped, allowing you to handle the key press\nmanually. (This will also let right mouse click work on systems where the\nright mouse button functions as back.)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
52 ),
53 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
54};
55pub const METADATA_SDL_HINT_APP_ID: Hint = Hint {
56 module: "hints",
57 name: "SDL_HINT_APP_ID",
58 short_name: "APP_ID",
59 value: crate::hints::SDL_HINT_APP_ID,
60 doc: Some(
61 "A variable setting the app ID string.\n\nThis string is used by desktop compositors to identify and group windows\ntogether, as well as match applications with associated desktop settings\nand icons.\n\nThis will override [`SDL_PROP_APP_METADATA_IDENTIFIER_STRING`], if set by the\napplication.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
62 ),
63 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
64};
65pub const METADATA_SDL_HINT_APP_NAME: Hint = Hint {
66 module: "hints",
67 name: "SDL_HINT_APP_NAME",
68 short_name: "APP_NAME",
69 value: crate::hints::SDL_HINT_APP_NAME,
70 doc: Some(
71 "A variable setting the application name.\n\nThis hint lets you specify the application name sent to the OS when\nrequired. For example, this will often appear in volume control applets for\naudio streams, and in lists of applications which are inhibiting the\nscreensaver. You should use a string that describes your program (\"My Game\n2: The Revenge\")\n\nThis will override [`SDL_PROP_APP_METADATA_NAME_STRING`], if set by the\napplication.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
72 ),
73 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
74};
75pub const METADATA_SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS: Hint = Hint {
76 module: "hints",
77 name: "SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS",
78 short_name: "APPLE_TV_CONTROLLER_UI_EVENTS",
79 value: crate::hints::SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS,
80 doc: Some(
81 "A variable controlling whether controllers used with the Apple TV generate\nUI events.\n\nWhen UI events are generated by controller input, the app will be\nbackgrounded when the Apple TV remote's menu button is pressed, and when\nthe pause or B buttons on gamepads are pressed.\n\nMore information about properly making use of controllers for the Apple TV\ncan be found here:\n<https://developer.apple.com/tvos/human-interface-guidelines/remote-and-controllers/>\n\nThe variable can be set to the following values:\n\n- \"0\": Controller input does not generate UI events. (default)\n- \"1\": Controller input generates UI events.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
82 ),
83 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
84};
85pub const METADATA_SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION: Hint = Hint {
86 module: "hints",
87 name: "SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION",
88 short_name: "APPLE_TV_REMOTE_ALLOW_ROTATION",
89 value: crate::hints::SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION,
90 doc: Some(
91 "A variable controlling whether the Apple TV remote's joystick axes will\nautomatically match the rotation of the remote.\n\nThe variable can be set to the following values:\n\n- \"0\": Remote orientation does not affect joystick axes. (default)\n- \"1\": Joystick axes are based on the orientation of the remote.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
92 ),
93 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
94};
95pub const METADATA_SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE: Hint = Hint {
96 module: "hints",
97 name: "SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE",
98 short_name: "AUDIO_ALSA_DEFAULT_DEVICE",
99 value: crate::hints::SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE,
100 doc: Some(
101 "Specify the default ALSA audio device name.\n\nThis variable is a specific audio device to open when the \"default\" audio\ndevice is used.\n\nThis hint will be ignored when opening the default playback device if\n[`SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE`] is set, or when opening the\ndefault recording device if [`SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE`] is\nset.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n\n## See also\n- [`SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE`]\n- [`SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE`]\n",
102 ),
103 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
104};
105pub const METADATA_SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE: Hint = Hint {
106 module: "hints",
107 name: "SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE",
108 short_name: "AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE",
109 value: crate::hints::SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE,
110 doc: Some(
111 "Specify the default ALSA audio playback device name.\n\nThis variable is a specific audio device to open for playback, when the\n\"default\" audio device is used.\n\nIf this hint isn't set, SDL will check [`SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE`]\nbefore choosing a reasonable default.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n\n## See also\n- [`SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE`]\n- [`SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE`]\n",
112 ),
113 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
114};
115pub const METADATA_SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE: Hint = Hint {
116 module: "hints",
117 name: "SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE",
118 short_name: "AUDIO_ALSA_DEFAULT_RECORDING_DEVICE",
119 value: crate::hints::SDL_HINT_AUDIO_ALSA_DEFAULT_RECORDING_DEVICE,
120 doc: Some(
121 "Specify the default ALSA audio recording device name.\n\nThis variable is a specific audio device to open for recording, when the\n\"default\" audio device is used.\n\nIf this hint isn't set, SDL will check [`SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE`]\nbefore choosing a reasonable default.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n\n## See also\n- [`SDL_HINT_AUDIO_ALSA_DEFAULT_PLAYBACK_DEVICE`]\n- [`SDL_HINT_AUDIO_ALSA_DEFAULT_DEVICE`]\n",
122 ),
123 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
124};
125pub const METADATA_SDL_HINT_AUDIO_CATEGORY: Hint = Hint {
126 module: "hints",
127 name: "SDL_HINT_AUDIO_CATEGORY",
128 short_name: "AUDIO_CATEGORY",
129 value: crate::hints::SDL_HINT_AUDIO_CATEGORY,
130 doc: Some(
131 "A variable controlling the audio category on iOS and macOS.\n\nThe variable can be set to the following values:\n\n- \"ambient\": Use the AVAudioSessionCategoryAmbient audio category, will be\nmuted by the phone mute switch (default)\n- \"playback\": Use the AVAudioSessionCategoryPlayback category.\n\nFor more information, see Apple's documentation:\n<https://developer.apple.com/library/content/documentation/Audio/Conceptual/AudioSessionProgrammingGuide/AudioSessionCategoriesandModes/AudioSessionCategoriesandModes.html>\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
132 ),
133 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
134};
135pub const METADATA_SDL_HINT_AUDIO_CHANNELS: Hint = Hint {
136 module: "hints",
137 name: "SDL_HINT_AUDIO_CHANNELS",
138 short_name: "AUDIO_CHANNELS",
139 value: crate::hints::SDL_HINT_AUDIO_CHANNELS,
140 doc: Some(
141 "A variable controlling the default audio channel count.\n\nIf the application doesn't specify the audio channel count when opening the\ndevice, this hint can be used to specify a default channel count that will\nbe used. This defaults to \"1\" for recording and \"2\" for playback devices.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
142 ),
143 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
144};
145pub const METADATA_SDL_HINT_AUDIO_DEVICE_APP_ICON_NAME: Hint = Hint {
146 module: "hints",
147 name: "SDL_HINT_AUDIO_DEVICE_APP_ICON_NAME",
148 short_name: "AUDIO_DEVICE_APP_ICON_NAME",
149 value: crate::hints::SDL_HINT_AUDIO_DEVICE_APP_ICON_NAME,
150 doc: Some(
151 "Specify an application icon name for an audio device.\n\nSome audio backends (such as Pulseaudio and Pipewire) allow you to set an\nXDG icon name for your application. Among other things, this icon might\nshow up in a system control panel that lets the user adjust the volume on\nspecific audio streams instead of using one giant master volume slider.\nNote that this is unrelated to the icon used by the windowing system, which\nmay be set with [`SDL_SetWindowIcon`] (or via desktop file on Wayland).\n\nSetting this to \"\" or leaving it unset will have SDL use a reasonable\ndefault, \"applications-games\", which is likely to be installed. See\n<https://specifications.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html>\nand\n<https://specifications.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html>\nfor the relevant XDG icon specs.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
152 ),
153 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
154};
155pub const METADATA_SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES: Hint = Hint {
156 module: "hints",
157 name: "SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES",
158 short_name: "AUDIO_DEVICE_SAMPLE_FRAMES",
159 value: crate::hints::SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES,
160 doc: Some(
161 "A variable controlling device buffer size.\n\nThis hint is an integer > 0, that represents the size of the device's\nbuffer in sample frames (stereo audio data in 16-bit format is 4 bytes per\nsample frame, for example).\n\nSDL3 generally decides this value on behalf of the app, but if for some\nreason the app needs to dictate this (because they want either lower\nlatency or higher throughput AND ARE WILLING TO DEAL WITH what that might\nrequire of the app), they can specify it.\n\nSDL will try to accommodate this value, but there is no promise you'll get\nthe buffer size requested. Many platforms won't honor this request at all,\nor might adjust it.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
162 ),
163 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
164};
165pub const METADATA_SDL_HINT_AUDIO_DEVICE_STREAM_NAME: Hint = Hint {
166 module: "hints",
167 name: "SDL_HINT_AUDIO_DEVICE_STREAM_NAME",
168 short_name: "AUDIO_DEVICE_STREAM_NAME",
169 value: crate::hints::SDL_HINT_AUDIO_DEVICE_STREAM_NAME,
170 doc: Some(
171 "Specify an audio stream name for an audio device.\n\nSome audio backends (such as PulseAudio) allow you to describe your audio\nstream. Among other things, this description might show up in a system\ncontrol panel that lets the user adjust the volume on specific audio\nstreams instead of using one giant master volume slider.\n\nThis hints lets you transmit that information to the OS. The contents of\nthis hint are used while opening an audio device. You should use a string\nthat describes your what your program is playing (\"audio stream\" is\nprobably sufficient in many cases, but this could be useful for something\nlike \"team chat\" if you have a headset playing VoIP audio separately).\n\nSetting this to \"\" or leaving it unset will have SDL use a reasonable\ndefault: \"audio stream\" or something similar.\n\nNote that while this talks about audio streams, this is an OS-level\nconcept, so it applies to a physical audio device in this case, and not an\n[`SDL_AudioStream`], nor an SDL logical audio device.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
172 ),
173 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
174};
175pub const METADATA_SDL_HINT_AUDIO_DEVICE_STREAM_ROLE: Hint = Hint {
176 module: "hints",
177 name: "SDL_HINT_AUDIO_DEVICE_STREAM_ROLE",
178 short_name: "AUDIO_DEVICE_STREAM_ROLE",
179 value: crate::hints::SDL_HINT_AUDIO_DEVICE_STREAM_ROLE,
180 doc: Some(
181 "Specify an application role for an audio device.\n\nSome audio backends (such as Pipewire) allow you to describe the role of\nyour audio stream. Among other things, this description might show up in a\nsystem control panel or software for displaying and manipulating media\nplayback/recording graphs.\n\nThis hints lets you transmit that information to the OS. The contents of\nthis hint are used while opening an audio device. You should use a string\nthat describes your what your program is playing (Game, Music, Movie,\netc...).\n\nSetting this to \"\" or leaving it unset will have SDL use a reasonable\ndefault: \"Game\" or something similar.\n\nNote that while this talks about audio streams, this is an OS-level\nconcept, so it applies to a physical audio device in this case, and not an\n[`SDL_AudioStream`], nor an SDL logical audio device.\n\nFor Windows WASAPI audio, the following roles are supported, and map to\n`AUDIO_STREAM_CATEGORY`:\n\n- \"Other\" (default)\n- \"Communications\" - Real-time communications, such as VOIP or chat\n- \"Game\" - Game audio\n- \"GameChat\" - Game chat audio, similar to \"Communications\" except that\nthis will not attenuate other audio streams\n- \"Movie\" - Music or sound with dialog\n- \"Media\" - Music or sound without dialog\n\nIf your application applies its own echo cancellation, gain control, and\nnoise reduction it should also set [`SDL_HINT_AUDIO_DEVICE_RAW_STREAM`].\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
182 ),
183 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
184};
185pub const METADATA_SDL_HINT_AUDIO_DEVICE_RAW_STREAM: Hint = Hint {
186 module: "hints",
187 name: "SDL_HINT_AUDIO_DEVICE_RAW_STREAM",
188 short_name: "AUDIO_DEVICE_RAW_STREAM",
189 value: crate::hints::SDL_HINT_AUDIO_DEVICE_RAW_STREAM,
190 doc: Some(
191 "Specify whether this audio device should do audio processing.\n\nSome operating systems perform echo cancellation, gain control, and noise\nreduction as needed. If your application already handles these, you can set\nthis hint to prevent the OS from doing additional audio processing.\n\nThis corresponds to the WASAPI audio option `AUDCLNT_STREAMOPTIONS_RAW`.\n\nThe variable can be set to the following values:\n\n- \"0\": audio processing can be done by the OS. (default)\n- \"1\": audio processing is done by the application.\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
192 ),
193 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
194};
195pub const METADATA_SDL_HINT_AUDIO_DISK_INPUT_FILE: Hint = Hint {
196 module: "hints",
197 name: "SDL_HINT_AUDIO_DISK_INPUT_FILE",
198 short_name: "AUDIO_DISK_INPUT_FILE",
199 value: crate::hints::SDL_HINT_AUDIO_DISK_INPUT_FILE,
200 doc: Some(
201 "Specify the input file when recording audio using the disk audio driver.\n\nThis defaults to \"sdlaudio-in.raw\"\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
202 ),
203 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
204};
205pub const METADATA_SDL_HINT_AUDIO_DISK_OUTPUT_FILE: Hint = Hint {
206 module: "hints",
207 name: "SDL_HINT_AUDIO_DISK_OUTPUT_FILE",
208 short_name: "AUDIO_DISK_OUTPUT_FILE",
209 value: crate::hints::SDL_HINT_AUDIO_DISK_OUTPUT_FILE,
210 doc: Some(
211 "Specify the output file when playing audio using the disk audio driver.\n\nThis defaults to \"sdlaudio.raw\"\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
212 ),
213 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
214};
215pub const METADATA_SDL_HINT_AUDIO_DISK_TIMESCALE: Hint = Hint {
216 module: "hints",
217 name: "SDL_HINT_AUDIO_DISK_TIMESCALE",
218 short_name: "AUDIO_DISK_TIMESCALE",
219 value: crate::hints::SDL_HINT_AUDIO_DISK_TIMESCALE,
220 doc: Some(
221 "A variable controlling the audio rate when using the disk audio driver.\n\nThe disk audio driver normally simulates real-time for the audio rate that\nwas specified, but you can use this variable to adjust this rate higher or\nlower down to 0. The default value is \"1.0\".\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
222 ),
223 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
224};
225pub const METADATA_SDL_HINT_AUDIO_DRIVER: Hint = Hint {
226 module: "hints",
227 name: "SDL_HINT_AUDIO_DRIVER",
228 short_name: "AUDIO_DRIVER",
229 value: crate::hints::SDL_HINT_AUDIO_DRIVER,
230 doc: Some(
231 "A variable that specifies an audio backend to use.\n\nBy default, SDL will try all available audio backends in a reasonable order\nuntil it finds one that can work, but this hint allows the app or user to\nforce a specific driver, such as \"pipewire\" if, say, you are on PulseAudio\nbut want to try talking to the lower level instead.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
232 ),
233 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
234};
235pub const METADATA_SDL_HINT_AUDIO_DUMMY_TIMESCALE: Hint = Hint {
236 module: "hints",
237 name: "SDL_HINT_AUDIO_DUMMY_TIMESCALE",
238 short_name: "AUDIO_DUMMY_TIMESCALE",
239 value: crate::hints::SDL_HINT_AUDIO_DUMMY_TIMESCALE,
240 doc: Some(
241 "A variable controlling the audio rate when using the dummy audio driver.\n\nThe dummy audio driver normally simulates real-time for the audio rate that\nwas specified, but you can use this variable to adjust this rate higher or\nlower down to 0. The default value is \"1.0\".\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
242 ),
243 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
244};
245pub const METADATA_SDL_HINT_AUDIO_FORMAT: Hint = Hint {
246 module: "hints",
247 name: "SDL_HINT_AUDIO_FORMAT",
248 short_name: "AUDIO_FORMAT",
249 value: crate::hints::SDL_HINT_AUDIO_FORMAT,
250 doc: Some(
251 "A variable controlling the default audio format.\n\nIf the application doesn't specify the audio format when opening the\ndevice, this hint can be used to specify a default format that will be\nused.\n\nThe variable can be set to the following values:\n\n- \"U8\": Unsigned 8-bit audio\n- \"S8\": Signed 8-bit audio\n- \"S16LE\": Signed 16-bit little-endian audio\n- \"S16BE\": Signed 16-bit big-endian audio\n- \"S16\": Signed 16-bit native-endian audio (default)\n- \"S32LE\": Signed 32-bit little-endian audio\n- \"S32BE\": Signed 32-bit big-endian audio\n- \"S32\": Signed 32-bit native-endian audio\n- \"F32LE\": Floating point little-endian audio\n- \"F32BE\": Floating point big-endian audio\n- \"F32\": Floating point native-endian audio\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
252 ),
253 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
254};
255pub const METADATA_SDL_HINT_AUDIO_FREQUENCY: Hint = Hint {
256 module: "hints",
257 name: "SDL_HINT_AUDIO_FREQUENCY",
258 short_name: "AUDIO_FREQUENCY",
259 value: crate::hints::SDL_HINT_AUDIO_FREQUENCY,
260 doc: Some(
261 "A variable controlling the default audio frequency.\n\nIf the application doesn't specify the audio frequency when opening the\ndevice, this hint can be used to specify a default frequency that will be\nused. This defaults to \"44100\".\n\nThis hint should be set before an audio device is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
262 ),
263 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
264};
265pub const METADATA_SDL_HINT_AUDIO_INCLUDE_MONITORS: Hint = Hint {
266 module: "hints",
267 name: "SDL_HINT_AUDIO_INCLUDE_MONITORS",
268 short_name: "AUDIO_INCLUDE_MONITORS",
269 value: crate::hints::SDL_HINT_AUDIO_INCLUDE_MONITORS,
270 doc: Some(
271 "A variable that causes SDL to not ignore audio \"monitors\".\n\nThis is currently only used by the PulseAudio driver.\n\nBy default, SDL ignores audio devices that aren't associated with physical\nhardware. Changing this hint to \"1\" will expose anything SDL sees that\nappears to be an audio source or sink. This will add \"devices\" to the list\nthat the user probably doesn't want or need, but it can be useful in\nscenarios where you want to hook up SDL to some sort of virtual device,\netc.\n\nThe variable can be set to the following values:\n\n- \"0\": Audio monitor devices will be ignored. (default)\n- \"1\": Audio monitor devices will show up in the device list.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
272 ),
273 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
274};
275pub const METADATA_SDL_HINT_AUTO_UPDATE_JOYSTICKS: Hint = Hint {
276 module: "hints",
277 name: "SDL_HINT_AUTO_UPDATE_JOYSTICKS",
278 short_name: "AUTO_UPDATE_JOYSTICKS",
279 value: crate::hints::SDL_HINT_AUTO_UPDATE_JOYSTICKS,
280 doc: Some(
281 "A variable controlling whether SDL updates joystick state when getting\ninput events.\n\nThe variable can be set to the following values:\n\n- \"0\": You'll call [`SDL_UpdateJoysticks()`] manually.\n- \"1\": SDL will automatically call [`SDL_UpdateJoysticks()`]. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
282 ),
283 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
284};
285pub const METADATA_SDL_HINT_AUTO_UPDATE_SENSORS: Hint = Hint {
286 module: "hints",
287 name: "SDL_HINT_AUTO_UPDATE_SENSORS",
288 short_name: "AUTO_UPDATE_SENSORS",
289 value: crate::hints::SDL_HINT_AUTO_UPDATE_SENSORS,
290 doc: Some(
291 "A variable controlling whether SDL updates sensor state when getting input\nevents.\n\nThe variable can be set to the following values:\n\n- \"0\": You'll call [`SDL_UpdateSensors()`] manually.\n- \"1\": SDL will automatically call [`SDL_UpdateSensors()`]. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
292 ),
293 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
294};
295pub const METADATA_SDL_HINT_BMP_SAVE_LEGACY_FORMAT: Hint = Hint {
296 module: "hints",
297 name: "SDL_HINT_BMP_SAVE_LEGACY_FORMAT",
298 short_name: "BMP_SAVE_LEGACY_FORMAT",
299 value: crate::hints::SDL_HINT_BMP_SAVE_LEGACY_FORMAT,
300 doc: Some(
301 "Prevent SDL from using version 4 of the bitmap header when saving BMPs.\n\nThe bitmap header version 4 is required for proper alpha channel support\nand SDL will use it when required. Should this not be desired, this hint\ncan force the use of the 40 byte header version which is supported\neverywhere.\n\nThe variable can be set to the following values:\n\n- \"0\": Surfaces with a colorkey or an alpha channel are saved to a 32-bit\nBMP file with an alpha mask. SDL will use the bitmap header version 4 and\nset the alpha mask accordingly. (default)\n- \"1\": Surfaces with a colorkey or an alpha channel are saved to a 32-bit\nBMP file without an alpha mask. The alpha channel data will be in the\nfile, but applications are going to ignore it.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
302 ),
303 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
304};
305pub const METADATA_SDL_HINT_CAMERA_DRIVER: Hint = Hint {
306 module: "hints",
307 name: "SDL_HINT_CAMERA_DRIVER",
308 short_name: "CAMERA_DRIVER",
309 value: crate::hints::SDL_HINT_CAMERA_DRIVER,
310 doc: Some(
311 "A variable that decides what camera backend to use.\n\nBy default, SDL will try all available camera backends in a reasonable\norder until it finds one that can work, but this hint allows the app or\nuser to force a specific target, such as \"directshow\" if, say, you are on\nWindows Media Foundations but want to try DirectShow instead.\n\nThe default value is unset, in which case SDL will try to figure out the\nbest camera backend on your behalf. This hint needs to be set before\n[`SDL_Init()`] is called to be useful.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
312 ),
313 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
314};
315pub const METADATA_SDL_HINT_CPU_FEATURE_MASK: Hint = Hint {
316 module: "hints",
317 name: "SDL_HINT_CPU_FEATURE_MASK",
318 short_name: "CPU_FEATURE_MASK",
319 value: crate::hints::SDL_HINT_CPU_FEATURE_MASK,
320 doc: Some(
321 "A variable that limits what CPU features are available.\n\nBy default, SDL marks all features the current CPU supports as available.\nThis hint allows the enabled features to be limited to a subset.\n\nWhen the hint is unset, or empty, SDL will enable all detected CPU\nfeatures.\n\nThe variable can be set to a comma separated list containing the following\nitems:\n\n- \"all\"\n- \"altivec\"\n- \"sse\"\n- \"sse2\"\n- \"sse3\"\n- \"sse41\"\n- \"sse42\"\n- \"avx\"\n- \"avx2\"\n- \"avx512f\"\n- \"arm-simd\"\n- \"neon\"\n- \"lsx\"\n- \"lasx\"\n\nThe items can be prefixed by '+'/'-' to add/remove features.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
322 ),
323 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
324};
325pub const METADATA_SDL_HINT_JOYSTICK_DIRECTINPUT: Hint = Hint {
326 module: "hints",
327 name: "SDL_HINT_JOYSTICK_DIRECTINPUT",
328 short_name: "JOYSTICK_DIRECTINPUT",
329 value: crate::hints::SDL_HINT_JOYSTICK_DIRECTINPUT,
330 doc: Some(
331 "A variable controlling whether DirectInput should be used for controllers.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable DirectInput detection.\n- \"1\": Enable DirectInput detection. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
332 ),
333 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
334};
335pub const METADATA_SDL_HINT_FILE_DIALOG_DRIVER: Hint = Hint {
336 module: "hints",
337 name: "SDL_HINT_FILE_DIALOG_DRIVER",
338 short_name: "FILE_DIALOG_DRIVER",
339 value: crate::hints::SDL_HINT_FILE_DIALOG_DRIVER,
340 doc: Some(
341 "A variable that specifies a dialog backend to use.\n\nBy default, SDL will try all available dialog backends in a reasonable\norder until it finds one that can work, but this hint allows the app or\nuser to force a specific target.\n\nIf the specified target does not exist or is not available, the\ndialog-related function calls will fail.\n\nThis hint currently only applies to platforms using the generic \"Unix\"\ndialog implementation, but may be extended to more platforms in the future.\nNote that some Unix and Unix-like platforms have their own implementation,\nsuch as macOS and Haiku.\n\nThe variable can be set to the following values:\n\n- NULL: Select automatically (default, all platforms)\n- \"portal\": Use XDG Portals through DBus (Unix only)\n- \"zenity\": Use the Zenity program (Unix only)\n\nMore options may be added in the future.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
342 ),
343 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
344};
345pub const METADATA_SDL_HINT_DISPLAY_USABLE_BOUNDS: Hint = Hint {
346 module: "hints",
347 name: "SDL_HINT_DISPLAY_USABLE_BOUNDS",
348 short_name: "DISPLAY_USABLE_BOUNDS",
349 value: crate::hints::SDL_HINT_DISPLAY_USABLE_BOUNDS,
350 doc: Some(
351 "Override for [`SDL_GetDisplayUsableBounds()`].\n\nIf set, this hint will override the expected results for\n[`SDL_GetDisplayUsableBounds()`] for display index 0. Generally you don't want\nto do this, but this allows an embedded system to request that some of the\nscreen be reserved for other uses when paired with a well-behaved\napplication.\n\nThe contents of this hint must be 4 comma-separated integers, the first is\nthe bounds x, then y, width and height, in that order.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
352 ),
353 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
354};
355pub const METADATA_SDL_HINT_INVALID_PARAM_CHECKS: Hint = Hint {
356 module: "hints",
357 name: "SDL_HINT_INVALID_PARAM_CHECKS",
358 short_name: "INVALID_PARAM_CHECKS",
359 value: crate::hints::SDL_HINT_INVALID_PARAM_CHECKS,
360 doc: Some(
361 "Set the level of checking for invalid parameters passed to SDL functions.\n\nThe variable can be set to the following values:\n\n- \"1\": Enable fast parameter error checking, e.g. quick NULL checks, etc.\n- \"2\": Enable full parameter error checking, e.g. validating objects are\nthe correct type, etc. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
362 ),
363 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
364};
365pub const METADATA_SDL_HINT_EMSCRIPTEN_ASYNCIFY: Hint = Hint {
366 module: "hints",
367 name: "SDL_HINT_EMSCRIPTEN_ASYNCIFY",
368 short_name: "EMSCRIPTEN_ASYNCIFY",
369 value: crate::hints::SDL_HINT_EMSCRIPTEN_ASYNCIFY,
370 doc: Some(
371 "Disable giving back control to the browser automatically when running with\nasyncify.\n\nWith -s ASYNCIFY, SDL calls emscripten_sleep during operations such as\nrefreshing the screen or polling events.\n\nThis hint only applies to the emscripten platform.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable emscripten_sleep calls (if you give back browser control\nmanually or use asyncify for other purposes).\n- \"1\": Enable emscripten_sleep calls. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
372 ),
373 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
374};
375pub const METADATA_SDL_HINT_EMSCRIPTEN_CANVAS_SELECTOR: Hint = Hint {
376 module: "hints",
377 name: "SDL_HINT_EMSCRIPTEN_CANVAS_SELECTOR",
378 short_name: "EMSCRIPTEN_CANVAS_SELECTOR",
379 value: crate::hints::SDL_HINT_EMSCRIPTEN_CANVAS_SELECTOR,
380 doc: Some(
381 "Specify the CSS selector used for the \"default\" window/canvas.\n\nThis hint only applies to the emscripten platform.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
382 ),
383 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
384};
385pub const METADATA_SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT: Hint = Hint {
386 module: "hints",
387 name: "SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT",
388 short_name: "EMSCRIPTEN_KEYBOARD_ELEMENT",
389 value: crate::hints::SDL_HINT_EMSCRIPTEN_KEYBOARD_ELEMENT,
390 doc: Some(
391 "Override the binding element for keyboard inputs for Emscripten builds.\n\nThis hint only applies to the emscripten platform.\n\nThe variable can be one of:\n\n- \"#window\": the javascript window object\n- \"#document\": the javascript document object\n- \"#screen\": the javascript window.screen object\n- \"#canvas\": the WebGL canvas element\n- \"#none\": Don't bind anything at all\n- any other string without a leading # sign applies to the element on the\npage with that ID.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
392 ),
393 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
394};
395pub const METADATA_SDL_HINT_ENABLE_SCREEN_KEYBOARD: Hint = Hint {
396 module: "hints",
397 name: "SDL_HINT_ENABLE_SCREEN_KEYBOARD",
398 short_name: "ENABLE_SCREEN_KEYBOARD",
399 value: crate::hints::SDL_HINT_ENABLE_SCREEN_KEYBOARD,
400 doc: Some(
401 "A variable that controls whether the on-screen keyboard should be shown\nwhen text input is active.\n\nThe variable can be set to the following values:\n\n- \"auto\": The on-screen keyboard will be shown if there is no physical\nkeyboard attached. (default)\n- \"0\": Do not show the on-screen keyboard.\n- \"1\": Show the on-screen keyboard, if available.\n\nThis hint must be set before [`SDL_StartTextInput()`] is called\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
402 ),
403 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
404};
405pub const METADATA_SDL_HINT_EVDEV_DEVICES: Hint = Hint {
406 module: "hints",
407 name: "SDL_HINT_EVDEV_DEVICES",
408 short_name: "EVDEV_DEVICES",
409 value: crate::hints::SDL_HINT_EVDEV_DEVICES,
410 doc: Some(
411 "A variable containing a list of evdev devices to use if udev is not\navailable.\n\nThe list of devices is in the form:\n\ndeviceclass:path\\[,deviceclass:path\\[,...\\]\\]\n\nwhere device class is an integer representing the SDL_UDEV_deviceclass and\npath is the full path to the event device.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
412 ),
413 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
414};
415pub const METADATA_SDL_HINT_EVENT_LOGGING: Hint = Hint {
416 module: "hints",
417 name: "SDL_HINT_EVENT_LOGGING",
418 short_name: "EVENT_LOGGING",
419 value: crate::hints::SDL_HINT_EVENT_LOGGING,
420 doc: Some(
421 "A variable controlling verbosity of the logging of SDL events pushed onto\nthe internal queue.\n\nThe variable can be set to the following values, from least to most\nverbose:\n\n- \"0\": Don't log any events. (default)\n- \"1\": Log most events (other than the really spammy ones).\n- \"2\": Include mouse and finger motion events.\n\nThis is generally meant to be used to debug SDL itself, but can be useful\nfor application developers that need better visibility into what is going\non in the event queue. Logged events are sent through [`SDL_Log()`], which\nmeans by default they appear on stdout on most platforms or maybe\nOutputDebugString() on Windows, and can be funneled by the app with\n[`SDL_SetLogOutputFunction()`], etc.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
422 ),
423 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
424};
425pub const METADATA_SDL_HINT_FORCE_RAISEWINDOW: Hint = Hint {
426 module: "hints",
427 name: "SDL_HINT_FORCE_RAISEWINDOW",
428 short_name: "FORCE_RAISEWINDOW",
429 value: crate::hints::SDL_HINT_FORCE_RAISEWINDOW,
430 doc: Some(
431 "A variable controlling whether raising the window should be done more\nforcefully.\n\nThe variable can be set to the following values:\n\n- \"0\": Honor the OS policy for raising windows. (default)\n- \"1\": Force the window to be raised, overriding any OS policy.\n\nAt present, this is only an issue under MS Windows, which makes it nearly\nimpossible to programmatically move a window to the foreground, for\n\"security\" reasons. See <http://stackoverflow.com/a/34414846> for a\ndiscussion.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
432 ),
433 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
434};
435pub const METADATA_SDL_HINT_FRAMEBUFFER_ACCELERATION: Hint = Hint {
436 module: "hints",
437 name: "SDL_HINT_FRAMEBUFFER_ACCELERATION",
438 short_name: "FRAMEBUFFER_ACCELERATION",
439 value: crate::hints::SDL_HINT_FRAMEBUFFER_ACCELERATION,
440 doc: Some(
441 "A variable controlling how 3D acceleration is used to accelerate the SDL\nscreen surface.\n\nSDL can try to accelerate the SDL screen surface by using streaming\ntextures with a 3D rendering engine. This variable controls whether and how\nthis is done.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable 3D acceleration\n- \"1\": Enable 3D acceleration, using the default renderer. (default)\n- \"X\": Enable 3D acceleration, using X where X is one of the valid\nrendering drivers. (e.g. \"direct3d\", \"opengl\", etc.)\n\nThis hint should be set before calling [`SDL_GetWindowSurface()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
442 ),
443 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
444};
445pub const METADATA_SDL_HINT_GAMECONTROLLERCONFIG: Hint = Hint {
446 module: "hints",
447 name: "SDL_HINT_GAMECONTROLLERCONFIG",
448 short_name: "GAMECONTROLLERCONFIG",
449 value: crate::hints::SDL_HINT_GAMECONTROLLERCONFIG,
450 doc: Some(
451 "A variable that lets you manually hint extra gamecontroller db entries.\n\nThe variable should be newline delimited rows of gamecontroller config\ndata, see SDL_gamepad.h\n\nYou can update mappings after SDL is initialized with\n[`SDL_GetGamepadMappingForGUID()`] and [`SDL_AddGamepadMapping()`]\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
452 ),
453 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
454};
455pub const METADATA_SDL_HINT_GAMECONTROLLERCONFIG_FILE: Hint = Hint {
456 module: "hints",
457 name: "SDL_HINT_GAMECONTROLLERCONFIG_FILE",
458 short_name: "GAMECONTROLLERCONFIG_FILE",
459 value: crate::hints::SDL_HINT_GAMECONTROLLERCONFIG_FILE,
460 doc: Some(
461 "A variable that lets you provide a file with extra gamecontroller db\nentries.\n\nThe file should contain lines of gamecontroller config data, see\nSDL_gamepad.h\n\nYou can update mappings after SDL is initialized with\n[`SDL_GetGamepadMappingForGUID()`] and [`SDL_AddGamepadMapping()`]\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
462 ),
463 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
464};
465pub const METADATA_SDL_HINT_GAMECONTROLLERTYPE: Hint = Hint {
466 module: "hints",
467 name: "SDL_HINT_GAMECONTROLLERTYPE",
468 short_name: "GAMECONTROLLERTYPE",
469 value: crate::hints::SDL_HINT_GAMECONTROLLERTYPE,
470 doc: Some(
471 "A variable that overrides the automatic controller type detection.\n\nThe variable should be comma separated entries, in the form: VID/PID=type\n\nThe VID and PID should be hexadecimal with exactly 4 digits, e.g. 0x00fd\n\nThis hint affects what low level protocol is used with the HIDAPI driver.\n\nThe variable can be set to the following values:\n\n- \"Xbox360\"\n- \"XboxOne\"\n- \"PS3\"\n- \"PS4\"\n- \"PS5\"\n- \"SwitchPro\"\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
472 ),
473 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
474};
475pub const METADATA_SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES: Hint = Hint {
476 module: "hints",
477 name: "SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES",
478 short_name: "GAMECONTROLLER_IGNORE_DEVICES",
479 value: crate::hints::SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES,
480 doc: Some(
481 "A variable containing a list of devices to skip when scanning for game\ncontrollers.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n0xAAAA/0xBBBB,0xCCCC/0xDDDD\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
482 ),
483 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
484};
485pub const METADATA_SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT: Hint = Hint {
486 module: "hints",
487 name: "SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT",
488 short_name: "GAMECONTROLLER_IGNORE_DEVICES_EXCEPT",
489 value: crate::hints::SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT,
490 doc: Some(
491 "If set, all devices will be skipped when scanning for game controllers\nexcept for the ones listed in this variable.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n0xAAAA/0xBBBB,0xCCCC/0xDDDD\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
492 ),
493 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
494};
495pub const METADATA_SDL_HINT_GAMECONTROLLER_SENSOR_FUSION: Hint = Hint {
496 module: "hints",
497 name: "SDL_HINT_GAMECONTROLLER_SENSOR_FUSION",
498 short_name: "GAMECONTROLLER_SENSOR_FUSION",
499 value: crate::hints::SDL_HINT_GAMECONTROLLER_SENSOR_FUSION,
500 doc: Some(
501 "A variable that controls whether the device's built-in accelerometer and\ngyro should be used as sensors for gamepads.\n\nThe variable can be set to the following values:\n\n- \"0\": Sensor fusion is disabled\n- \"1\": Sensor fusion is enabled for all controllers that lack sensors\n\nOr the variable can be a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n0xAAAA/0xBBBB,0xCCCC/0xDDDD\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint should be set before a gamepad is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
502 ),
503 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
504};
505pub const METADATA_SDL_HINT_GDK_TEXTINPUT_DEFAULT_TEXT: Hint = Hint {
506 module: "hints",
507 name: "SDL_HINT_GDK_TEXTINPUT_DEFAULT_TEXT",
508 short_name: "GDK_TEXTINPUT_DEFAULT_TEXT",
509 value: crate::hints::SDL_HINT_GDK_TEXTINPUT_DEFAULT_TEXT,
510 doc: Some(
511 "This variable sets the default text of the TextInput window on GDK\nplatforms.\n\nThis hint is available only if SDL_GDK_TEXTINPUT defined.\n\nThis hint should be set before calling [`SDL_StartTextInput()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
512 ),
513 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
514};
515pub const METADATA_SDL_HINT_GDK_TEXTINPUT_DESCRIPTION: Hint = Hint {
516 module: "hints",
517 name: "SDL_HINT_GDK_TEXTINPUT_DESCRIPTION",
518 short_name: "GDK_TEXTINPUT_DESCRIPTION",
519 value: crate::hints::SDL_HINT_GDK_TEXTINPUT_DESCRIPTION,
520 doc: Some(
521 "This variable sets the description of the TextInput window on GDK\nplatforms.\n\nThis hint is available only if SDL_GDK_TEXTINPUT defined.\n\nThis hint should be set before calling [`SDL_StartTextInput()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
522 ),
523 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
524};
525pub const METADATA_SDL_HINT_GDK_TEXTINPUT_MAX_LENGTH: Hint = Hint {
526 module: "hints",
527 name: "SDL_HINT_GDK_TEXTINPUT_MAX_LENGTH",
528 short_name: "GDK_TEXTINPUT_MAX_LENGTH",
529 value: crate::hints::SDL_HINT_GDK_TEXTINPUT_MAX_LENGTH,
530 doc: Some(
531 "This variable sets the maximum input length of the TextInput window on GDK\nplatforms.\n\nThe value must be a stringified integer, for example \"10\" to allow for up\nto 10 characters of text input.\n\nThis hint is available only if SDL_GDK_TEXTINPUT defined.\n\nThis hint should be set before calling [`SDL_StartTextInput()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
532 ),
533 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
534};
535pub const METADATA_SDL_HINT_GDK_TEXTINPUT_SCOPE: Hint = Hint {
536 module: "hints",
537 name: "SDL_HINT_GDK_TEXTINPUT_SCOPE",
538 short_name: "GDK_TEXTINPUT_SCOPE",
539 value: crate::hints::SDL_HINT_GDK_TEXTINPUT_SCOPE,
540 doc: Some(
541 "This variable sets the input scope of the TextInput window on GDK\nplatforms.\n\nSet this hint to change the XGameUiTextEntryInputScope value that will be\npassed to the window creation function. The value must be a stringified\ninteger, for example \"0\" for XGameUiTextEntryInputScope::Default.\n\nThis hint is available only if SDL_GDK_TEXTINPUT defined.\n\nThis hint should be set before calling [`SDL_StartTextInput()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
542 ),
543 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
544};
545pub const METADATA_SDL_HINT_GDK_TEXTINPUT_TITLE: Hint = Hint {
546 module: "hints",
547 name: "SDL_HINT_GDK_TEXTINPUT_TITLE",
548 short_name: "GDK_TEXTINPUT_TITLE",
549 value: crate::hints::SDL_HINT_GDK_TEXTINPUT_TITLE,
550 doc: Some(
551 "This variable sets the title of the TextInput window on GDK platforms.\n\nThis hint is available only if SDL_GDK_TEXTINPUT defined.\n\nThis hint should be set before calling [`SDL_StartTextInput()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
552 ),
553 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
554};
555pub const METADATA_SDL_HINT_HIDAPI_LIBUSB: Hint = Hint {
556 module: "hints",
557 name: "SDL_HINT_HIDAPI_LIBUSB",
558 short_name: "HIDAPI_LIBUSB",
559 value: crate::hints::SDL_HINT_HIDAPI_LIBUSB,
560 doc: Some(
561 "A variable to control whether HIDAPI uses libusb for device access.\n\nBy default libusb will only be used for a few devices that require direct\nUSB access, and this can be controlled with\n[`SDL_HINT_HIDAPI_LIBUSB_WHITELIST`].\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI will not use libusb for device access.\n- \"1\": HIDAPI will use libusb for device access if available. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
562 ),
563 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
564};
565pub const METADATA_SDL_HINT_HIDAPI_LIBUSB_GAMECUBE: Hint = Hint {
566 module: "hints",
567 name: "SDL_HINT_HIDAPI_LIBUSB_GAMECUBE",
568 short_name: "HIDAPI_LIBUSB_GAMECUBE",
569 value: crate::hints::SDL_HINT_HIDAPI_LIBUSB_GAMECUBE,
570 doc: Some(
571 "A variable to control whether HIDAPI uses libusb for GameCube adapters.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI will not use libusb for GameCube adapters.\n- \"1\": HIDAPI will use libusb for GameCube adapters if available. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
572 ),
573 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
574};
575pub const METADATA_SDL_HINT_HIDAPI_LIBUSB_WHITELIST: Hint = Hint {
576 module: "hints",
577 name: "SDL_HINT_HIDAPI_LIBUSB_WHITELIST",
578 short_name: "HIDAPI_LIBUSB_WHITELIST",
579 value: crate::hints::SDL_HINT_HIDAPI_LIBUSB_WHITELIST,
580 doc: Some(
581 "A variable to control whether HIDAPI uses libusb only for whitelisted\ndevices.\n\nBy default libusb will only be used for a few devices that require direct\nUSB access.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI will use libusb for all device access.\n- \"1\": HIDAPI will use libusb only for whitelisted devices. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
582 ),
583 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
584};
585pub const METADATA_SDL_HINT_HIDAPI_UDEV: Hint = Hint {
586 module: "hints",
587 name: "SDL_HINT_HIDAPI_UDEV",
588 short_name: "HIDAPI_UDEV",
589 value: crate::hints::SDL_HINT_HIDAPI_UDEV,
590 doc: Some(
591 "A variable to control whether HIDAPI uses udev for device detection.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI will poll for device changes.\n- \"1\": HIDAPI will use udev for device detection. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
592 ),
593 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
594};
595pub const METADATA_SDL_HINT_GPU_DRIVER: Hint = Hint {
596 module: "hints",
597 name: "SDL_HINT_GPU_DRIVER",
598 short_name: "GPU_DRIVER",
599 value: crate::hints::SDL_HINT_GPU_DRIVER,
600 doc: Some(
601 "A variable that specifies a GPU backend to use.\n\nBy default, SDL will try all available GPU backends in a reasonable order\nuntil it finds one that can work, but this hint allows the app or user to\nforce a specific target, such as \"direct3d12\" if, say, your hardware\nsupports Vulkan but you want to try using D3D12 instead.\n\nThis hint should be set before any GPU functions are called.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
602 ),
603 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
604};
605pub const METADATA_SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS: Hint = Hint {
606 module: "hints",
607 name: "SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS",
608 short_name: "HIDAPI_ENUMERATE_ONLY_CONTROLLERS",
609 value: crate::hints::SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS,
610 doc: Some(
611 "A variable to control whether [`SDL_hid_enumerate()`] enumerates all HID\ndevices or only controllers.\n\nThe variable can be set to the following values:\n\n- \"0\": [`SDL_hid_enumerate()`] will enumerate all HID devices.\n- \"1\": [`SDL_hid_enumerate()`] will only enumerate controllers. (default)\n\nBy default SDL will only enumerate controllers, to reduce risk of hanging\nor crashing on devices with bad drivers and avoiding macOS keyboard capture\npermission prompts.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
612 ),
613 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
614};
615pub const METADATA_SDL_HINT_HIDAPI_IGNORE_DEVICES: Hint = Hint {
616 module: "hints",
617 name: "SDL_HINT_HIDAPI_IGNORE_DEVICES",
618 short_name: "HIDAPI_IGNORE_DEVICES",
619 value: crate::hints::SDL_HINT_HIDAPI_IGNORE_DEVICES,
620 doc: Some(
621 "A variable containing a list of devices to ignore in [`SDL_hid_enumerate()`].\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nFor example, to ignore the Shanwan DS3 controller and any Valve controller,\nyou might use the string \"0x2563/0x0523,0x28de/0x0000\"\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
622 ),
623 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
624};
625pub const METADATA_SDL_HINT_IME_IMPLEMENTED_UI: Hint = Hint {
626 module: "hints",
627 name: "SDL_HINT_IME_IMPLEMENTED_UI",
628 short_name: "IME_IMPLEMENTED_UI",
629 value: crate::hints::SDL_HINT_IME_IMPLEMENTED_UI,
630 doc: Some(
631 "A variable describing what IME UI elements the application can display.\n\nBy default IME UI is handled using native components by the OS where\npossible, however this can interfere with or not be visible when exclusive\nfullscreen mode is used.\n\nThe variable can be set to a comma separated list containing the following\nitems:\n\n- \"none\" or \"0\": The application can't render any IME elements, and native\nUI should be used. (default)\n- \"composition\": The application handles [`SDL_EVENT_TEXT_EDITING`] events and\ncan render the composition text.\n- \"candidates\": The application handles [`SDL_EVENT_TEXT_EDITING_CANDIDATES`]\nand can render the candidate list.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
632 ),
633 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
634};
635pub const METADATA_SDL_HINT_IOS_HIDE_HOME_INDICATOR: Hint = Hint {
636 module: "hints",
637 name: "SDL_HINT_IOS_HIDE_HOME_INDICATOR",
638 short_name: "IOS_HIDE_HOME_INDICATOR",
639 value: crate::hints::SDL_HINT_IOS_HIDE_HOME_INDICATOR,
640 doc: Some(
641 "A variable controlling whether the home indicator bar on iPhone X and later\nshould be hidden.\n\nThe variable can be set to the following values:\n\n- \"0\": The indicator bar is not hidden. (default for windowed applications)\n- \"1\": The indicator bar is hidden and is shown when the screen is touched\n(useful for movie playback applications).\n- \"2\": The indicator bar is dim and the first swipe makes it visible and\nthe second swipe performs the \"home\" action. (default for fullscreen\napplications)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
642 ),
643 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
644};
645pub const METADATA_SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS: Hint = Hint {
646 module: "hints",
647 name: "SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS",
648 short_name: "JOYSTICK_ALLOW_BACKGROUND_EVENTS",
649 value: crate::hints::SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS,
650 doc: Some(
651 "A variable that lets you enable joystick (and gamecontroller) events even\nwhen your app is in the background.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable joystick & gamecontroller input events when the application\nis in the background. (default)\n- \"1\": Enable joystick & gamecontroller input events when the application\nis in the background.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
652 ),
653 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
654};
655pub const METADATA_SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES: Hint = Hint {
656 module: "hints",
657 name: "SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES",
658 short_name: "JOYSTICK_ARCADESTICK_DEVICES",
659 value: crate::hints::SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES,
660 doc: Some(
661 "A variable containing a list of arcade stick style controllers.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
662 ),
663 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
664};
665pub const METADATA_SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES_EXCLUDED: Hint = Hint {
666 module: "hints",
667 name: "SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES_EXCLUDED",
668 short_name: "JOYSTICK_ARCADESTICK_DEVICES_EXCLUDED",
669 value: crate::hints::SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES_EXCLUDED,
670 doc: Some(
671 "A variable containing a list of devices that are not arcade stick style\ncontrollers.\n\nThis will override [`SDL_HINT_JOYSTICK_ARCADESTICK_DEVICES`] and the built in\ndevice list.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
672 ),
673 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
674};
675pub const METADATA_SDL_HINT_JOYSTICK_BLACKLIST_DEVICES: Hint = Hint {
676 module: "hints",
677 name: "SDL_HINT_JOYSTICK_BLACKLIST_DEVICES",
678 short_name: "JOYSTICK_BLACKLIST_DEVICES",
679 value: crate::hints::SDL_HINT_JOYSTICK_BLACKLIST_DEVICES,
680 doc: Some(
681 "A variable containing a list of devices that should not be considered\njoysticks.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
682 ),
683 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
684};
685pub const METADATA_SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED: Hint = Hint {
686 module: "hints",
687 name: "SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED",
688 short_name: "JOYSTICK_BLACKLIST_DEVICES_EXCLUDED",
689 value: crate::hints::SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED,
690 doc: Some(
691 "A variable containing a list of devices that should be considered\njoysticks.\n\nThis will override [`SDL_HINT_JOYSTICK_BLACKLIST_DEVICES`] and the built in\ndevice list.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
692 ),
693 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
694};
695pub const METADATA_SDL_HINT_JOYSTICK_DEVICE: Hint = Hint {
696 module: "hints",
697 name: "SDL_HINT_JOYSTICK_DEVICE",
698 short_name: "JOYSTICK_DEVICE",
699 value: crate::hints::SDL_HINT_JOYSTICK_DEVICE,
700 doc: Some(
701 "A variable containing a comma separated list of devices to open as\njoysticks.\n\nThis variable is currently only used by the Linux joystick driver.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
702 ),
703 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
704};
705pub const METADATA_SDL_HINT_JOYSTICK_ENHANCED_REPORTS: Hint = Hint {
706 module: "hints",
707 name: "SDL_HINT_JOYSTICK_ENHANCED_REPORTS",
708 short_name: "JOYSTICK_ENHANCED_REPORTS",
709 value: crate::hints::SDL_HINT_JOYSTICK_ENHANCED_REPORTS,
710 doc: Some(
711 "A variable controlling whether enhanced reports should be used for\ncontrollers when using the HIDAPI driver.\n\nEnhanced reports allow rumble and effects on Bluetooth PlayStation\ncontrollers and gyro on Nintendo Switch controllers, but break Windows\nDirectInput for other applications that don't use SDL.\n\nOnce enhanced reports are enabled, they can't be disabled on PlayStation\ncontrollers without power cycling the controller.\n\nThe variable can be set to the following values:\n\n- \"0\": enhanced reports are not enabled.\n- \"1\": enhanced reports are enabled. (default)\n- \"auto\": enhanced features are advertised to the application, but SDL\ndoesn't change the controller report mode unless the application uses\nthem.\n\nThis hint can be enabled anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
712 ),
713 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
714};
715pub const METADATA_SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES: Hint = Hint {
716 module: "hints",
717 name: "SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES",
718 short_name: "JOYSTICK_FLIGHTSTICK_DEVICES",
719 value: crate::hints::SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES,
720 doc: Some(
721 "A variable containing a list of flightstick style controllers.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of @file, in which case the named file\nwill be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
722 ),
723 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
724};
725pub const METADATA_SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES_EXCLUDED: Hint = Hint {
726 module: "hints",
727 name: "SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES_EXCLUDED",
728 short_name: "JOYSTICK_FLIGHTSTICK_DEVICES_EXCLUDED",
729 value: crate::hints::SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES_EXCLUDED,
730 doc: Some(
731 "A variable containing a list of devices that are not flightstick style\ncontrollers.\n\nThis will override [`SDL_HINT_JOYSTICK_FLIGHTSTICK_DEVICES`] and the built in\ndevice list.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
732 ),
733 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
734};
735pub const METADATA_SDL_HINT_JOYSTICK_GAMEINPUT: Hint = Hint {
736 module: "hints",
737 name: "SDL_HINT_JOYSTICK_GAMEINPUT",
738 short_name: "JOYSTICK_GAMEINPUT",
739 value: crate::hints::SDL_HINT_JOYSTICK_GAMEINPUT,
740 doc: Some(
741 "A variable controlling whether GameInput should be used for controller\nhandling on Windows.\n\nThe variable can be set to the following values:\n\n- \"0\": GameInput is not used.\n- \"1\": GameInput is used.\n\nThe default is \"1\" on GDK platforms, and \"0\" otherwise.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
742 ),
743 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
744};
745pub const METADATA_SDL_HINT_JOYSTICK_GAMECUBE_DEVICES: Hint = Hint {
746 module: "hints",
747 name: "SDL_HINT_JOYSTICK_GAMECUBE_DEVICES",
748 short_name: "JOYSTICK_GAMECUBE_DEVICES",
749 value: crate::hints::SDL_HINT_JOYSTICK_GAMECUBE_DEVICES,
750 doc: Some(
751 "A variable containing a list of devices known to have a GameCube form\nfactor.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
752 ),
753 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
754};
755pub const METADATA_SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED: Hint = Hint {
756 module: "hints",
757 name: "SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED",
758 short_name: "JOYSTICK_GAMECUBE_DEVICES_EXCLUDED",
759 value: crate::hints::SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED,
760 doc: Some(
761 "A variable containing a list of devices known not to have a GameCube form\nfactor.\n\nThis will override [`SDL_HINT_JOYSTICK_GAMECUBE_DEVICES`] and the built in\ndevice list.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
762 ),
763 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
764};
765pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI: Hint = Hint {
766 module: "hints",
767 name: "SDL_HINT_JOYSTICK_HIDAPI",
768 short_name: "JOYSTICK_HIDAPI",
769 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI,
770 doc: Some(
771 "A variable controlling whether the HIDAPI joystick drivers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI drivers are not used.\n- \"1\": HIDAPI drivers are used. (default)\n\nThis variable is the default for all drivers, but can be overridden by the\nhints for specific drivers below.\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
772 ),
773 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
774};
775pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_COMBINE_JOY_CONS: Hint = Hint {
776 module: "hints",
777 name: "SDL_HINT_JOYSTICK_HIDAPI_COMBINE_JOY_CONS",
778 short_name: "JOYSTICK_HIDAPI_COMBINE_JOY_CONS",
779 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_COMBINE_JOY_CONS,
780 doc: Some(
781 "A variable controlling whether Nintendo Switch Joy-Con controllers will be\ncombined into a single Pro-like controller when using the HIDAPI driver.\n\nThe variable can be set to the following values:\n\n- \"0\": Left and right Joy-Con controllers will not be combined and each\nwill be a mini-gamepad.\n- \"1\": Left and right Joy-Con controllers will be combined into a single\ncontroller. (default)\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
782 ),
783 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
784};
785pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE: Hint = Hint {
786 module: "hints",
787 name: "SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE",
788 short_name: "JOYSTICK_HIDAPI_GAMECUBE",
789 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE,
790 doc: Some(
791 "A variable controlling whether the HIDAPI driver for Nintendo GameCube\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
792 ),
793 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
794};
795pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE: Hint = Hint {
796 module: "hints",
797 name: "SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE",
798 short_name: "JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE",
799 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE_RUMBLE_BRAKE,
800 doc: Some(
801 "A variable controlling whether rumble is used to implement the GameCube\ncontroller's 3 rumble modes, Stop(0), Rumble(1), and StopHard(2).\n\nThis is useful for applications that need full compatibility for things\nlike ADSR envelopes. - Stop is implemented by setting low_frequency_rumble\nto 0 and high_frequency_rumble >0 - Rumble is both at any arbitrary value -\nStopHard is implemented by setting both low_frequency_rumble and\nhigh_frequency_rumble to 0\n\nThe variable can be set to the following values:\n\n- \"0\": Normal rumble behavior is behavior is used. (default)\n- \"1\": Proper GameCube controller rumble behavior is used.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
802 ),
803 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
804};
805pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_JOY_CONS: Hint = Hint {
806 module: "hints",
807 name: "SDL_HINT_JOYSTICK_HIDAPI_JOY_CONS",
808 short_name: "JOYSTICK_HIDAPI_JOY_CONS",
809 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_JOY_CONS,
810 doc: Some(
811 "A variable controlling whether the HIDAPI driver for Nintendo Switch\nJoy-Cons should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
812 ),
813 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
814};
815pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_JOYCON_HOME_LED: Hint = Hint {
816 module: "hints",
817 name: "SDL_HINT_JOYSTICK_HIDAPI_JOYCON_HOME_LED",
818 short_name: "JOYSTICK_HIDAPI_JOYCON_HOME_LED",
819 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_JOYCON_HOME_LED,
820 doc: Some(
821 "A variable controlling whether the Home button LED should be turned on when\na Nintendo Switch Joy-Con controller is opened.\n\nThe variable can be set to the following values:\n\n- \"0\": home button LED is turned off\n- \"1\": home button LED is turned on\n\nBy default the Home button LED state is not changed. This hint can also be\nset to a floating point value between 0.0 and 1.0 which controls the\nbrightness of the Home button LED.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
822 ),
823 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
824};
825pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_LUNA: Hint = Hint {
826 module: "hints",
827 name: "SDL_HINT_JOYSTICK_HIDAPI_LUNA",
828 short_name: "JOYSTICK_HIDAPI_LUNA",
829 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_LUNA,
830 doc: Some(
831 "A variable controlling whether the HIDAPI driver for Amazon Luna\ncontrollers connected via Bluetooth should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
832 ),
833 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
834};
835pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_NINTENDO_CLASSIC: Hint = Hint {
836 module: "hints",
837 name: "SDL_HINT_JOYSTICK_HIDAPI_NINTENDO_CLASSIC",
838 short_name: "JOYSTICK_HIDAPI_NINTENDO_CLASSIC",
839 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_NINTENDO_CLASSIC,
840 doc: Some(
841 "A variable controlling whether the HIDAPI driver for Nintendo Online\nclassic controllers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
842 ),
843 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
844};
845pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_PS3: Hint = Hint {
846 module: "hints",
847 name: "SDL_HINT_JOYSTICK_HIDAPI_PS3",
848 short_name: "JOYSTICK_HIDAPI_PS3",
849 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_PS3,
850 doc: Some(
851 "A variable controlling whether the HIDAPI driver for PS3 controllers should\nbe used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`] on macOS, and \"0\" on\nother platforms.\n\nFor official Sony driver (sixaxis.sys) use\n[`SDL_HINT_JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER`]. See\n<https://github.com/ViGEm/DsHidMini> for an alternative driver on Windows.\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
852 ),
853 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
854};
855pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER: Hint = Hint {
856 module: "hints",
857 name: "SDL_HINT_JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER",
858 short_name: "JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER",
859 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_PS3_SIXAXIS_DRIVER,
860 doc: Some(
861 "A variable controlling whether the Sony driver (sixaxis.sys) for PS3\ncontrollers (Sixaxis/DualShock 3) should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": Sony driver (sixaxis.sys) is not used.\n- \"1\": Sony driver (sixaxis.sys) is used.\n\nThe default value is 0.\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
862 ),
863 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
864};
865pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_PS4: Hint = Hint {
866 module: "hints",
867 name: "SDL_HINT_JOYSTICK_HIDAPI_PS4",
868 short_name: "JOYSTICK_HIDAPI_PS4",
869 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_PS4,
870 doc: Some(
871 "A variable controlling whether the HIDAPI driver for PS4 controllers should\nbe used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
872 ),
873 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
874};
875pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_PS4_REPORT_INTERVAL: Hint = Hint {
876 module: "hints",
877 name: "SDL_HINT_JOYSTICK_HIDAPI_PS4_REPORT_INTERVAL",
878 short_name: "JOYSTICK_HIDAPI_PS4_REPORT_INTERVAL",
879 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_PS4_REPORT_INTERVAL,
880 doc: Some(
881 "A variable controlling the update rate of the PS4 controller over Bluetooth\nwhen using the HIDAPI driver.\n\nThis defaults to 4 ms, to match the behavior over USB, and to be more\nfriendly to other Bluetooth devices and older Bluetooth hardware on the\ncomputer. It can be set to \"1\" (1000Hz), \"2\" (500Hz) and \"4\" (250Hz)\n\nThis hint can be set anytime, but only takes effect when extended input\nreports are enabled.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
882 ),
883 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
884};
885pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_PS5: Hint = Hint {
886 module: "hints",
887 name: "SDL_HINT_JOYSTICK_HIDAPI_PS5",
888 short_name: "JOYSTICK_HIDAPI_PS5",
889 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_PS5,
890 doc: Some(
891 "A variable controlling whether the HIDAPI driver for PS5 controllers should\nbe used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
892 ),
893 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
894};
895pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_PS5_PLAYER_LED: Hint = Hint {
896 module: "hints",
897 name: "SDL_HINT_JOYSTICK_HIDAPI_PS5_PLAYER_LED",
898 short_name: "JOYSTICK_HIDAPI_PS5_PLAYER_LED",
899 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_PS5_PLAYER_LED,
900 doc: Some(
901 "A variable controlling whether the player LEDs should be lit to indicate\nwhich player is associated with a PS5 controller.\n\nThe variable can be set to the following values:\n\n- \"0\": player LEDs are not enabled.\n- \"1\": player LEDs are enabled. (default)\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
902 ),
903 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
904};
905pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_SHIELD: Hint = Hint {
906 module: "hints",
907 name: "SDL_HINT_JOYSTICK_HIDAPI_SHIELD",
908 short_name: "JOYSTICK_HIDAPI_SHIELD",
909 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_SHIELD,
910 doc: Some(
911 "A variable controlling whether the HIDAPI driver for NVIDIA SHIELD\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
912 ),
913 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
914};
915pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_STADIA: Hint = Hint {
916 module: "hints",
917 name: "SDL_HINT_JOYSTICK_HIDAPI_STADIA",
918 short_name: "JOYSTICK_HIDAPI_STADIA",
919 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_STADIA,
920 doc: Some(
921 "A variable controlling whether the HIDAPI driver for Google Stadia\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
922 ),
923 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
924};
925pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_STEAM: Hint = Hint {
926 module: "hints",
927 name: "SDL_HINT_JOYSTICK_HIDAPI_STEAM",
928 short_name: "JOYSTICK_HIDAPI_STEAM",
929 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_STEAM,
930 doc: Some(
931 "A variable controlling whether the HIDAPI driver for Bluetooth Steam\nControllers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used. (default)\n- \"1\": HIDAPI driver is used for Steam Controllers, which requires\nBluetooth access and may prompt the user for permission on iOS and\nAndroid.\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
932 ),
933 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
934};
935pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_STEAM_HOME_LED: Hint = Hint {
936 module: "hints",
937 name: "SDL_HINT_JOYSTICK_HIDAPI_STEAM_HOME_LED",
938 short_name: "JOYSTICK_HIDAPI_STEAM_HOME_LED",
939 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_STEAM_HOME_LED,
940 doc: Some(
941 "A variable controlling whether the Steam button LED should be turned on\nwhen a Steam controller is opened.\n\nThe variable can be set to the following values:\n\n- \"0\": Steam button LED is turned off.\n- \"1\": Steam button LED is turned on.\n\nBy default the Steam button LED state is not changed. This hint can also be\nset to a floating point value between 0.0 and 1.0 which controls the\nbrightness of the Steam button LED.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
942 ),
943 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
944};
945pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_STEAMDECK: Hint = Hint {
946 module: "hints",
947 name: "SDL_HINT_JOYSTICK_HIDAPI_STEAMDECK",
948 short_name: "JOYSTICK_HIDAPI_STEAMDECK",
949 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_STEAMDECK,
950 doc: Some(
951 "A variable controlling whether the HIDAPI driver for the Steam Deck builtin\ncontroller should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
952 ),
953 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
954};
955pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_STEAM_HORI: Hint = Hint {
956 module: "hints",
957 name: "SDL_HINT_JOYSTICK_HIDAPI_STEAM_HORI",
958 short_name: "JOYSTICK_HIDAPI_STEAM_HORI",
959 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_STEAM_HORI,
960 doc: Some(
961 "A variable controlling whether the HIDAPI driver for HORI licensed Steam\ncontrollers should be used.\n\nThis variable can be set to the following values: \"0\" - HIDAPI driver is\nnot used \"1\" - HIDAPI driver is used\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n",
962 ),
963 available_since: None,
964};
965pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_LG4FF: Hint = Hint {
966 module: "hints",
967 name: "SDL_HINT_JOYSTICK_HIDAPI_LG4FF",
968 short_name: "JOYSTICK_HIDAPI_LG4FF",
969 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_LG4FF,
970 doc: Some(
971 "A variable controlling whether the HIDAPI driver for some Logitech wheels\nshould be used.\n\nThis variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used\n- \"1\": HIDAPI driver is used\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n",
972 ),
973 available_since: None,
974};
975pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_8BITDO: Hint = Hint {
976 module: "hints",
977 name: "SDL_HINT_JOYSTICK_HIDAPI_8BITDO",
978 short_name: "JOYSTICK_HIDAPI_8BITDO",
979 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_8BITDO,
980 doc: Some(
981 "A variable controlling whether the HIDAPI driver for 8BitDo controllers\nshould be used.\n\nThis variable can be set to the following values:\n\n\"0\" - HIDAPI driver is not used. \"1\" - HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n",
982 ),
983 available_since: None,
984};
985pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_SINPUT: Hint = Hint {
986 module: "hints",
987 name: "SDL_HINT_JOYSTICK_HIDAPI_SINPUT",
988 short_name: "JOYSTICK_HIDAPI_SINPUT",
989 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_SINPUT,
990 doc: Some(
991 "A variable controlling whether the HIDAPI driver for SInput controllers\nshould be used.\n\nMore info - <https://github.com/HandHeldLegend/SInput-HID>\n\nThis variable can be set to the following values:\n\n\"0\" - HIDAPI driver is not used. \"1\" - HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n",
992 ),
993 available_since: None,
994};
995pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_ZUIKI: Hint = Hint {
996 module: "hints",
997 name: "SDL_HINT_JOYSTICK_HIDAPI_ZUIKI",
998 short_name: "JOYSTICK_HIDAPI_ZUIKI",
999 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_ZUIKI,
1000 doc: Some(
1001 "A variable controlling whether the HIDAPI driver for ZUIKI controllers\nshould be used.\n\nThis variable can be set to the following values:\n\n\"0\" - HIDAPI driver is not used. \"1\" - HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n",
1002 ),
1003 available_since: None,
1004};
1005pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_FLYDIGI: Hint = Hint {
1006 module: "hints",
1007 name: "SDL_HINT_JOYSTICK_HIDAPI_FLYDIGI",
1008 short_name: "JOYSTICK_HIDAPI_FLYDIGI",
1009 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_FLYDIGI,
1010 doc: Some(
1011 "A variable controlling whether the HIDAPI driver for Flydigi controllers\nshould be used.\n\nThis variable can be set to the following values:\n\n\"0\" - HIDAPI driver is not used. \"1\" - HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`]\n",
1012 ),
1013 available_since: None,
1014};
1015pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_SWITCH: Hint = Hint {
1016 module: "hints",
1017 name: "SDL_HINT_JOYSTICK_HIDAPI_SWITCH",
1018 short_name: "JOYSTICK_HIDAPI_SWITCH",
1019 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_SWITCH,
1020 doc: Some(
1021 "A variable controlling whether the HIDAPI driver for Nintendo Switch\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1022 ),
1023 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1024};
1025pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_SWITCH_HOME_LED: Hint = Hint {
1026 module: "hints",
1027 name: "SDL_HINT_JOYSTICK_HIDAPI_SWITCH_HOME_LED",
1028 short_name: "JOYSTICK_HIDAPI_SWITCH_HOME_LED",
1029 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_SWITCH_HOME_LED,
1030 doc: Some(
1031 "A variable controlling whether the Home button LED should be turned on when\na Nintendo Switch Pro controller is opened.\n\nThe variable can be set to the following values:\n\n- \"0\": Home button LED is turned off.\n- \"1\": Home button LED is turned on.\n\nBy default the Home button LED state is not changed. This hint can also be\nset to a floating point value between 0.0 and 1.0 which controls the\nbrightness of the Home button LED.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1032 ),
1033 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1034};
1035pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_SWITCH_PLAYER_LED: Hint = Hint {
1036 module: "hints",
1037 name: "SDL_HINT_JOYSTICK_HIDAPI_SWITCH_PLAYER_LED",
1038 short_name: "JOYSTICK_HIDAPI_SWITCH_PLAYER_LED",
1039 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_SWITCH_PLAYER_LED,
1040 doc: Some(
1041 "A variable controlling whether the player LEDs should be lit to indicate\nwhich player is associated with a Nintendo Switch controller.\n\nThe variable can be set to the following values:\n\n- \"0\": Player LEDs are not enabled.\n- \"1\": Player LEDs are enabled. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1042 ),
1043 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1044};
1045pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_SWITCH2: Hint = Hint {
1046 module: "hints",
1047 name: "SDL_HINT_JOYSTICK_HIDAPI_SWITCH2",
1048 short_name: "JOYSTICK_HIDAPI_SWITCH2",
1049 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_SWITCH2,
1050 doc: Some(
1051 "A variable controlling whether the HIDAPI driver for Nintendo Switch 2\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1052 ),
1053 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1054};
1055pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_VERTICAL_JOY_CONS: Hint = Hint {
1056 module: "hints",
1057 name: "SDL_HINT_JOYSTICK_HIDAPI_VERTICAL_JOY_CONS",
1058 short_name: "JOYSTICK_HIDAPI_VERTICAL_JOY_CONS",
1059 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_VERTICAL_JOY_CONS,
1060 doc: Some(
1061 "A variable controlling whether Nintendo Switch Joy-Con controllers will be\nin vertical mode when using the HIDAPI driver.\n\nThe variable can be set to the following values:\n\n- \"0\": Left and right Joy-Con controllers will not be in vertical mode.\n(default)\n- \"1\": Left and right Joy-Con controllers will be in vertical mode.\n\nThis hint should be set before opening a Joy-Con controller.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1062 ),
1063 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1064};
1065pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_WII: Hint = Hint {
1066 module: "hints",
1067 name: "SDL_HINT_JOYSTICK_HIDAPI_WII",
1068 short_name: "JOYSTICK_HIDAPI_WII",
1069 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_WII,
1070 doc: Some(
1071 "A variable controlling whether the HIDAPI driver for Nintendo Wii and Wii U\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThis driver doesn't work with the dolphinbar, so the default is false for\nnow.\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1072 ),
1073 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1074};
1075pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_WII_PLAYER_LED: Hint = Hint {
1076 module: "hints",
1077 name: "SDL_HINT_JOYSTICK_HIDAPI_WII_PLAYER_LED",
1078 short_name: "JOYSTICK_HIDAPI_WII_PLAYER_LED",
1079 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_WII_PLAYER_LED,
1080 doc: Some(
1081 "A variable controlling whether the player LEDs should be lit to indicate\nwhich player is associated with a Wii controller.\n\nThe variable can be set to the following values:\n\n- \"0\": Player LEDs are not enabled.\n- \"1\": Player LEDs are enabled. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1082 ),
1083 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1084};
1085pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_XBOX: Hint = Hint {
1086 module: "hints",
1087 name: "SDL_HINT_JOYSTICK_HIDAPI_XBOX",
1088 short_name: "JOYSTICK_HIDAPI_XBOX",
1089 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_XBOX,
1090 doc: Some(
1091 "A variable controlling whether the HIDAPI driver for XBox controllers\nshould be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is \"0\" on Windows, otherwise the value of\n[`SDL_HINT_JOYSTICK_HIDAPI`]\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1092 ),
1093 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1094};
1095pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_XBOX_360: Hint = Hint {
1096 module: "hints",
1097 name: "SDL_HINT_JOYSTICK_HIDAPI_XBOX_360",
1098 short_name: "JOYSTICK_HIDAPI_XBOX_360",
1099 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_XBOX_360,
1100 doc: Some(
1101 "A variable controlling whether the HIDAPI driver for XBox 360 controllers\nshould be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI_XBOX`]\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1102 ),
1103 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1104};
1105pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED: Hint = Hint {
1106 module: "hints",
1107 name: "SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED",
1108 short_name: "JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED",
1109 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED,
1110 doc: Some(
1111 "A variable controlling whether the player LEDs should be lit to indicate\nwhich player is associated with an Xbox 360 controller.\n\nThe variable can be set to the following values:\n\n- \"0\": Player LEDs are not enabled.\n- \"1\": Player LEDs are enabled. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1112 ),
1113 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1114};
1115pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS: Hint = Hint {
1116 module: "hints",
1117 name: "SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS",
1118 short_name: "JOYSTICK_HIDAPI_XBOX_360_WIRELESS",
1119 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS,
1120 doc: Some(
1121 "A variable controlling whether the HIDAPI driver for XBox 360 wireless\ncontrollers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI_XBOX_360`]\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1122 ),
1123 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1124};
1125pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE: Hint = Hint {
1126 module: "hints",
1127 name: "SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE",
1128 short_name: "JOYSTICK_HIDAPI_XBOX_ONE",
1129 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE,
1130 doc: Some(
1131 "A variable controlling whether the HIDAPI driver for XBox One controllers\nshould be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI_XBOX`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1132 ),
1133 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1134};
1135pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE_HOME_LED: Hint = Hint {
1136 module: "hints",
1137 name: "SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE_HOME_LED",
1138 short_name: "JOYSTICK_HIDAPI_XBOX_ONE_HOME_LED",
1139 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE_HOME_LED,
1140 doc: Some(
1141 "A variable controlling whether the Home button LED should be turned on when\nan Xbox One controller is opened.\n\nThe variable can be set to the following values:\n\n- \"0\": Home button LED is turned off.\n- \"1\": Home button LED is turned on.\n\nBy default the Home button LED state is not changed. This hint can also be\nset to a floating point value between 0.0 and 1.0 which controls the\nbrightness of the Home button LED. The default brightness is 0.4.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1142 ),
1143 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1144};
1145pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_GIP: Hint = Hint {
1146 module: "hints",
1147 name: "SDL_HINT_JOYSTICK_HIDAPI_GIP",
1148 short_name: "JOYSTICK_HIDAPI_GIP",
1149 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_GIP,
1150 doc: Some(
1151 "A variable controlling whether the new HIDAPI driver for wired Xbox One\n(GIP) controllers should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": HIDAPI driver is not used.\n- \"1\": HIDAPI driver is used.\n\nThe default is the value of [`SDL_HINT_JOYSTICK_HIDAPI_XBOX_ONE`].\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1152 ),
1153 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1154};
1155pub const METADATA_SDL_HINT_JOYSTICK_HIDAPI_GIP_RESET_FOR_METADATA: Hint = Hint {
1156 module: "hints",
1157 name: "SDL_HINT_JOYSTICK_HIDAPI_GIP_RESET_FOR_METADATA",
1158 short_name: "JOYSTICK_HIDAPI_GIP_RESET_FOR_METADATA",
1159 value: crate::hints::SDL_HINT_JOYSTICK_HIDAPI_GIP_RESET_FOR_METADATA,
1160 doc: Some(
1161 "A variable controlling whether the new HIDAPI driver for wired Xbox One\n(GIP) controllers should reset the controller if it can't get the metadata\nfrom the controller.\n\nThe variable can be set to the following values:\n\n- \"0\": Assume this is a generic controller.\n- \"1\": Reset the controller to get metadata.\n\nBy default the controller is not reset.\n\nThis hint should be set before initializing joysticks and gamepads.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1162 ),
1163 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1164};
1165pub const METADATA_SDL_HINT_JOYSTICK_IOKIT: Hint = Hint {
1166 module: "hints",
1167 name: "SDL_HINT_JOYSTICK_IOKIT",
1168 short_name: "JOYSTICK_IOKIT",
1169 value: crate::hints::SDL_HINT_JOYSTICK_IOKIT,
1170 doc: Some(
1171 "A variable controlling whether IOKit should be used for controller\nhandling.\n\nThe variable can be set to the following values:\n\n- \"0\": IOKit is not used.\n- \"1\": IOKit is used. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1172 ),
1173 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1174};
1175pub const METADATA_SDL_HINT_JOYSTICK_LINUX_CLASSIC: Hint = Hint {
1176 module: "hints",
1177 name: "SDL_HINT_JOYSTICK_LINUX_CLASSIC",
1178 short_name: "JOYSTICK_LINUX_CLASSIC",
1179 value: crate::hints::SDL_HINT_JOYSTICK_LINUX_CLASSIC,
1180 doc: Some(
1181 "A variable controlling whether to use the classic /dev/input/js* joystick\ninterface or the newer /dev/input/event* joystick interface on Linux.\n\nThe variable can be set to the following values:\n\n- \"0\": Use /dev/input/event* (default)\n- \"1\": Use /dev/input/js*\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1182 ),
1183 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1184};
1185pub const METADATA_SDL_HINT_JOYSTICK_LINUX_DEADZONES: Hint = Hint {
1186 module: "hints",
1187 name: "SDL_HINT_JOYSTICK_LINUX_DEADZONES",
1188 short_name: "JOYSTICK_LINUX_DEADZONES",
1189 value: crate::hints::SDL_HINT_JOYSTICK_LINUX_DEADZONES,
1190 doc: Some(
1191 "A variable controlling whether joysticks on Linux adhere to their\nHID-defined deadzones or return unfiltered values.\n\nThe variable can be set to the following values:\n\n- \"0\": Return unfiltered joystick axis values. (default)\n- \"1\": Return axis values with deadzones taken into account.\n\nThis hint should be set before a controller is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1192 ),
1193 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1194};
1195pub const METADATA_SDL_HINT_JOYSTICK_LINUX_DIGITAL_HATS: Hint = Hint {
1196 module: "hints",
1197 name: "SDL_HINT_JOYSTICK_LINUX_DIGITAL_HATS",
1198 short_name: "JOYSTICK_LINUX_DIGITAL_HATS",
1199 value: crate::hints::SDL_HINT_JOYSTICK_LINUX_DIGITAL_HATS,
1200 doc: Some(
1201 "A variable controlling whether joysticks on Linux will always treat 'hat'\naxis inputs (ABS_HAT0X - ABS_HAT3Y) as 8-way digital hats without checking\nwhether they may be analog.\n\nThe variable can be set to the following values:\n\n- \"0\": Only map hat axis inputs to digital hat outputs if the input axes\nappear to actually be digital. (default)\n- \"1\": Always handle the input axes numbered ABS_HAT0X to ABS_HAT3Y as\ndigital hats.\n\nThis hint should be set before a controller is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1202 ),
1203 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1204};
1205pub const METADATA_SDL_HINT_JOYSTICK_LINUX_HAT_DEADZONES: Hint = Hint {
1206 module: "hints",
1207 name: "SDL_HINT_JOYSTICK_LINUX_HAT_DEADZONES",
1208 short_name: "JOYSTICK_LINUX_HAT_DEADZONES",
1209 value: crate::hints::SDL_HINT_JOYSTICK_LINUX_HAT_DEADZONES,
1210 doc: Some(
1211 "A variable controlling whether digital hats on Linux will apply deadzones\nto their underlying input axes or use unfiltered values.\n\nThe variable can be set to the following values:\n\n- \"0\": Return digital hat values based on unfiltered input axis values.\n- \"1\": Return digital hat values with deadzones on the input axes taken\ninto account. (default)\n\nThis hint should be set before a controller is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1212 ),
1213 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1214};
1215pub const METADATA_SDL_HINT_JOYSTICK_MFI: Hint = Hint {
1216 module: "hints",
1217 name: "SDL_HINT_JOYSTICK_MFI",
1218 short_name: "JOYSTICK_MFI",
1219 value: crate::hints::SDL_HINT_JOYSTICK_MFI,
1220 doc: Some(
1221 "A variable controlling whether GCController should be used for controller\nhandling.\n\nThe variable can be set to the following values:\n\n- \"0\": GCController is not used.\n- \"1\": GCController is used. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1222 ),
1223 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1224};
1225pub const METADATA_SDL_HINT_JOYSTICK_RAWINPUT: Hint = Hint {
1226 module: "hints",
1227 name: "SDL_HINT_JOYSTICK_RAWINPUT",
1228 short_name: "JOYSTICK_RAWINPUT",
1229 value: crate::hints::SDL_HINT_JOYSTICK_RAWINPUT,
1230 doc: Some(
1231 "A variable controlling whether the RAWINPUT joystick drivers should be used\nfor better handling XInput-capable devices.\n\nThe variable can be set to the following values:\n\n- \"0\": RAWINPUT drivers are not used. (default)\n- \"1\": RAWINPUT drivers are used.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1232 ),
1233 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1234};
1235pub const METADATA_SDL_HINT_JOYSTICK_RAWINPUT_CORRELATE_XINPUT: Hint = Hint {
1236 module: "hints",
1237 name: "SDL_HINT_JOYSTICK_RAWINPUT_CORRELATE_XINPUT",
1238 short_name: "JOYSTICK_RAWINPUT_CORRELATE_XINPUT",
1239 value: crate::hints::SDL_HINT_JOYSTICK_RAWINPUT_CORRELATE_XINPUT,
1240 doc: Some(
1241 "A variable controlling whether the RAWINPUT driver should pull correlated\ndata from XInput.\n\nThe variable can be set to the following values:\n\n- \"0\": RAWINPUT driver will only use data from raw input APIs.\n- \"1\": RAWINPUT driver will also pull data from XInput and\nWindows.Gaming.Input, providing better trigger axes, guide button\npresses, and rumble support for Xbox controllers. (default)\n\nThis hint should be set before a gamepad is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1242 ),
1243 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1244};
1245pub const METADATA_SDL_HINT_JOYSTICK_ROG_CHAKRAM: Hint = Hint {
1246 module: "hints",
1247 name: "SDL_HINT_JOYSTICK_ROG_CHAKRAM",
1248 short_name: "JOYSTICK_ROG_CHAKRAM",
1249 value: crate::hints::SDL_HINT_JOYSTICK_ROG_CHAKRAM,
1250 doc: Some(
1251 "A variable controlling whether the ROG Chakram mice should show up as\njoysticks.\n\nThe variable can be set to the following values:\n\n- \"0\": ROG Chakram mice do not show up as joysticks. (default)\n- \"1\": ROG Chakram mice show up as joysticks.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1252 ),
1253 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1254};
1255pub const METADATA_SDL_HINT_JOYSTICK_THREAD: Hint = Hint {
1256 module: "hints",
1257 name: "SDL_HINT_JOYSTICK_THREAD",
1258 short_name: "JOYSTICK_THREAD",
1259 value: crate::hints::SDL_HINT_JOYSTICK_THREAD,
1260 doc: Some(
1261 "A variable controlling whether a separate thread should be used for\nhandling joystick detection and raw input messages on Windows.\n\nThe variable can be set to the following values:\n\n- \"0\": A separate thread is not used.\n- \"1\": A separate thread is used for handling raw input messages. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1262 ),
1263 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1264};
1265pub const METADATA_SDL_HINT_JOYSTICK_THROTTLE_DEVICES: Hint = Hint {
1266 module: "hints",
1267 name: "SDL_HINT_JOYSTICK_THROTTLE_DEVICES",
1268 short_name: "JOYSTICK_THROTTLE_DEVICES",
1269 value: crate::hints::SDL_HINT_JOYSTICK_THROTTLE_DEVICES,
1270 doc: Some(
1271 "A variable containing a list of throttle style controllers.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1272 ),
1273 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1274};
1275pub const METADATA_SDL_HINT_JOYSTICK_THROTTLE_DEVICES_EXCLUDED: Hint = Hint {
1276 module: "hints",
1277 name: "SDL_HINT_JOYSTICK_THROTTLE_DEVICES_EXCLUDED",
1278 short_name: "JOYSTICK_THROTTLE_DEVICES_EXCLUDED",
1279 value: crate::hints::SDL_HINT_JOYSTICK_THROTTLE_DEVICES_EXCLUDED,
1280 doc: Some(
1281 "A variable containing a list of devices that are not throttle style\ncontrollers.\n\nThis will override [`SDL_HINT_JOYSTICK_THROTTLE_DEVICES`] and the built in\ndevice list.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1282 ),
1283 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1284};
1285pub const METADATA_SDL_HINT_JOYSTICK_WGI: Hint = Hint {
1286 module: "hints",
1287 name: "SDL_HINT_JOYSTICK_WGI",
1288 short_name: "JOYSTICK_WGI",
1289 value: crate::hints::SDL_HINT_JOYSTICK_WGI,
1290 doc: Some(
1291 "A variable controlling whether Windows.Gaming.Input should be used for\ncontroller handling.\n\nThe variable can be set to the following values:\n\n- \"0\": WGI is not used. (default)\n- \"1\": WGI is used.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1292 ),
1293 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1294};
1295pub const METADATA_SDL_HINT_JOYSTICK_WHEEL_DEVICES: Hint = Hint {
1296 module: "hints",
1297 name: "SDL_HINT_JOYSTICK_WHEEL_DEVICES",
1298 short_name: "JOYSTICK_WHEEL_DEVICES",
1299 value: crate::hints::SDL_HINT_JOYSTICK_WHEEL_DEVICES,
1300 doc: Some(
1301 "A variable containing a list of wheel style controllers.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1302 ),
1303 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1304};
1305pub const METADATA_SDL_HINT_JOYSTICK_WHEEL_DEVICES_EXCLUDED: Hint = Hint {
1306 module: "hints",
1307 name: "SDL_HINT_JOYSTICK_WHEEL_DEVICES_EXCLUDED",
1308 short_name: "JOYSTICK_WHEEL_DEVICES_EXCLUDED",
1309 value: crate::hints::SDL_HINT_JOYSTICK_WHEEL_DEVICES_EXCLUDED,
1310 doc: Some(
1311 "A variable containing a list of devices that are not wheel style\ncontrollers.\n\nThis will override [`SDL_HINT_JOYSTICK_WHEEL_DEVICES`] and the built in device\nlist.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1312 ),
1313 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1314};
1315pub const METADATA_SDL_HINT_JOYSTICK_ZERO_CENTERED_DEVICES: Hint = Hint {
1316 module: "hints",
1317 name: "SDL_HINT_JOYSTICK_ZERO_CENTERED_DEVICES",
1318 short_name: "JOYSTICK_ZERO_CENTERED_DEVICES",
1319 value: crate::hints::SDL_HINT_JOYSTICK_ZERO_CENTERED_DEVICES,
1320 doc: Some(
1321 "A variable containing a list of devices known to have all axes centered at\nzero.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint should be set before a controller is opened.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1322 ),
1323 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1324};
1325pub const METADATA_SDL_HINT_JOYSTICK_HAPTIC_AXES: Hint = Hint {
1326 module: "hints",
1327 name: "SDL_HINT_JOYSTICK_HAPTIC_AXES",
1328 short_name: "JOYSTICK_HAPTIC_AXES",
1329 value: crate::hints::SDL_HINT_JOYSTICK_HAPTIC_AXES,
1330 doc: Some(
1331 "A variable containing a list of devices and their desired number of haptic\n(force feedback) enabled axis.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form plus the number of desired axes, e.g.\n\n`0xAAAA/0xBBBB/1,0xCCCC/0xDDDD/3`\n\nThis hint supports a \"wildcard\" device that will set the number of haptic\naxes on all initialized haptic devices which were not defined explicitly in\nthis hint.\n\n`0xFFFF/0xFFFF/1`\n\nThis hint should be set before a controller is opened. The number of haptic\naxes won't exceed the number of real axes found on the device.\n\n## Availability\nThis hint is available since SDL 3.2.5.\n",
1332 ),
1333 available_since: Some(SDL_VERSIONNUM(3, 2, 5)),
1334};
1335pub const METADATA_SDL_HINT_KEYCODE_OPTIONS: Hint = Hint {
1336 module: "hints",
1337 name: "SDL_HINT_KEYCODE_OPTIONS",
1338 short_name: "KEYCODE_OPTIONS",
1339 value: crate::hints::SDL_HINT_KEYCODE_OPTIONS,
1340 doc: Some(
1341 "A variable that controls keycode representation in keyboard events.\n\nThis variable is a comma separated set of options for translating keycodes\nin events:\n\n- \"none\": Keycode options are cleared, this overrides other options.\n- \"hide_numpad\": The numpad keysyms will be translated into their\nnon-numpad versions based on the current NumLock state. For example,\nSDLK_KP_4 would become SDLK_4 if [`SDL_KMOD_NUM`] is set in the event\nmodifiers, and SDLK_LEFT if it is unset.\n- \"french_numbers\": The number row on French keyboards is inverted, so\npressing the 1 key would yield the keycode SDLK_1, or '1', instead of\nSDLK_AMPERSAND, or '&'\n- \"latin_letters\": For keyboards using non-Latin letters, such as Russian\nor Thai, the letter keys generate keycodes as though it had an English\nQWERTY layout. e.g. pressing the key associated with [`SDL_SCANCODE_A`] on a\nRussian keyboard would yield 'a' instead of a Cyrillic letter.\n\nThe default value for this hint is \"french_numbers,latin_letters\"\n\nSome platforms like Emscripten only provide modified keycodes and the\noptions are not used.\n\nThese options do not affect the return value of [`SDL_GetKeyFromScancode()`] or\n[`SDL_GetScancodeFromKey()`], they just apply to the keycode included in key\nevents.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1342 ),
1343 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1344};
1345pub const METADATA_SDL_HINT_KMSDRM_DEVICE_INDEX: Hint = Hint {
1346 module: "hints",
1347 name: "SDL_HINT_KMSDRM_DEVICE_INDEX",
1348 short_name: "KMSDRM_DEVICE_INDEX",
1349 value: crate::hints::SDL_HINT_KMSDRM_DEVICE_INDEX,
1350 doc: Some(
1351 "A variable that controls what KMSDRM device to use.\n\nSDL might open something like \"/dev/dri/cardNN\" to access KMSDRM\nfunctionality, where \"NN\" is a device index number. SDL makes a guess at\nthe best index to use (usually zero), but the app or user can set this hint\nto a number between 0 and 99 to force selection.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1352 ),
1353 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1354};
1355pub const METADATA_SDL_HINT_KMSDRM_REQUIRE_DRM_MASTER: Hint = Hint {
1356 module: "hints",
1357 name: "SDL_HINT_KMSDRM_REQUIRE_DRM_MASTER",
1358 short_name: "KMSDRM_REQUIRE_DRM_MASTER",
1359 value: crate::hints::SDL_HINT_KMSDRM_REQUIRE_DRM_MASTER,
1360 doc: Some(
1361 "A variable that controls whether SDL requires DRM master access in order to\ninitialize the KMSDRM video backend.\n\nThe DRM subsystem has a concept of a \"DRM master\" which is a DRM client\nthat has the ability to set planes, set cursor, etc. When SDL is DRM\nmaster, it can draw to the screen using the SDL rendering APIs. Without DRM\nmaster, SDL is still able to process input and query attributes of attached\ndisplays, but it cannot change display state or draw to the screen\ndirectly.\n\nIn some cases, it can be useful to have the KMSDRM backend even if it\ncannot be used for rendering. An app may want to use SDL for input\nprocessing while using another rendering API (such as an MMAL overlay on\nRaspberry Pi) or using its own code to render to DRM overlays that SDL\ndoesn't support.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will allow usage of the KMSDRM backend without DRM master.\n- \"1\": SDL Will require DRM master to use the KMSDRM backend. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1362 ),
1363 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1364};
1365pub const METADATA_SDL_HINT_KMSDRM_ATOMIC: Hint = Hint {
1366 module: "hints",
1367 name: "SDL_HINT_KMSDRM_ATOMIC",
1368 short_name: "KMSDRM_ATOMIC",
1369 value: crate::hints::SDL_HINT_KMSDRM_ATOMIC,
1370 doc: Some(
1371 "A variable that controls whether KMSDRM will use \"atomic\" functionality.\n\nThe KMSDRM backend can use atomic commits, if both DRM_CLIENT_CAP_ATOMIC\nand DRM_CLIENT_CAP_UNIVERSAL_PLANES is supported by the system. As of SDL\n3.4.0, it will favor this functionality, but in case this doesn't work well\non a given system or other surprises, this hint can be used to disable it.\n\nThis hint can not enable the functionality if it isn't available.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will not use the KMSDRM \"atomic\" functionality.\n- \"1\": SDL will allow usage of the KMSDRM \"atomic\" functionality. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1372 ),
1373 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1374};
1375pub const METADATA_SDL_HINT_LOGGING: Hint = Hint {
1376 module: "hints",
1377 name: "SDL_HINT_LOGGING",
1378 short_name: "LOGGING",
1379 value: crate::hints::SDL_HINT_LOGGING,
1380 doc: Some(
1381 "A variable controlling the default SDL log levels.\n\nThis variable is a comma separated set of category=level tokens that define\nthe default logging levels for SDL applications.\n\nThe category can be a numeric category, one of \"app\", \"error\", \"assert\",\n\"system\", \"audio\", \"video\", \"render\", \"input\", \"test\", or `*` for any\nunspecified category.\n\nThe level can be a numeric level, one of \"verbose\", \"debug\", \"info\",\n\"warn\", \"error\", \"critical\", or \"quiet\" to disable that category.\n\nYou can omit the category if you want to set the logging level for all\ncategories.\n\nIf this hint isn't set, the default log levels are equivalent to:\n\n`app=info,assert=warn,test=verbose,*=error`\n\nIf the `DEBUG_INVOCATION` environment variable is set to \"1\", the default\nlog levels are equivalent to:\n\n`assert=warn,test=verbose,*=debug`\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1382 ),
1383 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1384};
1385pub const METADATA_SDL_HINT_MAC_BACKGROUND_APP: Hint = Hint {
1386 module: "hints",
1387 name: "SDL_HINT_MAC_BACKGROUND_APP",
1388 short_name: "MAC_BACKGROUND_APP",
1389 value: crate::hints::SDL_HINT_MAC_BACKGROUND_APP,
1390 doc: Some(
1391 "A variable controlling whether to force the application to become the\nforeground process when launched on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": The application is brought to the foreground when launched.\n(default)\n- \"1\": The application may remain in the background when launched.\n\nThis hint needs to be set before [`SDL_Init()`].\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1392 ),
1393 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1394};
1395pub const METADATA_SDL_HINT_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK: Hint = Hint {
1396 module: "hints",
1397 name: "SDL_HINT_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK",
1398 short_name: "MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK",
1399 value: crate::hints::SDL_HINT_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK,
1400 doc: Some(
1401 "A variable that determines whether Ctrl+Click should generate a right-click\nevent on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": Ctrl+Click does not generate a right mouse button click event.\n(default)\n- \"1\": Ctrl+Click generated a right mouse button click event.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1402 ),
1403 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1404};
1405pub const METADATA_SDL_HINT_MAC_OPENGL_ASYNC_DISPATCH: Hint = Hint {
1406 module: "hints",
1407 name: "SDL_HINT_MAC_OPENGL_ASYNC_DISPATCH",
1408 short_name: "MAC_OPENGL_ASYNC_DISPATCH",
1409 value: crate::hints::SDL_HINT_MAC_OPENGL_ASYNC_DISPATCH,
1410 doc: Some(
1411 "A variable controlling whether dispatching OpenGL context updates should\nblock the dispatching thread until the main thread finishes processing on\nmacOS.\n\nThe variable can be set to the following values:\n\n- \"0\": Dispatching OpenGL context updates will block the dispatching thread\nuntil the main thread finishes processing. (default)\n- \"1\": Dispatching OpenGL context updates will allow the dispatching thread\nto continue execution.\n\nGenerally you want the default, but if you have OpenGL code in a background\nthread on a Mac, and the main thread hangs because it's waiting for that\nbackground thread, but that background thread is also hanging because it's\nwaiting for the main thread to do an update, this might fix your issue.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1412 ),
1413 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1414};
1415pub const METADATA_SDL_HINT_MAC_OPTION_AS_ALT: Hint = Hint {
1416 module: "hints",
1417 name: "SDL_HINT_MAC_OPTION_AS_ALT",
1418 short_name: "MAC_OPTION_AS_ALT",
1419 value: crate::hints::SDL_HINT_MAC_OPTION_AS_ALT,
1420 doc: Some(
1421 "A variable controlling whether the Option key on macOS should be remapped\nto act as the Alt key.\n\nThe variable can be set to the following values:\n\n- \"none\": The Option key is not remapped to Alt. (default)\n- \"only_left\": Only the left Option key is remapped to Alt.\n- \"only_right\": Only the right Option key is remapped to Alt.\n- \"both\": Both Option keys are remapped to Alt.\n\nThis will prevent the triggering of key compositions that rely on the\nOption key, but will still send the Alt modifier for keyboard events. In\nthe case that both Alt and Option are pressed, the Option key will be\nignored. This is particularly useful for applications like terminal\nemulators and graphical user interfaces (GUIs) that rely on Alt key\nfunctionality for shortcuts or navigation. This does not apply to\n[`SDL_GetKeyFromScancode`] and only has an effect if IME is enabled.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1422 ),
1423 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1424};
1425pub const METADATA_SDL_HINT_MAC_SCROLL_MOMENTUM: Hint = Hint {
1426 module: "hints",
1427 name: "SDL_HINT_MAC_SCROLL_MOMENTUM",
1428 short_name: "MAC_SCROLL_MOMENTUM",
1429 value: crate::hints::SDL_HINT_MAC_SCROLL_MOMENTUM,
1430 doc: Some(
1431 "A variable controlling whether [`SDL_EVENT_MOUSE_WHEEL`] event values will have\nmomentum on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": The mouse wheel events will have no momentum. (default)\n- \"1\": The mouse wheel events will have momentum.\n\nThis hint needs to be set before [`SDL_Init()`].\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1432 ),
1433 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1434};
1435pub const METADATA_SDL_HINT_MAC_PRESS_AND_HOLD: Hint = Hint {
1436 module: "hints",
1437 name: "SDL_HINT_MAC_PRESS_AND_HOLD",
1438 short_name: "MAC_PRESS_AND_HOLD",
1439 value: crate::hints::SDL_HINT_MAC_PRESS_AND_HOLD,
1440 doc: Some(
1441 "A variable controlling whether holding down a key will repeat the pressed\nkey or open the accents menu on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": Holding a key will open the accents menu for that key.\n- \"1\": Holding a key will repeat the pressed key. (default)\n\nThis hint needs to be set before [`SDL_Init()`].\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1442 ),
1443 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1444};
1445pub const METADATA_SDL_HINT_MAIN_CALLBACK_RATE: Hint = Hint {
1446 module: "hints",
1447 name: "SDL_HINT_MAIN_CALLBACK_RATE",
1448 short_name: "MAIN_CALLBACK_RATE",
1449 value: crate::hints::SDL_HINT_MAIN_CALLBACK_RATE,
1450 doc: Some(
1451 "Request [`SDL_AppIterate()`] be called at a specific rate.\n\nIf this is set to a number, it represents Hz, so \"60\" means try to iterate\n60 times per second. \"0\" means to iterate as fast as possible. Negative\nvalues are illegal, but reserved, in case they are useful in a future\nrevision of SDL.\n\nThere are other strings that have special meaning. If set to \"waitevent\",\n[`SDL_AppIterate`] will not be called until new event(s) have arrived (and been\nprocessed by [`SDL_AppEvent`]). This can be useful for apps that are completely\nidle except in response to input.\n\nOn some platforms, or if you are using [`SDL_main`] instead of [`SDL_AppIterate`],\nthis hint is ignored. When the hint can be used, it is allowed to be\nchanged at any time.\n\nThis defaults to 0, and specifying NULL for the hint's value will restore\nthe default.\n\nThis doesn't have to be an integer value. For example, \"59.94\" won't be\nrounded to an integer rate; the digits after the decimal are actually\nrespected.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1452 ),
1453 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1454};
1455pub const METADATA_SDL_HINT_MOUSE_AUTO_CAPTURE: Hint = Hint {
1456 module: "hints",
1457 name: "SDL_HINT_MOUSE_AUTO_CAPTURE",
1458 short_name: "MOUSE_AUTO_CAPTURE",
1459 value: crate::hints::SDL_HINT_MOUSE_AUTO_CAPTURE,
1460 doc: Some(
1461 "A variable controlling whether the mouse is captured while mouse buttons\nare pressed.\n\nThe variable can be set to the following values:\n\n- \"0\": The mouse is not captured while mouse buttons are pressed.\n- \"1\": The mouse is captured while mouse buttons are pressed.\n\nBy default the mouse is captured while mouse buttons are pressed so if the\nmouse is dragged outside the window, the application continues to receive\nmouse events until the button is released.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1462 ),
1463 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1464};
1465pub const METADATA_SDL_HINT_MOUSE_DOUBLE_CLICK_RADIUS: Hint = Hint {
1466 module: "hints",
1467 name: "SDL_HINT_MOUSE_DOUBLE_CLICK_RADIUS",
1468 short_name: "MOUSE_DOUBLE_CLICK_RADIUS",
1469 value: crate::hints::SDL_HINT_MOUSE_DOUBLE_CLICK_RADIUS,
1470 doc: Some(
1471 "A variable setting the double click radius, in pixels.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1472 ),
1473 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1474};
1475pub const METADATA_SDL_HINT_MOUSE_DOUBLE_CLICK_TIME: Hint = Hint {
1476 module: "hints",
1477 name: "SDL_HINT_MOUSE_DOUBLE_CLICK_TIME",
1478 short_name: "MOUSE_DOUBLE_CLICK_TIME",
1479 value: crate::hints::SDL_HINT_MOUSE_DOUBLE_CLICK_TIME,
1480 doc: Some(
1481 "A variable setting the double click time, in milliseconds.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1482 ),
1483 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1484};
1485pub const METADATA_SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR: Hint = Hint {
1486 module: "hints",
1487 name: "SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR",
1488 short_name: "MOUSE_DEFAULT_SYSTEM_CURSOR",
1489 value: crate::hints::SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR,
1490 doc: Some(
1491 "A variable setting which system cursor to use as the default cursor.\n\nThis should be an integer corresponding to the [`SDL_SystemCursor`] enum. The\ndefault value is zero ([`SDL_SYSTEM_CURSOR_DEFAULT`]).\n\nThis hint needs to be set before [`SDL_Init()`].\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1492 ),
1493 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1494};
1495pub const METADATA_SDL_HINT_MOUSE_DPI_SCALE_CURSORS: Hint = Hint {
1496 module: "hints",
1497 name: "SDL_HINT_MOUSE_DPI_SCALE_CURSORS",
1498 short_name: "MOUSE_DPI_SCALE_CURSORS",
1499 value: crate::hints::SDL_HINT_MOUSE_DPI_SCALE_CURSORS,
1500 doc: Some(
1501 "A variable setting whether we should scale cursors by the current display\nscale.\n\nThe variable can be set to the following values:\n\n- \"0\": Cursors will not change size based on the display content scale.\n(default)\n- \"1\": Cursors will automatically match the display content scale (e.g. a\n2x sized cursor will be used when the window is on a monitor with 200%\nscale). This is currently implemented on Windows and Wayland.\n\nThis hint needs to be set before creating cursors.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1502 ),
1503 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1504};
1505pub const METADATA_SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE: Hint = Hint {
1506 module: "hints",
1507 name: "SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE",
1508 short_name: "MOUSE_EMULATE_WARP_WITH_RELATIVE",
1509 value: crate::hints::SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE,
1510 doc: Some(
1511 "A variable controlling whether warping a hidden mouse cursor will activate\nrelative mouse mode.\n\nWhen this hint is set, the mouse cursor is hidden, and multiple warps to\nthe window center occur within a short time period, SDL will emulate mouse\nwarps using relative mouse mode. This can provide smoother and more\nreliable mouse motion for some older games, which continuously calculate\nthe distance traveled by the mouse pointer and warp it back to the center\nof the window, rather than using relative mouse motion.\n\nNote that relative mouse mode may have different mouse acceleration\nbehavior than pointer warps.\n\nIf your application needs to repeatedly warp the hidden mouse cursor at a\nhigh-frequency for other purposes, it should disable this hint.\n\nThe variable can be set to the following values:\n\n- \"0\": Attempts to warp the mouse will always be made.\n- \"1\": Some mouse warps will be emulated by forcing relative mouse mode.\n(default)\n\nIf not set, this is automatically enabled unless an application uses\nrelative mouse mode directly.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1512 ),
1513 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1514};
1515pub const METADATA_SDL_HINT_MOUSE_FOCUS_CLICKTHROUGH: Hint = Hint {
1516 module: "hints",
1517 name: "SDL_HINT_MOUSE_FOCUS_CLICKTHROUGH",
1518 short_name: "MOUSE_FOCUS_CLICKTHROUGH",
1519 value: crate::hints::SDL_HINT_MOUSE_FOCUS_CLICKTHROUGH,
1520 doc: Some(
1521 "Allow mouse click events when clicking to focus an SDL window.\n\nThe variable can be set to the following values:\n\n- \"0\": Ignore mouse clicks that activate a window. (default)\n- \"1\": Generate events for mouse clicks that activate a window.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1522 ),
1523 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1524};
1525pub const METADATA_SDL_HINT_MOUSE_NORMAL_SPEED_SCALE: Hint = Hint {
1526 module: "hints",
1527 name: "SDL_HINT_MOUSE_NORMAL_SPEED_SCALE",
1528 short_name: "MOUSE_NORMAL_SPEED_SCALE",
1529 value: crate::hints::SDL_HINT_MOUSE_NORMAL_SPEED_SCALE,
1530 doc: Some(
1531 "A variable setting the speed scale for mouse motion, in floating point,\nwhen the mouse is not in relative mode.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1532 ),
1533 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1534};
1535pub const METADATA_SDL_HINT_MOUSE_RELATIVE_MODE_CENTER: Hint = Hint {
1536 module: "hints",
1537 name: "SDL_HINT_MOUSE_RELATIVE_MODE_CENTER",
1538 short_name: "MOUSE_RELATIVE_MODE_CENTER",
1539 value: crate::hints::SDL_HINT_MOUSE_RELATIVE_MODE_CENTER,
1540 doc: Some(
1541 "A variable controlling whether relative mouse mode constrains the mouse to\nthe center of the window.\n\nConstraining to the center of the window works better for FPS games and\nwhen the application is running over RDP. Constraining to the whole window\nworks better for 2D games and increases the chance that the mouse will be\nin the correct position when using high DPI mice.\n\nThe variable can be set to the following values:\n\n- \"0\": Relative mouse mode constrains the mouse to the window.\n- \"1\": Relative mouse mode constrains the mouse to the center of the\nwindow. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1542 ),
1543 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1544};
1545pub const METADATA_SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE: Hint = Hint {
1546 module: "hints",
1547 name: "SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE",
1548 short_name: "MOUSE_RELATIVE_SPEED_SCALE",
1549 value: crate::hints::SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE,
1550 doc: Some(
1551 "A variable setting the scale for mouse motion, in floating point, when the\nmouse is in relative mode.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1552 ),
1553 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1554};
1555pub const METADATA_SDL_HINT_MOUSE_RELATIVE_SYSTEM_SCALE: Hint = Hint {
1556 module: "hints",
1557 name: "SDL_HINT_MOUSE_RELATIVE_SYSTEM_SCALE",
1558 short_name: "MOUSE_RELATIVE_SYSTEM_SCALE",
1559 value: crate::hints::SDL_HINT_MOUSE_RELATIVE_SYSTEM_SCALE,
1560 doc: Some(
1561 "A variable controlling whether the system mouse acceleration curve is used\nfor relative mouse motion.\n\nThe variable can be set to the following values:\n\n- \"0\": Relative mouse motion will be unscaled. (default)\n- \"1\": Relative mouse motion will be scaled using the system mouse\nacceleration curve.\n\nIf [`SDL_HINT_MOUSE_RELATIVE_SPEED_SCALE`] is set, that will be applied after\nsystem speed scale.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1562 ),
1563 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1564};
1565pub const METADATA_SDL_HINT_MOUSE_RELATIVE_WARP_MOTION: Hint = Hint {
1566 module: "hints",
1567 name: "SDL_HINT_MOUSE_RELATIVE_WARP_MOTION",
1568 short_name: "MOUSE_RELATIVE_WARP_MOTION",
1569 value: crate::hints::SDL_HINT_MOUSE_RELATIVE_WARP_MOTION,
1570 doc: Some(
1571 "A variable controlling whether a motion event should be generated for mouse\nwarping in relative mode.\n\nThe variable can be set to the following values:\n\n- \"0\": Warping the mouse will not generate a motion event in relative mode\n- \"1\": Warping the mouse will generate a motion event in relative mode\n\nBy default warping the mouse will not generate motion events in relative\nmode. This avoids the application having to filter out large relative\nmotion due to warping.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1572 ),
1573 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1574};
1575pub const METADATA_SDL_HINT_MOUSE_RELATIVE_CURSOR_VISIBLE: Hint = Hint {
1576 module: "hints",
1577 name: "SDL_HINT_MOUSE_RELATIVE_CURSOR_VISIBLE",
1578 short_name: "MOUSE_RELATIVE_CURSOR_VISIBLE",
1579 value: crate::hints::SDL_HINT_MOUSE_RELATIVE_CURSOR_VISIBLE,
1580 doc: Some(
1581 "A variable controlling whether the hardware cursor stays visible when\nrelative mode is active.\n\nThis variable can be set to the following values:\n\n- \"0\": The cursor will be hidden while relative mode is active (default)\n- \"1\": The cursor will remain visible while relative mode is active\n\nNote that for systems without raw hardware inputs, relative mode is\nimplemented using warping, so the hardware cursor will visibly warp between\nframes if this is enabled on those systems.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1582 ),
1583 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1584};
1585pub const METADATA_SDL_HINT_MOUSE_TOUCH_EVENTS: Hint = Hint {
1586 module: "hints",
1587 name: "SDL_HINT_MOUSE_TOUCH_EVENTS",
1588 short_name: "MOUSE_TOUCH_EVENTS",
1589 value: crate::hints::SDL_HINT_MOUSE_TOUCH_EVENTS,
1590 doc: Some(
1591 "A variable controlling whether mouse events should generate synthetic touch\nevents.\n\nThe variable can be set to the following values:\n\n- \"0\": Mouse events will not generate touch events. (default for desktop\nplatforms)\n- \"1\": Mouse events will generate touch events. (default for mobile\nplatforms, such as Android and iOS)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1592 ),
1593 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1594};
1595pub const METADATA_SDL_HINT_MUTE_CONSOLE_KEYBOARD: Hint = Hint {
1596 module: "hints",
1597 name: "SDL_HINT_MUTE_CONSOLE_KEYBOARD",
1598 short_name: "MUTE_CONSOLE_KEYBOARD",
1599 value: crate::hints::SDL_HINT_MUTE_CONSOLE_KEYBOARD,
1600 doc: Some(
1601 "A variable controlling whether the keyboard should be muted on the console.\n\nNormally the keyboard is muted while SDL applications are running so that\nkeyboard input doesn't show up as key strokes on the console. This hint\nallows you to turn that off for debugging purposes.\n\nThe variable can be set to the following values:\n\n- \"0\": Allow keystrokes to go through to the console.\n- \"1\": Mute keyboard input so it doesn't show up on the console. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1602 ),
1603 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1604};
1605pub const METADATA_SDL_HINT_NO_SIGNAL_HANDLERS: Hint = Hint {
1606 module: "hints",
1607 name: "SDL_HINT_NO_SIGNAL_HANDLERS",
1608 short_name: "NO_SIGNAL_HANDLERS",
1609 value: crate::hints::SDL_HINT_NO_SIGNAL_HANDLERS,
1610 doc: Some(
1611 "Tell SDL not to catch the SIGINT or SIGTERM signals on POSIX platforms.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will install a SIGINT and SIGTERM handler, and when it catches a\nsignal, convert it into an [`SDL_EVENT_QUIT`] event. (default)\n- \"1\": SDL will not install a signal handler at all.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1612 ),
1613 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1614};
1615pub const METADATA_SDL_HINT_OPENGL_LIBRARY: Hint = Hint {
1616 module: "hints",
1617 name: "SDL_HINT_OPENGL_LIBRARY",
1618 short_name: "OPENGL_LIBRARY",
1619 value: crate::hints::SDL_HINT_OPENGL_LIBRARY,
1620 doc: Some(
1621 "Specify the OpenGL library to load.\n\nThis hint should be set before creating an OpenGL window or creating an\nOpenGL context. If this hint isn't set, SDL will choose a reasonable\ndefault.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1622 ),
1623 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1624};
1625pub const METADATA_SDL_HINT_EGL_LIBRARY: Hint = Hint {
1626 module: "hints",
1627 name: "SDL_HINT_EGL_LIBRARY",
1628 short_name: "EGL_LIBRARY",
1629 value: crate::hints::SDL_HINT_EGL_LIBRARY,
1630 doc: Some(
1631 "Specify the EGL library to load.\n\nThis hint should be set before creating an OpenGL window or creating an\nOpenGL context. This hint is only considered if SDL is using EGL to manage\nOpenGL contexts. If this hint isn't set, SDL will choose a reasonable\ndefault.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1632 ),
1633 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1634};
1635pub const METADATA_SDL_HINT_OPENGL_ES_DRIVER: Hint = Hint {
1636 module: "hints",
1637 name: "SDL_HINT_OPENGL_ES_DRIVER",
1638 short_name: "OPENGL_ES_DRIVER",
1639 value: crate::hints::SDL_HINT_OPENGL_ES_DRIVER,
1640 doc: Some(
1641 "A variable controlling what driver to use for OpenGL ES contexts.\n\nOn some platforms, currently Windows and X11, OpenGL drivers may support\ncreating contexts with an OpenGL ES profile. By default SDL uses these\nprofiles, when available, otherwise it attempts to load an OpenGL ES\nlibrary, e.g. that provided by the ANGLE project. This variable controls\nwhether SDL follows this default behaviour or will always load an OpenGL ES\nlibrary.\n\nCircumstances where this is useful include - Testing an app with a\nparticular OpenGL ES implementation, e.g ANGLE, or emulator, e.g. those\nfrom ARM, Imagination or Qualcomm. - Resolving OpenGL ES function addresses\nat link time by linking with the OpenGL ES library instead of querying them\nat run time with [`SDL_GL_GetProcAddress()`].\n\nCaution: for an application to work with the default behaviour across\ndifferent OpenGL drivers it must query the OpenGL ES function addresses at\nrun time using [`SDL_GL_GetProcAddress()`].\n\nThis variable is ignored on most platforms because OpenGL ES is native or\nnot supported.\n\nThe variable can be set to the following values:\n\n- \"0\": Use ES profile of OpenGL, if available. (default)\n- \"1\": Load OpenGL ES library using the default library names.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1642 ),
1643 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1644};
1645pub const METADATA_SDL_HINT_OPENVR_LIBRARY: Hint = Hint {
1646 module: "hints",
1647 name: "SDL_HINT_OPENVR_LIBRARY",
1648 short_name: "OPENVR_LIBRARY",
1649 value: crate::hints::SDL_HINT_OPENVR_LIBRARY,
1650 doc: Some(
1651 "Mechanism to specify openvr_api library location\n\nBy default, when using the OpenVR driver, it will search for the API\nlibrary in the current folder. But, if you wish to use a system API you can\nspecify that by using this hint. This should be the full or relative path\nto a .dll on Windows or .so on Linux.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1652 ),
1653 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1654};
1655pub const METADATA_SDL_HINT_ORIENTATIONS: Hint = Hint {
1656 module: "hints",
1657 name: "SDL_HINT_ORIENTATIONS",
1658 short_name: "ORIENTATIONS",
1659 value: crate::hints::SDL_HINT_ORIENTATIONS,
1660 doc: Some(
1661 "A variable controlling which orientations are allowed on iOS/Android.\n\nIn some circumstances it is necessary to be able to explicitly control\nwhich UI orientations are allowed.\n\nThis variable is a space delimited list of the following values:\n\n- \"LandscapeLeft\"\n- \"LandscapeRight\"\n- \"Portrait\"\n- \"PortraitUpsideDown\"\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1662 ),
1663 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1664};
1665pub const METADATA_SDL_HINT_POLL_SENTINEL: Hint = Hint {
1666 module: "hints",
1667 name: "SDL_HINT_POLL_SENTINEL",
1668 short_name: "POLL_SENTINEL",
1669 value: crate::hints::SDL_HINT_POLL_SENTINEL,
1670 doc: Some(
1671 "A variable controlling the use of a sentinel event when polling the event\nqueue.\n\nWhen polling for events, [`SDL_PumpEvents`] is used to gather new events from\ndevices. If a device keeps producing new events between calls to\n[`SDL_PumpEvents`], a poll loop will become stuck until the new events stop.\nThis is most noticeable when moving a high frequency mouse.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable poll sentinels.\n- \"1\": Enable poll sentinels. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1672 ),
1673 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1674};
1675pub const METADATA_SDL_HINT_PREFERRED_LOCALES: Hint = Hint {
1676 module: "hints",
1677 name: "SDL_HINT_PREFERRED_LOCALES",
1678 short_name: "PREFERRED_LOCALES",
1679 value: crate::hints::SDL_HINT_PREFERRED_LOCALES,
1680 doc: Some(
1681 "Override for [`SDL_GetPreferredLocales()`].\n\nIf set, this will be favored over anything the OS might report for the\nuser's preferred locales. Changing this hint at runtime will not generate a\n[`SDL_EVENT_LOCALE_CHANGED`] event (but if you can change the hint, you can\npush your own event, if you want).\n\nThe format of this hint is a comma-separated list of language and locale,\ncombined with an underscore, as is a common format: \"en_GB\". Locale is\noptional: \"en\". So you might have a list like this: \"en_GB,jp,es_PT\"\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1682 ),
1683 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1684};
1685pub const METADATA_SDL_HINT_QUIT_ON_LAST_WINDOW_CLOSE: Hint = Hint {
1686 module: "hints",
1687 name: "SDL_HINT_QUIT_ON_LAST_WINDOW_CLOSE",
1688 short_name: "QUIT_ON_LAST_WINDOW_CLOSE",
1689 value: crate::hints::SDL_HINT_QUIT_ON_LAST_WINDOW_CLOSE,
1690 doc: Some(
1691 "A variable that decides whether to send [`SDL_EVENT_QUIT`] when closing the\nlast window.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will not send an [`SDL_EVENT_QUIT`] event when the last window is\nrequesting to close. Note that in this case, there are still other\nlegitimate reasons one might get an [`SDL_EVENT_QUIT`] event: choosing \"Quit\"\nfrom the macOS menu bar, sending a SIGINT (ctrl-c) on Unix, etc.\n- \"1\": SDL will send a quit event when the last window is requesting to\nclose. (default)\n\nIf there is at least one active system tray icon, [`SDL_EVENT_QUIT`] will\ninstead be sent when both the last window will be closed and the last tray\nicon will be destroyed.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1692 ),
1693 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1694};
1695pub const METADATA_SDL_HINT_RENDER_DIRECT3D_THREADSAFE: Hint = Hint {
1696 module: "hints",
1697 name: "SDL_HINT_RENDER_DIRECT3D_THREADSAFE",
1698 short_name: "RENDER_DIRECT3D_THREADSAFE",
1699 value: crate::hints::SDL_HINT_RENDER_DIRECT3D_THREADSAFE,
1700 doc: Some(
1701 "A variable controlling whether the Direct3D device is initialized for\nthread-safe operations.\n\nThe variable can be set to the following values:\n\n- \"0\": Thread-safety is not enabled. (default)\n- \"1\": Thread-safety is enabled.\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1702 ),
1703 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1704};
1705pub const METADATA_SDL_HINT_RENDER_DIRECT3D11_DEBUG: Hint = Hint {
1706 module: "hints",
1707 name: "SDL_HINT_RENDER_DIRECT3D11_DEBUG",
1708 short_name: "RENDER_DIRECT3D11_DEBUG",
1709 value: crate::hints::SDL_HINT_RENDER_DIRECT3D11_DEBUG,
1710 doc: Some(
1711 "A variable controlling whether to enable Direct3D 11+'s Debug Layer.\n\nThis variable does not have any effect on the Direct3D 9 based renderer.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable Debug Layer use. (default)\n- \"1\": Enable Debug Layer use.\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1712 ),
1713 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1714};
1715pub const METADATA_SDL_HINT_RENDER_DIRECT3D11_WARP: Hint = Hint {
1716 module: "hints",
1717 name: "SDL_HINT_RENDER_DIRECT3D11_WARP",
1718 short_name: "RENDER_DIRECT3D11_WARP",
1719 value: crate::hints::SDL_HINT_RENDER_DIRECT3D11_WARP,
1720 doc: Some(
1721 "A variable controlling whether to use the Direct3D 11 WARP software\nrasterizer.\n\nFor more information, see:\n<https://learn.microsoft.com/en-us/windows/win32/direct3darticles/directx-warp>\n\nThe variable can be set to the following values:\n\n- \"0\": Disable WARP rasterizer. (default)\n- \"1\": Enable WARP rasterizer.\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
1722 ),
1723 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
1724};
1725pub const METADATA_SDL_HINT_RENDER_VULKAN_DEBUG: Hint = Hint {
1726 module: "hints",
1727 name: "SDL_HINT_RENDER_VULKAN_DEBUG",
1728 short_name: "RENDER_VULKAN_DEBUG",
1729 value: crate::hints::SDL_HINT_RENDER_VULKAN_DEBUG,
1730 doc: Some(
1731 "A variable controlling whether to enable Vulkan Validation Layers.\n\nThis variable can be set to the following values:\n\n- \"0\": Disable Validation Layer use\n- \"1\": Enable Validation Layer use\n\nBy default, SDL does not use Vulkan Validation Layers.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1732 ),
1733 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1734};
1735pub const METADATA_SDL_HINT_RENDER_GPU_DEBUG: Hint = Hint {
1736 module: "hints",
1737 name: "SDL_HINT_RENDER_GPU_DEBUG",
1738 short_name: "RENDER_GPU_DEBUG",
1739 value: crate::hints::SDL_HINT_RENDER_GPU_DEBUG,
1740 doc: Some(
1741 "A variable controlling whether to create the GPU device in debug mode.\n\nThis variable can be set to the following values:\n\n- \"0\": Disable debug mode use (default)\n- \"1\": Enable debug mode use\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1742 ),
1743 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1744};
1745pub const METADATA_SDL_HINT_RENDER_GPU_LOW_POWER: Hint = Hint {
1746 module: "hints",
1747 name: "SDL_HINT_RENDER_GPU_LOW_POWER",
1748 short_name: "RENDER_GPU_LOW_POWER",
1749 value: crate::hints::SDL_HINT_RENDER_GPU_LOW_POWER,
1750 doc: Some(
1751 "A variable controlling whether to prefer a low-power GPU on multi-GPU\nsystems.\n\nThis variable can be set to the following values:\n\n- \"0\": Prefer high-performance GPU (default)\n- \"1\": Prefer low-power GPU\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1752 ),
1753 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1754};
1755pub const METADATA_SDL_HINT_RENDER_DRIVER: Hint = Hint {
1756 module: "hints",
1757 name: "SDL_HINT_RENDER_DRIVER",
1758 short_name: "RENDER_DRIVER",
1759 value: crate::hints::SDL_HINT_RENDER_DRIVER,
1760 doc: Some(
1761 "A variable specifying which render driver to use.\n\nIf the application doesn't pick a specific renderer to use, this variable\nspecifies the name of the preferred renderer. If the preferred renderer\ncan't be initialized, creating a renderer will fail.\n\nThis variable is case insensitive and can be set to the following values:\n\n- \"direct3d\"\n- \"direct3d11\"\n- \"direct3d12\"\n- \"opengl\"\n- \"opengles2\"\n- \"opengles\"\n- \"metal\"\n- \"vulkan\"\n- \"gpu\"\n- \"software\"\n\nThis hint accepts a comma-separated list of driver names, and each will be\ntried in the order listed when creating a renderer until one succeeds or\nall of them fail.\n\nThe default varies by platform, but it's the first one in the list that is\navailable on the current platform.\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1762 ),
1763 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1764};
1765pub const METADATA_SDL_HINT_RENDER_LINE_METHOD: Hint = Hint {
1766 module: "hints",
1767 name: "SDL_HINT_RENDER_LINE_METHOD",
1768 short_name: "RENDER_LINE_METHOD",
1769 value: crate::hints::SDL_HINT_RENDER_LINE_METHOD,
1770 doc: Some(
1771 "A variable controlling how the 2D render API renders lines.\n\nThe variable can be set to the following values:\n\n- \"0\": Use the default line drawing method (Bresenham's line algorithm)\n- \"1\": Use the driver point API using Bresenham's line algorithm (correct,\ndraws many points)\n- \"2\": Use the driver line API (occasionally misses line endpoints based on\nhardware driver quirks\n- \"3\": Use the driver geometry API (correct, draws thicker diagonal lines)\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1772 ),
1773 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1774};
1775pub const METADATA_SDL_HINT_RENDER_METAL_PREFER_LOW_POWER_DEVICE: Hint = Hint {
1776 module: "hints",
1777 name: "SDL_HINT_RENDER_METAL_PREFER_LOW_POWER_DEVICE",
1778 short_name: "RENDER_METAL_PREFER_LOW_POWER_DEVICE",
1779 value: crate::hints::SDL_HINT_RENDER_METAL_PREFER_LOW_POWER_DEVICE,
1780 doc: Some(
1781 "A variable controlling whether the Metal render driver select low power\ndevice over default one.\n\nThe variable can be set to the following values:\n\n- \"0\": Use the preferred OS device. (default)\n- \"1\": Select a low power device.\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1782 ),
1783 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1784};
1785pub const METADATA_SDL_HINT_RENDER_VSYNC: Hint = Hint {
1786 module: "hints",
1787 name: "SDL_HINT_RENDER_VSYNC",
1788 short_name: "RENDER_VSYNC",
1789 value: crate::hints::SDL_HINT_RENDER_VSYNC,
1790 doc: Some(
1791 "A variable controlling whether updates to the SDL screen surface should be\nsynchronized with the vertical refresh, to avoid tearing.\n\nThis hint overrides the application preference when creating a renderer.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable vsync. (default)\n- \"1\": Enable vsync.\n\nThis hint should be set before creating a renderer.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1792 ),
1793 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1794};
1795pub const METADATA_SDL_HINT_RETURN_KEY_HIDES_IME: Hint = Hint {
1796 module: "hints",
1797 name: "SDL_HINT_RETURN_KEY_HIDES_IME",
1798 short_name: "RETURN_KEY_HIDES_IME",
1799 value: crate::hints::SDL_HINT_RETURN_KEY_HIDES_IME,
1800 doc: Some(
1801 "A variable to control whether the return key on the soft keyboard should\nhide the soft keyboard on Android and iOS.\n\nThis hint sets the default value of [`SDL_PROP_TEXTINPUT_MULTILINE_BOOLEAN`].\n\nThe variable can be set to the following values:\n\n- \"0\": The return key will be handled as a key event. (default)\n- \"1\": The return key will hide the keyboard.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1802 ),
1803 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1804};
1805pub const METADATA_SDL_HINT_ROG_GAMEPAD_MICE: Hint = Hint {
1806 module: "hints",
1807 name: "SDL_HINT_ROG_GAMEPAD_MICE",
1808 short_name: "ROG_GAMEPAD_MICE",
1809 value: crate::hints::SDL_HINT_ROG_GAMEPAD_MICE,
1810 doc: Some(
1811 "A variable containing a list of ROG gamepad capable mice.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n\n## See also\n- [`SDL_HINT_ROG_GAMEPAD_MICE_EXCLUDED`]\n",
1812 ),
1813 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1814};
1815pub const METADATA_SDL_HINT_ROG_GAMEPAD_MICE_EXCLUDED: Hint = Hint {
1816 module: "hints",
1817 name: "SDL_HINT_ROG_GAMEPAD_MICE_EXCLUDED",
1818 short_name: "ROG_GAMEPAD_MICE_EXCLUDED",
1819 value: crate::hints::SDL_HINT_ROG_GAMEPAD_MICE_EXCLUDED,
1820 doc: Some(
1821 "A variable containing a list of devices that are not ROG gamepad capable\nmice.\n\nThis will override [`SDL_HINT_ROG_GAMEPAD_MICE`] and the built in device list.\n\nThe format of the string is a comma separated list of USB VID/PID pairs in\nhexadecimal form, e.g.\n\n`0xAAAA/0xBBBB,0xCCCC/0xDDDD`\n\nThe variable can also take the form of \"@file\", in which case the named\nfile will be loaded and interpreted as the value of the variable.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1822 ),
1823 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1824};
1825pub const METADATA_SDL_HINT_PS2_GS_WIDTH: Hint = Hint {
1826 module: "hints",
1827 name: "SDL_HINT_PS2_GS_WIDTH",
1828 short_name: "PS2_GS_WIDTH",
1829 value: crate::hints::SDL_HINT_PS2_GS_WIDTH,
1830 doc: Some(
1831 "Variable controlling the width of the PS2's framebuffer in pixels\n\nBy default, this variable is \"640\"\n",
1832 ),
1833 available_since: None,
1834};
1835pub const METADATA_SDL_HINT_PS2_GS_HEIGHT: Hint = Hint {
1836 module: "hints",
1837 name: "SDL_HINT_PS2_GS_HEIGHT",
1838 short_name: "PS2_GS_HEIGHT",
1839 value: crate::hints::SDL_HINT_PS2_GS_HEIGHT,
1840 doc: Some(
1841 "Variable controlling the height of the PS2's framebuffer in pixels\n\nBy default, this variable is \"448\"\n",
1842 ),
1843 available_since: None,
1844};
1845pub const METADATA_SDL_HINT_PS2_GS_PROGRESSIVE: Hint = Hint {
1846 module: "hints",
1847 name: "SDL_HINT_PS2_GS_PROGRESSIVE",
1848 short_name: "PS2_GS_PROGRESSIVE",
1849 value: crate::hints::SDL_HINT_PS2_GS_PROGRESSIVE,
1850 doc: Some(
1851 "Variable controlling whether the signal is interlaced or progressive\n\n- \"0\": Image is interlaced. (default)\n- \"1\": Image is progressive\n",
1852 ),
1853 available_since: None,
1854};
1855pub const METADATA_SDL_HINT_PS2_GS_MODE: Hint = Hint {
1856 module: "hints",
1857 name: "SDL_HINT_PS2_GS_MODE",
1858 short_name: "PS2_GS_MODE",
1859 value: crate::hints::SDL_HINT_PS2_GS_MODE,
1860 doc: Some(
1861 "Variable controlling the video mode of the console\n\n- \"\": Console-native. (default)\n- \"NTSC\": 60hz region\n- \"PAL\": 50hz region\n",
1862 ),
1863 available_since: None,
1864};
1865pub const METADATA_SDL_HINT_RPI_VIDEO_LAYER: Hint = Hint {
1866 module: "hints",
1867 name: "SDL_HINT_RPI_VIDEO_LAYER",
1868 short_name: "RPI_VIDEO_LAYER",
1869 value: crate::hints::SDL_HINT_RPI_VIDEO_LAYER,
1870 doc: Some(
1871 "A variable controlling which Dispmanx layer to use on a Raspberry PI.\n\nAlso known as Z-order. The variable can take a negative or positive value.\nThe default is 10000.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1872 ),
1873 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1874};
1875pub const METADATA_SDL_HINT_SCREENSAVER_INHIBIT_ACTIVITY_NAME: Hint = Hint {
1876 module: "hints",
1877 name: "SDL_HINT_SCREENSAVER_INHIBIT_ACTIVITY_NAME",
1878 short_name: "SCREENSAVER_INHIBIT_ACTIVITY_NAME",
1879 value: crate::hints::SDL_HINT_SCREENSAVER_INHIBIT_ACTIVITY_NAME,
1880 doc: Some(
1881 "Specify an \"activity name\" for screensaver inhibition.\n\nSome platforms, notably Linux desktops, list the applications which are\ninhibiting the screensaver or other power-saving features.\n\nThis hint lets you specify the \"activity name\" sent to the OS when\n[`SDL_DisableScreenSaver()`] is used (or the screensaver is automatically\ndisabled). The contents of this hint are used when the screensaver is\ndisabled. You should use a string that describes what your program is doing\n(and, therefore, why the screensaver is disabled). For example, \"Playing a\ngame\" or \"Watching a video\".\n\nSetting this to \"\" or leaving it unset will have SDL use a reasonable\ndefault: \"Playing a game\" or something similar.\n\nThis hint should be set before calling [`SDL_DisableScreenSaver()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1882 ),
1883 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1884};
1885pub const METADATA_SDL_HINT_SHUTDOWN_DBUS_ON_QUIT: Hint = Hint {
1886 module: "hints",
1887 name: "SDL_HINT_SHUTDOWN_DBUS_ON_QUIT",
1888 short_name: "SHUTDOWN_DBUS_ON_QUIT",
1889 value: crate::hints::SDL_HINT_SHUTDOWN_DBUS_ON_QUIT,
1890 doc: Some(
1891 "A variable controlling whether SDL calls dbus_shutdown() on quit.\n\nThis is useful as a debug tool to validate memory leaks, but shouldn't ever\nbe set in production applications, as other libraries used by the\napplication might use dbus under the hood and this can cause crashes if\nthey continue after [`SDL_Quit()`].\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will not call dbus_shutdown() on quit. (default)\n- \"1\": SDL will call dbus_shutdown() on quit.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1892 ),
1893 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1894};
1895pub const METADATA_SDL_HINT_STORAGE_TITLE_DRIVER: Hint = Hint {
1896 module: "hints",
1897 name: "SDL_HINT_STORAGE_TITLE_DRIVER",
1898 short_name: "STORAGE_TITLE_DRIVER",
1899 value: crate::hints::SDL_HINT_STORAGE_TITLE_DRIVER,
1900 doc: Some(
1901 "A variable that specifies a backend to use for title storage.\n\nBy default, SDL will try all available storage backends in a reasonable\norder until it finds one that can work, but this hint allows the app or\nuser to force a specific target, such as \"pc\" if, say, you are on Steam but\nwant to avoid SteamRemoteStorage for title data.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1902 ),
1903 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1904};
1905pub const METADATA_SDL_HINT_STORAGE_USER_DRIVER: Hint = Hint {
1906 module: "hints",
1907 name: "SDL_HINT_STORAGE_USER_DRIVER",
1908 short_name: "STORAGE_USER_DRIVER",
1909 value: crate::hints::SDL_HINT_STORAGE_USER_DRIVER,
1910 doc: Some(
1911 "A variable that specifies a backend to use for user storage.\n\nBy default, SDL will try all available storage backends in a reasonable\norder until it finds one that can work, but this hint allows the app or\nuser to force a specific target, such as \"pc\" if, say, you are on Steam but\nwant to avoid SteamRemoteStorage for user data.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1912 ),
1913 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1914};
1915pub const METADATA_SDL_HINT_THREAD_FORCE_REALTIME_TIME_CRITICAL: Hint = Hint {
1916 module: "hints",
1917 name: "SDL_HINT_THREAD_FORCE_REALTIME_TIME_CRITICAL",
1918 short_name: "THREAD_FORCE_REALTIME_TIME_CRITICAL",
1919 value: crate::hints::SDL_HINT_THREAD_FORCE_REALTIME_TIME_CRITICAL,
1920 doc: Some(
1921 "Specifies whether [`SDL_THREAD_PRIORITY_TIME_CRITICAL`] should be treated as\nrealtime.\n\nOn some platforms, like Linux, a realtime priority thread may be subject to\nrestrictions that require special handling by the application. This hint\nexists to let SDL know that the app is prepared to handle said\nrestrictions.\n\nOn Linux, SDL will apply the following configuration to any thread that\nbecomes realtime:\n\n- The SCHED_RESET_ON_FORK bit will be set on the scheduling policy,\n- An RLIMIT_RTTIME budget will be configured to the rtkit specified limit.\n- Exceeding this limit will result in the kernel sending SIGKILL to the\napp, refer to the man pages for more information.\n\nThe variable can be set to the following values:\n\n- \"0\": default platform specific behaviour\n- \"1\": Force [`SDL_THREAD_PRIORITY_TIME_CRITICAL`] to a realtime scheduling\npolicy\n\nThis hint should be set before calling [`SDL_SetCurrentThreadPriority()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1922 ),
1923 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1924};
1925pub const METADATA_SDL_HINT_THREAD_PRIORITY_POLICY: Hint = Hint {
1926 module: "hints",
1927 name: "SDL_HINT_THREAD_PRIORITY_POLICY",
1928 short_name: "THREAD_PRIORITY_POLICY",
1929 value: crate::hints::SDL_HINT_THREAD_PRIORITY_POLICY,
1930 doc: Some(
1931 "A string specifying additional information to use with\n[`SDL_SetCurrentThreadPriority`].\n\nBy default [`SDL_SetCurrentThreadPriority`] will make appropriate system\nchanges in order to apply a thread priority. For example on systems using\npthreads the scheduler policy is changed automatically to a policy that\nworks well with a given priority. Code which has specific requirements can\noverride SDL's default behavior with this hint.\n\npthread hint values are \"current\", \"other\", \"fifo\" and \"rr\". Currently no\nother platform hint values are defined but may be in the future.\n\nOn Linux, the kernel may send SIGKILL to realtime tasks which exceed the\ndistro configured execution budget for rtkit. This budget can be queried\nthrough RLIMIT_RTTIME after calling [`SDL_SetCurrentThreadPriority()`].\n\nThis hint should be set before calling [`SDL_SetCurrentThreadPriority()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1932 ),
1933 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1934};
1935pub const METADATA_SDL_HINT_TIMER_RESOLUTION: Hint = Hint {
1936 module: "hints",
1937 name: "SDL_HINT_TIMER_RESOLUTION",
1938 short_name: "TIMER_RESOLUTION",
1939 value: crate::hints::SDL_HINT_TIMER_RESOLUTION,
1940 doc: Some(
1941 "A variable that controls the timer resolution, in milliseconds.\n\nThe higher resolution the timer, the more frequently the CPU services timer\ninterrupts, and the more precise delays are, but this takes up power and\nCPU time. This hint is only used on Windows.\n\nSee this blog post for more information:\n<http://randomascii.wordpress.com/2013/07/08/windows-timer-resolution-megawatts-wasted/>\n\nThe default value is \"1\".\n\nIf this variable is set to \"0\", the system timer resolution is not set.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1942 ),
1943 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1944};
1945pub const METADATA_SDL_HINT_TOUCH_MOUSE_EVENTS: Hint = Hint {
1946 module: "hints",
1947 name: "SDL_HINT_TOUCH_MOUSE_EVENTS",
1948 short_name: "TOUCH_MOUSE_EVENTS",
1949 value: crate::hints::SDL_HINT_TOUCH_MOUSE_EVENTS,
1950 doc: Some(
1951 "A variable controlling whether touch events should generate synthetic mouse\nevents.\n\nThe variable can be set to the following values:\n\n- \"0\": Touch events will not generate mouse events.\n- \"1\": Touch events will generate mouse events. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1952 ),
1953 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1954};
1955pub const METADATA_SDL_HINT_TRACKPAD_IS_TOUCH_ONLY: Hint = Hint {
1956 module: "hints",
1957 name: "SDL_HINT_TRACKPAD_IS_TOUCH_ONLY",
1958 short_name: "TRACKPAD_IS_TOUCH_ONLY",
1959 value: crate::hints::SDL_HINT_TRACKPAD_IS_TOUCH_ONLY,
1960 doc: Some(
1961 "A variable controlling whether trackpads should be treated as touch\ndevices.\n\nOn macOS (and possibly other platforms in the future), SDL will report\ntouches on a trackpad as mouse input, which is generally what users expect\nfrom this device; however, these are often actually full multitouch-capable\ntouch devices, so it might be preferable to some apps to treat them as\nsuch.\n\nThe variable can be set to the following values:\n\n- \"0\": Trackpad will send mouse events. (default)\n- \"1\": Trackpad will send touch events.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1962 ),
1963 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1964};
1965pub const METADATA_SDL_HINT_TV_REMOTE_AS_JOYSTICK: Hint = Hint {
1966 module: "hints",
1967 name: "SDL_HINT_TV_REMOTE_AS_JOYSTICK",
1968 short_name: "TV_REMOTE_AS_JOYSTICK",
1969 value: crate::hints::SDL_HINT_TV_REMOTE_AS_JOYSTICK,
1970 doc: Some(
1971 "A variable controlling whether the Android / tvOS remotes should be listed\nas joystick devices, instead of sending keyboard events.\n\nThe variable can be set to the following values:\n\n- \"0\": Remotes send enter/escape/arrow key events.\n- \"1\": Remotes are available as 2 axis, 2 button joysticks. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1972 ),
1973 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1974};
1975pub const METADATA_SDL_HINT_VIDEO_ALLOW_SCREENSAVER: Hint = Hint {
1976 module: "hints",
1977 name: "SDL_HINT_VIDEO_ALLOW_SCREENSAVER",
1978 short_name: "VIDEO_ALLOW_SCREENSAVER",
1979 value: crate::hints::SDL_HINT_VIDEO_ALLOW_SCREENSAVER,
1980 doc: Some(
1981 "A variable controlling whether the screensaver is enabled.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable screensaver. (default)\n- \"1\": Enable screensaver.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1982 ),
1983 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1984};
1985pub const METADATA_SDL_HINT_VIDEO_DISPLAY_PRIORITY: Hint = Hint {
1986 module: "hints",
1987 name: "SDL_HINT_VIDEO_DISPLAY_PRIORITY",
1988 short_name: "VIDEO_DISPLAY_PRIORITY",
1989 value: crate::hints::SDL_HINT_VIDEO_DISPLAY_PRIORITY,
1990 doc: Some(
1991 "A comma separated list containing the names of the displays that SDL should\nsort to the front of the display list.\n\nWhen this hint is set, displays with matching name strings will be\nprioritized in the list of displays, as exposed by calling\n[`SDL_GetDisplays()`], with the first listed becoming the primary display. The\nnaming convention can vary depending on the environment, but it is usually\na connector name (e.g. 'DP-1', 'DP-2', 'HDMI-A-1', etc...).\n\nOn Wayland desktops, the connector names associated with displays can be\nfound in the `name` property of the info output from `wayland-info -i\nwl_output`. On X11 desktops, the `xrandr` utility can be used to retrieve\nthe connector names associated with displays.\n\nThis hint is currently supported on the following drivers:\n\n- KMSDRM (kmsdrm)\n- Wayland (wayland)\n- X11 (x11)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
1992 ),
1993 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
1994};
1995pub const METADATA_SDL_HINT_VIDEO_DOUBLE_BUFFER: Hint = Hint {
1996 module: "hints",
1997 name: "SDL_HINT_VIDEO_DOUBLE_BUFFER",
1998 short_name: "VIDEO_DOUBLE_BUFFER",
1999 value: crate::hints::SDL_HINT_VIDEO_DOUBLE_BUFFER,
2000 doc: Some(
2001 "Tell the video driver that we only want a double buffer.\n\nBy default, most lowlevel 2D APIs will use a triple buffer scheme that\nwastes no CPU time on waiting for vsync after issuing a flip, but\nintroduces a frame of latency. On the other hand, using a double buffer\nscheme instead is recommended for cases where low latency is an important\nfactor because we save a whole frame of latency.\n\nWe do so by waiting for vsync immediately after issuing a flip, usually\njust after eglSwapBuffers call in the backend's *_SwapWindow function.\n\nThis hint is currently supported on the following drivers:\n\n- Raspberry Pi (raspberrypi)\n- Wayland (wayland)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2002 ),
2003 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2004};
2005pub const METADATA_SDL_HINT_VIDEO_DRIVER: Hint = Hint {
2006 module: "hints",
2007 name: "SDL_HINT_VIDEO_DRIVER",
2008 short_name: "VIDEO_DRIVER",
2009 value: crate::hints::SDL_HINT_VIDEO_DRIVER,
2010 doc: Some(
2011 "A variable that specifies a video backend to use.\n\nBy default, SDL will try all available video backends in a reasonable order\nuntil it finds one that can work, but this hint allows the app or user to\nforce a specific target, such as \"x11\" if, say, you are on Wayland but want\nto try talking to the X server instead.\n\nThis hint accepts a comma-separated list of driver names, and each will be\ntried in the order listed during init, until one succeeds or all of them\nfail.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2012 ),
2013 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2014};
2015pub const METADATA_SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES: Hint = Hint {
2016 module: "hints",
2017 name: "SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES",
2018 short_name: "VIDEO_DUMMY_SAVE_FRAMES",
2019 value: crate::hints::SDL_HINT_VIDEO_DUMMY_SAVE_FRAMES,
2020 doc: Some(
2021 "A variable controlling whether the dummy video driver saves output frames.\n\n- \"0\": Video frames are not saved to disk. (default)\n- \"1\": Video frames are saved to files in the format \"SDL_windowX-Y.bmp\",\nwhere X is the window ID, and Y is the frame number.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2022 ),
2023 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2024};
2025pub const METADATA_SDL_HINT_VIDEO_EGL_ALLOW_GETDISPLAY_FALLBACK: Hint = Hint {
2026 module: "hints",
2027 name: "SDL_HINT_VIDEO_EGL_ALLOW_GETDISPLAY_FALLBACK",
2028 short_name: "VIDEO_EGL_ALLOW_GETDISPLAY_FALLBACK",
2029 value: crate::hints::SDL_HINT_VIDEO_EGL_ALLOW_GETDISPLAY_FALLBACK,
2030 doc: Some(
2031 "If eglGetPlatformDisplay fails, fall back to calling eglGetDisplay.\n\nThe variable can be set to one of the following values:\n\n- \"0\": Do not fall back to eglGetDisplay.\n- \"1\": Fall back to eglGetDisplay if eglGetPlatformDisplay fails. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2032 ),
2033 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2034};
2035pub const METADATA_SDL_HINT_VIDEO_FORCE_EGL: Hint = Hint {
2036 module: "hints",
2037 name: "SDL_HINT_VIDEO_FORCE_EGL",
2038 short_name: "VIDEO_FORCE_EGL",
2039 value: crate::hints::SDL_HINT_VIDEO_FORCE_EGL,
2040 doc: Some(
2041 "A variable controlling whether the OpenGL context should be created with\nEGL.\n\nThe variable can be set to the following values:\n\n- \"0\": Use platform-specific GL context creation API (GLX, WGL, CGL, etc).\n(default)\n- \"1\": Use EGL\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2042 ),
2043 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2044};
2045pub const METADATA_SDL_HINT_VIDEO_MAC_FULLSCREEN_SPACES: Hint = Hint {
2046 module: "hints",
2047 name: "SDL_HINT_VIDEO_MAC_FULLSCREEN_SPACES",
2048 short_name: "VIDEO_MAC_FULLSCREEN_SPACES",
2049 value: crate::hints::SDL_HINT_VIDEO_MAC_FULLSCREEN_SPACES,
2050 doc: Some(
2051 "A variable that specifies the policy for fullscreen Spaces on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable Spaces support (FULLSCREEN_DESKTOP won't use them and\n[`SDL_WINDOW_RESIZABLE`] windows won't offer the \"fullscreen\" button on their\ntitlebars).\n- \"1\": Enable Spaces support (FULLSCREEN_DESKTOP will use them and\n[`SDL_WINDOW_RESIZABLE`] windows will offer the \"fullscreen\" button on their\ntitlebars). (default)\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2052 ),
2053 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2054};
2055pub const METADATA_SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY: Hint = Hint {
2056 module: "hints",
2057 name: "SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY",
2058 short_name: "VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY",
2059 value: crate::hints::SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY,
2060 doc: Some(
2061 "A variable that specifies the menu visibility when a window is fullscreen\nin Spaces on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": The menu will be hidden when the window is in a fullscreen space,\nand not accessible by moving the mouse to the top of the screen.\n- \"1\": The menu will be accessible when the window is in a fullscreen\nspace.\n- \"auto\": The menu will be hidden if fullscreen mode was toggled on\nprogrammatically via `SDL_SetWindowFullscreen()`, and accessible if\nfullscreen was entered via the \"fullscreen\" button on the window title\nbar. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2062 ),
2063 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2064};
2065pub const METADATA_SDL_HINT_VIDEO_METAL_AUTO_RESIZE_DRAWABLE: Hint = Hint {
2066 module: "hints",
2067 name: "SDL_HINT_VIDEO_METAL_AUTO_RESIZE_DRAWABLE",
2068 short_name: "VIDEO_METAL_AUTO_RESIZE_DRAWABLE",
2069 value: crate::hints::SDL_HINT_VIDEO_METAL_AUTO_RESIZE_DRAWABLE,
2070 doc: Some(
2071 "A variable indicating whether the metal layer drawable size should be\nupdated for the [`SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED`] event on macOS.\n\nThe variable can be set to the following values:\n\n- \"0\": the metal layer drawable size will not be updated on the\n[`SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED`] event.\n- \"1\": the metal layer drawable size will be updated on the\n[`SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED`] event. (default)\n\nThis hint should be set before [`SDL_Metal_CreateView`] called.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
2072 ),
2073 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
2074};
2075pub const METADATA_SDL_HINT_VIDEO_MATCH_EXCLUSIVE_MODE_ON_MOVE: Hint = Hint {
2076 module: "hints",
2077 name: "SDL_HINT_VIDEO_MATCH_EXCLUSIVE_MODE_ON_MOVE",
2078 short_name: "VIDEO_MATCH_EXCLUSIVE_MODE_ON_MOVE",
2079 value: crate::hints::SDL_HINT_VIDEO_MATCH_EXCLUSIVE_MODE_ON_MOVE,
2080 doc: Some(
2081 "A variable controlling whether SDL will attempt to automatically set the\ndestination display to a mode most closely matching that of the previous\ndisplay if an exclusive fullscreen window is moved onto it.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will not attempt to automatically set a matching mode on the\ndestination display. If an exclusive fullscreen window is moved to a new\ndisplay, the window will become fullscreen desktop.\n- \"1\": SDL will attempt to automatically set a mode on the destination\ndisplay that most closely matches the mode of the display that the\nexclusive fullscreen window was previously on. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
2082 ),
2083 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
2084};
2085pub const METADATA_SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS: Hint = Hint {
2086 module: "hints",
2087 name: "SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS",
2088 short_name: "VIDEO_MINIMIZE_ON_FOCUS_LOSS",
2089 value: crate::hints::SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS,
2090 doc: Some(
2091 "A variable controlling whether fullscreen windows are minimized when they\nlose focus.\n\nThe variable can be set to the following values:\n\n- \"0\": Fullscreen windows will not be minimized when they lose focus.\n- \"1\": Fullscreen windows are minimized when they lose focus.\n- \"auto\": Fullscreen windows are minimized when they lose focus if they use\nexclusive fullscreen modes, so the desktop video mode is restored.\n(default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2092 ),
2093 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2094};
2095pub const METADATA_SDL_HINT_VIDEO_OFFSCREEN_SAVE_FRAMES: Hint = Hint {
2096 module: "hints",
2097 name: "SDL_HINT_VIDEO_OFFSCREEN_SAVE_FRAMES",
2098 short_name: "VIDEO_OFFSCREEN_SAVE_FRAMES",
2099 value: crate::hints::SDL_HINT_VIDEO_OFFSCREEN_SAVE_FRAMES,
2100 doc: Some(
2101 "A variable controlling whether the offscreen video driver saves output\nframes.\n\nThis only saves frames that are generated using software rendering, not\naccelerated OpenGL rendering.\n\n- \"0\": Video frames are not saved to disk. (default)\n- \"1\": Video frames are saved to files in the format \"SDL_windowX-Y.bmp\",\nwhere X is the window ID, and Y is the frame number.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2102 ),
2103 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2104};
2105pub const METADATA_SDL_HINT_VIDEO_SYNC_WINDOW_OPERATIONS: Hint = Hint {
2106 module: "hints",
2107 name: "SDL_HINT_VIDEO_SYNC_WINDOW_OPERATIONS",
2108 short_name: "VIDEO_SYNC_WINDOW_OPERATIONS",
2109 value: crate::hints::SDL_HINT_VIDEO_SYNC_WINDOW_OPERATIONS,
2110 doc: Some(
2111 "A variable controlling whether all window operations will block until\ncomplete.\n\nWindow systems that run asynchronously may not have the results of window\noperations that resize or move the window applied immediately upon the\nreturn of the requesting function. Setting this hint will cause such\noperations to block after every call until the pending operation has\ncompleted. Setting this to '1' is the equivalent of calling\n[`SDL_SyncWindow()`] after every function call.\n\nBe aware that amount of time spent blocking while waiting for window\noperations to complete can be quite lengthy, as animations may have to\ncomplete, which can take upwards of multiple seconds in some cases.\n\nThe variable can be set to the following values:\n\n- \"0\": Window operations are non-blocking. (default)\n- \"1\": Window operations will block until completed.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2112 ),
2113 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2114};
2115pub const METADATA_SDL_HINT_VIDEO_WAYLAND_ALLOW_LIBDECOR: Hint = Hint {
2116 module: "hints",
2117 name: "SDL_HINT_VIDEO_WAYLAND_ALLOW_LIBDECOR",
2118 short_name: "VIDEO_WAYLAND_ALLOW_LIBDECOR",
2119 value: crate::hints::SDL_HINT_VIDEO_WAYLAND_ALLOW_LIBDECOR,
2120 doc: Some(
2121 "A variable controlling whether the libdecor Wayland backend is allowed to\nbe used.\n\nlibdecor is used over xdg-shell when xdg-decoration protocol is\nunavailable.\n\nThe variable can be set to the following values:\n\n- \"0\": libdecor use is disabled.\n- \"1\": libdecor use is enabled. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2122 ),
2123 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2124};
2125pub const METADATA_SDL_HINT_VIDEO_WAYLAND_MODE_EMULATION: Hint = Hint {
2126 module: "hints",
2127 name: "SDL_HINT_VIDEO_WAYLAND_MODE_EMULATION",
2128 short_name: "VIDEO_WAYLAND_MODE_EMULATION",
2129 value: crate::hints::SDL_HINT_VIDEO_WAYLAND_MODE_EMULATION,
2130 doc: Some(
2131 "A variable controlling whether video mode emulation is enabled under\nWayland.\n\nWhen this hint is set, a standard set of emulated CVT video modes will be\nexposed for use by the application. If it is disabled, the only modes\nexposed will be the logical desktop size and, in the case of a scaled\ndesktop, the native display resolution.\n\nThe variable can be set to the following values:\n\n- \"0\": Video mode emulation is disabled.\n- \"1\": Video mode emulation is enabled. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2132 ),
2133 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2134};
2135pub const METADATA_SDL_HINT_VIDEO_WAYLAND_MODE_SCALING: Hint = Hint {
2136 module: "hints",
2137 name: "SDL_HINT_VIDEO_WAYLAND_MODE_SCALING",
2138 short_name: "VIDEO_WAYLAND_MODE_SCALING",
2139 value: crate::hints::SDL_HINT_VIDEO_WAYLAND_MODE_SCALING,
2140 doc: Some(
2141 "A variable controlling how modes with a non-native aspect ratio are\ndisplayed under Wayland.\n\nWhen this hint is set, the requested scaling will be used when displaying\nfullscreen video modes that don't match the display's native aspect ratio.\nThis is contingent on compositor viewport support.\n\nThe variable can be set to the following values:\n\n- \"aspect\" - Video modes will be displayed scaled, in their proper aspect\nratio, with black bars.\n- \"stretch\" - Video modes will be scaled to fill the entire display.\n(default)\n- \"none\" - Video modes will be displayed as 1:1 with no scaling.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2142 ),
2143 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2144};
2145pub const METADATA_SDL_HINT_VIDEO_WAYLAND_PREFER_LIBDECOR: Hint = Hint {
2146 module: "hints",
2147 name: "SDL_HINT_VIDEO_WAYLAND_PREFER_LIBDECOR",
2148 short_name: "VIDEO_WAYLAND_PREFER_LIBDECOR",
2149 value: crate::hints::SDL_HINT_VIDEO_WAYLAND_PREFER_LIBDECOR,
2150 doc: Some(
2151 "A variable controlling whether the libdecor Wayland backend is preferred\nover native decorations.\n\nWhen this hint is set, libdecor will be used to provide window decorations,\neven if xdg-decoration is available. (Note that, by default, libdecor will\nuse xdg-decoration itself if available).\n\nThe variable can be set to the following values:\n\n- \"0\": libdecor is enabled only if server-side decorations are unavailable.\n(default)\n- \"1\": libdecor is always enabled if available.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2152 ),
2153 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2154};
2155pub const METADATA_SDL_HINT_VIDEO_WAYLAND_SCALE_TO_DISPLAY: Hint = Hint {
2156 module: "hints",
2157 name: "SDL_HINT_VIDEO_WAYLAND_SCALE_TO_DISPLAY",
2158 short_name: "VIDEO_WAYLAND_SCALE_TO_DISPLAY",
2159 value: crate::hints::SDL_HINT_VIDEO_WAYLAND_SCALE_TO_DISPLAY,
2160 doc: Some(
2161 "A variable forcing non-DPI-aware Wayland windows to output at 1:1 scaling.\n\nThis must be set before initializing the video subsystem.\n\nWhen this hint is set, Wayland windows that are not flagged as being\nDPI-aware will be output with scaling designed to force 1:1 pixel mapping.\n\nThis is intended to allow legacy applications to be displayed without\ndesktop scaling being applied, and has issues with certain display\nconfigurations, as this forces the window to behave in a way that Wayland\ndesktops were not designed to accommodate:\n\n- Rounding errors can result with odd window sizes and/or desktop scales,\nwhich can cause the window contents to appear slightly blurry.\n- Positioning the window may be imprecise due to unit conversions and\nrounding.\n- The window may be unusably small on scaled desktops.\n- The window may jump in size when moving between displays of different\nscale factors.\n- Displays may appear to overlap when using a multi-monitor setup with\nscaling enabled.\n- Possible loss of cursor precision due to the logical size of the window\nbeing reduced.\n\nNew applications should be designed with proper DPI awareness handling\ninstead of enabling this.\n\nThe variable can be set to the following values:\n\n- \"0\": Windows will be scaled normally.\n- \"1\": Windows will be forced to scale to achieve 1:1 output.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2162 ),
2163 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2164};
2165pub const METADATA_SDL_HINT_VIDEO_WIN_D3DCOMPILER: Hint = Hint {
2166 module: "hints",
2167 name: "SDL_HINT_VIDEO_WIN_D3DCOMPILER",
2168 short_name: "VIDEO_WIN_D3DCOMPILER",
2169 value: crate::hints::SDL_HINT_VIDEO_WIN_D3DCOMPILER,
2170 doc: Some(
2171 "A variable specifying which shader compiler to preload when using the\nChrome ANGLE binaries.\n\nSDL has EGL and OpenGL ES2 support on Windows via the ANGLE project. It can\nuse two different sets of binaries, those compiled by the user from source\nor those provided by the Chrome browser. In the later case, these binaries\nrequire that SDL loads a DLL providing the shader compiler.\n\nThe variable can be set to the following values:\n\n- \"d3dcompiler_46.dll\" - best for Vista or later. (default)\n- \"d3dcompiler_43.dll\" - for XP support.\n- \"none\" - do not load any library, useful if you compiled ANGLE from\nsource and included the compiler in your binaries.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2172 ),
2173 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2174};
2175pub const METADATA_SDL_HINT_VIDEO_X11_EXTERNAL_WINDOW_INPUT: Hint = Hint {
2176 module: "hints",
2177 name: "SDL_HINT_VIDEO_X11_EXTERNAL_WINDOW_INPUT",
2178 short_name: "VIDEO_X11_EXTERNAL_WINDOW_INPUT",
2179 value: crate::hints::SDL_HINT_VIDEO_X11_EXTERNAL_WINDOW_INPUT,
2180 doc: Some(
2181 "A variable controlling whether SDL should call XSelectInput() to enable\ninput events on X11 windows wrapped by SDL windows.\n\nThe variable can be set to the following values:\n\n- \"0\": Don't call XSelectInput(), assuming the native window code has done\nit already.\n- \"1\": Call XSelectInput() to enable input events. (default)\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.10.\n",
2182 ),
2183 available_since: Some(SDL_VERSIONNUM(3, 2, 10)),
2184};
2185pub const METADATA_SDL_HINT_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR: Hint = Hint {
2186 module: "hints",
2187 name: "SDL_HINT_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR",
2188 short_name: "VIDEO_X11_NET_WM_BYPASS_COMPOSITOR",
2189 value: crate::hints::SDL_HINT_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR,
2190 doc: Some(
2191 "A variable controlling whether the X11 _NET_WM_BYPASS_COMPOSITOR hint\nshould be used.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable _NET_WM_BYPASS_COMPOSITOR.\n- \"1\": Enable _NET_WM_BYPASS_COMPOSITOR. (default)\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2192 ),
2193 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2194};
2195pub const METADATA_SDL_HINT_VIDEO_X11_NET_WM_PING: Hint = Hint {
2196 module: "hints",
2197 name: "SDL_HINT_VIDEO_X11_NET_WM_PING",
2198 short_name: "VIDEO_X11_NET_WM_PING",
2199 value: crate::hints::SDL_HINT_VIDEO_X11_NET_WM_PING,
2200 doc: Some(
2201 "A variable controlling whether the X11 _NET_WM_PING protocol should be\nsupported.\n\nBy default SDL will use _NET_WM_PING, but for applications that know they\nwill not always be able to respond to ping requests in a timely manner they\ncan turn it off to avoid the window manager thinking the app is hung.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable _NET_WM_PING.\n- \"1\": Enable _NET_WM_PING. (default)\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2202 ),
2203 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2204};
2205pub const METADATA_SDL_HINT_VIDEO_X11_NODIRECTCOLOR: Hint = Hint {
2206 module: "hints",
2207 name: "SDL_HINT_VIDEO_X11_NODIRECTCOLOR",
2208 short_name: "VIDEO_X11_NODIRECTCOLOR",
2209 value: crate::hints::SDL_HINT_VIDEO_X11_NODIRECTCOLOR,
2210 doc: Some(
2211 "A variable controlling whether SDL uses DirectColor visuals.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable DirectColor visuals.\n- \"1\": Enable DirectColor visuals. (default)\n\nThis hint should be set before initializing the video subsystem.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2212 ),
2213 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2214};
2215pub const METADATA_SDL_HINT_VIDEO_X11_SCALING_FACTOR: Hint = Hint {
2216 module: "hints",
2217 name: "SDL_HINT_VIDEO_X11_SCALING_FACTOR",
2218 short_name: "VIDEO_X11_SCALING_FACTOR",
2219 value: crate::hints::SDL_HINT_VIDEO_X11_SCALING_FACTOR,
2220 doc: Some(
2221 "A variable forcing the content scaling factor for X11 displays.\n\nThe variable can be set to a floating point value in the range 1.0-10.0f\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2222 ),
2223 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2224};
2225pub const METADATA_SDL_HINT_VIDEO_X11_VISUALID: Hint = Hint {
2226 module: "hints",
2227 name: "SDL_HINT_VIDEO_X11_VISUALID",
2228 short_name: "VIDEO_X11_VISUALID",
2229 value: crate::hints::SDL_HINT_VIDEO_X11_VISUALID,
2230 doc: Some(
2231 "A variable forcing the visual ID used for X11 display modes.\n\nThis hint should be set before initializing the video subsystem.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2232 ),
2233 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2234};
2235pub const METADATA_SDL_HINT_VIDEO_X11_WINDOW_VISUALID: Hint = Hint {
2236 module: "hints",
2237 name: "SDL_HINT_VIDEO_X11_WINDOW_VISUALID",
2238 short_name: "VIDEO_X11_WINDOW_VISUALID",
2239 value: crate::hints::SDL_HINT_VIDEO_X11_WINDOW_VISUALID,
2240 doc: Some(
2241 "A variable forcing the visual ID chosen for new X11 windows.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2242 ),
2243 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2244};
2245pub const METADATA_SDL_HINT_VIDEO_X11_XRANDR: Hint = Hint {
2246 module: "hints",
2247 name: "SDL_HINT_VIDEO_X11_XRANDR",
2248 short_name: "VIDEO_X11_XRANDR",
2249 value: crate::hints::SDL_HINT_VIDEO_X11_XRANDR,
2250 doc: Some(
2251 "A variable controlling whether the X11 XRandR extension should be used.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable XRandR.\n- \"1\": Enable XRandR. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2252 ),
2253 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2254};
2255pub const METADATA_SDL_HINT_VITA_ENABLE_BACK_TOUCH: Hint = Hint {
2256 module: "hints",
2257 name: "SDL_HINT_VITA_ENABLE_BACK_TOUCH",
2258 short_name: "VITA_ENABLE_BACK_TOUCH",
2259 value: crate::hints::SDL_HINT_VITA_ENABLE_BACK_TOUCH,
2260 doc: Some(
2261 "A variable controlling whether touch should be enabled on the back panel of\nthe PlayStation Vita.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable touch on the back panel.\n- \"1\": Enable touch on the back panel. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2262 ),
2263 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2264};
2265pub const METADATA_SDL_HINT_VITA_ENABLE_FRONT_TOUCH: Hint = Hint {
2266 module: "hints",
2267 name: "SDL_HINT_VITA_ENABLE_FRONT_TOUCH",
2268 short_name: "VITA_ENABLE_FRONT_TOUCH",
2269 value: crate::hints::SDL_HINT_VITA_ENABLE_FRONT_TOUCH,
2270 doc: Some(
2271 "A variable controlling whether touch should be enabled on the front panel\nof the PlayStation Vita.\n\nThe variable can be set to the following values:\n\n- \"0\": Disable touch on the front panel.\n- \"1\": Enable touch on the front panel. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2272 ),
2273 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2274};
2275pub const METADATA_SDL_HINT_VITA_MODULE_PATH: Hint = Hint {
2276 module: "hints",
2277 name: "SDL_HINT_VITA_MODULE_PATH",
2278 short_name: "VITA_MODULE_PATH",
2279 value: crate::hints::SDL_HINT_VITA_MODULE_PATH,
2280 doc: Some(
2281 "A variable controlling the module path on the PlayStation Vita.\n\nThis hint defaults to \"app0:module\"\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2282 ),
2283 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2284};
2285pub const METADATA_SDL_HINT_VITA_PVR_INIT: Hint = Hint {
2286 module: "hints",
2287 name: "SDL_HINT_VITA_PVR_INIT",
2288 short_name: "VITA_PVR_INIT",
2289 value: crate::hints::SDL_HINT_VITA_PVR_INIT,
2290 doc: Some(
2291 "A variable controlling whether to perform PVR initialization on the\nPlayStation Vita.\n\n- \"0\": Skip PVR initialization.\n- \"1\": Perform the normal PVR initialization. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2292 ),
2293 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2294};
2295pub const METADATA_SDL_HINT_VITA_RESOLUTION: Hint = Hint {
2296 module: "hints",
2297 name: "SDL_HINT_VITA_RESOLUTION",
2298 short_name: "VITA_RESOLUTION",
2299 value: crate::hints::SDL_HINT_VITA_RESOLUTION,
2300 doc: Some(
2301 "A variable overriding the resolution reported on the PlayStation Vita.\n\nThe variable can be set to the following values:\n\n- \"544\": 544p (default)\n- \"720\": 725p for PSTV\n- \"1080\": 1088i for PSTV\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2302 ),
2303 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2304};
2305pub const METADATA_SDL_HINT_VITA_PVR_OPENGL: Hint = Hint {
2306 module: "hints",
2307 name: "SDL_HINT_VITA_PVR_OPENGL",
2308 short_name: "VITA_PVR_OPENGL",
2309 value: crate::hints::SDL_HINT_VITA_PVR_OPENGL,
2310 doc: Some(
2311 "A variable controlling whether OpenGL should be used instead of OpenGL ES\non the PlayStation Vita.\n\nThe variable can be set to the following values:\n\n- \"0\": Use OpenGL ES. (default)\n- \"1\": Use OpenGL.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2312 ),
2313 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2314};
2315pub const METADATA_SDL_HINT_VITA_TOUCH_MOUSE_DEVICE: Hint = Hint {
2316 module: "hints",
2317 name: "SDL_HINT_VITA_TOUCH_MOUSE_DEVICE",
2318 short_name: "VITA_TOUCH_MOUSE_DEVICE",
2319 value: crate::hints::SDL_HINT_VITA_TOUCH_MOUSE_DEVICE,
2320 doc: Some(
2321 "A variable controlling which touchpad should generate synthetic mouse\nevents.\n\nThe variable can be set to the following values:\n\n- \"0\": Only front touchpad should generate mouse events. (default)\n- \"1\": Only back touchpad should generate mouse events.\n- \"2\": Both touchpads should generate mouse events.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2322 ),
2323 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2324};
2325pub const METADATA_SDL_HINT_VULKAN_DISPLAY: Hint = Hint {
2326 module: "hints",
2327 name: "SDL_HINT_VULKAN_DISPLAY",
2328 short_name: "VULKAN_DISPLAY",
2329 value: crate::hints::SDL_HINT_VULKAN_DISPLAY,
2330 doc: Some(
2331 "A variable overriding the display index used in [`SDL_Vulkan_CreateSurface()`]\n\nThe display index starts at 0, which is the default.\n\nThis hint should be set before calling [`SDL_Vulkan_CreateSurface()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2332 ),
2333 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2334};
2335pub const METADATA_SDL_HINT_VULKAN_LIBRARY: Hint = Hint {
2336 module: "hints",
2337 name: "SDL_HINT_VULKAN_LIBRARY",
2338 short_name: "VULKAN_LIBRARY",
2339 value: crate::hints::SDL_HINT_VULKAN_LIBRARY,
2340 doc: Some(
2341 "Specify the Vulkan library to load.\n\nThis hint should be set before creating a Vulkan window or calling\n[`SDL_Vulkan_LoadLibrary()`].\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2342 ),
2343 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2344};
2345pub const METADATA_SDL_HINT_WAVE_FACT_CHUNK: Hint = Hint {
2346 module: "hints",
2347 name: "SDL_HINT_WAVE_FACT_CHUNK",
2348 short_name: "WAVE_FACT_CHUNK",
2349 value: crate::hints::SDL_HINT_WAVE_FACT_CHUNK,
2350 doc: Some(
2351 "A variable controlling how the fact chunk affects the loading of a WAVE\nfile.\n\nThe fact chunk stores information about the number of samples of a WAVE\nfile. The Standards Update from Microsoft notes that this value can be used\nto 'determine the length of the data in seconds'. This is especially useful\nfor compressed formats (for which this is a mandatory chunk) if they\nproduce multiple sample frames per block and truncating the block is not\nallowed. The fact chunk can exactly specify how many sample frames there\nshould be in this case.\n\nUnfortunately, most application seem to ignore the fact chunk and so SDL\nignores it by default as well.\n\nThe variable can be set to the following values:\n\n- \"truncate\" - Use the number of samples to truncate the wave data if the\nfact chunk is present and valid.\n- \"strict\" - Like \"truncate\", but raise an error if the fact chunk is\ninvalid, not present for non-PCM formats, or if the data chunk doesn't\nhave that many samples.\n- \"ignorezero\" - Like \"truncate\", but ignore fact chunk if the number of\nsamples is zero.\n- \"ignore\" - Ignore fact chunk entirely. (default)\n\nThis hint should be set before calling [`SDL_LoadWAV()`] or [`SDL_LoadWAV_IO()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2352 ),
2353 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2354};
2355pub const METADATA_SDL_HINT_WAVE_CHUNK_LIMIT: Hint = Hint {
2356 module: "hints",
2357 name: "SDL_HINT_WAVE_CHUNK_LIMIT",
2358 short_name: "WAVE_CHUNK_LIMIT",
2359 value: crate::hints::SDL_HINT_WAVE_CHUNK_LIMIT,
2360 doc: Some(
2361 "A variable controlling the maximum number of chunks in a WAVE file.\n\nThis sets an upper bound on the number of chunks in a WAVE file to avoid\nwasting time on malformed or corrupt WAVE files. This defaults to \"10000\".\n\nThis hint should be set before calling [`SDL_LoadWAV()`] or [`SDL_LoadWAV_IO()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2362 ),
2363 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2364};
2365pub const METADATA_SDL_HINT_WAVE_RIFF_CHUNK_SIZE: Hint = Hint {
2366 module: "hints",
2367 name: "SDL_HINT_WAVE_RIFF_CHUNK_SIZE",
2368 short_name: "WAVE_RIFF_CHUNK_SIZE",
2369 value: crate::hints::SDL_HINT_WAVE_RIFF_CHUNK_SIZE,
2370 doc: Some(
2371 "A variable controlling how the size of the RIFF chunk affects the loading\nof a WAVE file.\n\nThe size of the RIFF chunk (which includes all the sub-chunks of the WAVE\nfile) is not always reliable. In case the size is wrong, it's possible to\njust ignore it and step through the chunks until a fixed limit is reached.\n\nNote that files that have trailing data unrelated to the WAVE file or\ncorrupt files may slow down the loading process without a reliable\nboundary. By default, SDL stops after 10000 chunks to prevent wasting time.\nUse [`SDL_HINT_WAVE_CHUNK_LIMIT`] to adjust this value.\n\nThe variable can be set to the following values:\n\n- \"force\" - Always use the RIFF chunk size as a boundary for the chunk\nsearch.\n- \"ignorezero\" - Like \"force\", but a zero size searches up to 4 GiB.\n(default)\n- \"ignore\" - Ignore the RIFF chunk size and always search up to 4 GiB.\n- \"maximum\" - Search for chunks until the end of file. (not recommended)\n\nThis hint should be set before calling [`SDL_LoadWAV()`] or [`SDL_LoadWAV_IO()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2372 ),
2373 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2374};
2375pub const METADATA_SDL_HINT_WAVE_TRUNCATION: Hint = Hint {
2376 module: "hints",
2377 name: "SDL_HINT_WAVE_TRUNCATION",
2378 short_name: "WAVE_TRUNCATION",
2379 value: crate::hints::SDL_HINT_WAVE_TRUNCATION,
2380 doc: Some(
2381 "A variable controlling how a truncated WAVE file is handled.\n\nA WAVE file is considered truncated if any of the chunks are incomplete or\nthe data chunk size is not a multiple of the block size. By default, SDL\ndecodes until the first incomplete block, as most applications seem to do.\n\nThe variable can be set to the following values:\n\n- \"verystrict\" - Raise an error if the file is truncated.\n- \"strict\" - Like \"verystrict\", but the size of the RIFF chunk is ignored.\n- \"dropframe\" - Decode until the first incomplete sample frame.\n- \"dropblock\" - Decode until the first incomplete block. (default)\n\nThis hint should be set before calling [`SDL_LoadWAV()`] or [`SDL_LoadWAV_IO()`]\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2382 ),
2383 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2384};
2385pub const METADATA_SDL_HINT_WINDOW_ACTIVATE_WHEN_RAISED: Hint = Hint {
2386 module: "hints",
2387 name: "SDL_HINT_WINDOW_ACTIVATE_WHEN_RAISED",
2388 short_name: "WINDOW_ACTIVATE_WHEN_RAISED",
2389 value: crate::hints::SDL_HINT_WINDOW_ACTIVATE_WHEN_RAISED,
2390 doc: Some(
2391 "A variable controlling whether the window is activated when the\n[`SDL_RaiseWindow`] function is called.\n\nThe variable can be set to the following values:\n\n- \"0\": The window is not activated when the [`SDL_RaiseWindow`] function is\ncalled.\n- \"1\": The window is activated when the [`SDL_RaiseWindow`] function is called.\n(default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2392 ),
2393 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2394};
2395pub const METADATA_SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN: Hint = Hint {
2396 module: "hints",
2397 name: "SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN",
2398 short_name: "WINDOW_ACTIVATE_WHEN_SHOWN",
2399 value: crate::hints::SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN,
2400 doc: Some(
2401 "A variable controlling whether the window is activated when the\n[`SDL_ShowWindow`] function is called.\n\nThe variable can be set to the following values:\n\n- \"0\": The window is not activated when the [`SDL_ShowWindow`] function is\ncalled.\n- \"1\": The window is activated when the [`SDL_ShowWindow`] function is called.\n(default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2402 ),
2403 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2404};
2405pub const METADATA_SDL_HINT_WINDOW_ALLOW_TOPMOST: Hint = Hint {
2406 module: "hints",
2407 name: "SDL_HINT_WINDOW_ALLOW_TOPMOST",
2408 short_name: "WINDOW_ALLOW_TOPMOST",
2409 value: crate::hints::SDL_HINT_WINDOW_ALLOW_TOPMOST,
2410 doc: Some(
2411 "If set to \"0\" then never set the top-most flag on an SDL Window even if the\napplication requests it.\n\nThis is a debugging aid for developers and not expected to be used by end\nusers.\n\nThe variable can be set to the following values:\n\n- \"0\": don't allow topmost\n- \"1\": allow topmost (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2412 ),
2413 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2414};
2415pub const METADATA_SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN: Hint = Hint {
2416 module: "hints",
2417 name: "SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN",
2418 short_name: "WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN",
2419 value: crate::hints::SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN,
2420 doc: Some(
2421 "A variable controlling whether the window frame and title bar are\ninteractive when the cursor is hidden.\n\nThe variable can be set to the following values:\n\n- \"0\": The window frame is not interactive when the cursor is hidden (no\nmove, resize, etc).\n- \"1\": The window frame is interactive when the cursor is hidden. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2422 ),
2423 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2424};
2425pub const METADATA_SDL_HINT_WINDOWS_CLOSE_ON_ALT_F4: Hint = Hint {
2426 module: "hints",
2427 name: "SDL_HINT_WINDOWS_CLOSE_ON_ALT_F4",
2428 short_name: "WINDOWS_CLOSE_ON_ALT_F4",
2429 value: crate::hints::SDL_HINT_WINDOWS_CLOSE_ON_ALT_F4,
2430 doc: Some(
2431 "A variable controlling whether SDL generates window-close events for Alt+F4\non Windows.\n\nThe variable can be set to the following values:\n\n- \"0\": SDL will only do normal key handling for Alt+F4.\n- \"1\": SDL will generate a window-close event when it sees Alt+F4.\n(default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2432 ),
2433 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2434};
2435pub const METADATA_SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS: Hint = Hint {
2436 module: "hints",
2437 name: "SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS",
2438 short_name: "WINDOWS_ENABLE_MENU_MNEMONICS",
2439 value: crate::hints::SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS,
2440 doc: Some(
2441 "A variable controlling whether menus can be opened with their keyboard\nshortcut (Alt+mnemonic).\n\nIf the mnemonics are enabled, then menus can be opened by pressing the Alt\nkey and the corresponding mnemonic (for example, Alt+F opens the File\nmenu). However, in case an invalid mnemonic is pressed, Windows makes an\naudible beep to convey that nothing happened. This is true even if the\nwindow has no menu at all!\n\nBecause most SDL applications don't have menus, and some want to use the\nAlt key for other purposes, SDL disables mnemonics (and the beeping) by\ndefault.\n\nNote: This also affects keyboard events: with mnemonics enabled, when a\nmenu is opened from the keyboard, you will not receive a KEYUP event for\nthe mnemonic key, and *might* not receive one for Alt.\n\nThe variable can be set to the following values:\n\n- \"0\": Alt+mnemonic does nothing, no beeping. (default)\n- \"1\": Alt+mnemonic opens menus, invalid mnemonics produce a beep.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2442 ),
2443 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2444};
2445pub const METADATA_SDL_HINT_WINDOWS_ENABLE_MESSAGELOOP: Hint = Hint {
2446 module: "hints",
2447 name: "SDL_HINT_WINDOWS_ENABLE_MESSAGELOOP",
2448 short_name: "WINDOWS_ENABLE_MESSAGELOOP",
2449 value: crate::hints::SDL_HINT_WINDOWS_ENABLE_MESSAGELOOP,
2450 doc: Some(
2451 "A variable controlling whether the windows message loop is processed by\nSDL.\n\nThe variable can be set to the following values:\n\n- \"0\": The window message loop is not run.\n- \"1\": The window message loop is processed in [`SDL_PumpEvents()`]. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2452 ),
2453 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2454};
2455pub const METADATA_SDL_HINT_WINDOWS_GAMEINPUT: Hint = Hint {
2456 module: "hints",
2457 name: "SDL_HINT_WINDOWS_GAMEINPUT",
2458 short_name: "WINDOWS_GAMEINPUT",
2459 value: crate::hints::SDL_HINT_WINDOWS_GAMEINPUT,
2460 doc: Some(
2461 "A variable controlling whether GameInput is used for raw keyboard and mouse\non Windows.\n\nThe variable can be set to the following values:\n\n- \"0\": GameInput is not used for raw keyboard and mouse events. (default)\n- \"1\": GameInput is used for raw keyboard and mouse events, if available.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2462 ),
2463 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2464};
2465pub const METADATA_SDL_HINT_WINDOWS_RAW_KEYBOARD: Hint = Hint {
2466 module: "hints",
2467 name: "SDL_HINT_WINDOWS_RAW_KEYBOARD",
2468 short_name: "WINDOWS_RAW_KEYBOARD",
2469 value: crate::hints::SDL_HINT_WINDOWS_RAW_KEYBOARD,
2470 doc: Some(
2471 "A variable controlling whether raw keyboard events are used on Windows.\n\nThe variable can be set to the following values:\n\n- \"0\": The Windows message loop is used for keyboard events. (default)\n- \"1\": Low latency raw keyboard events are used.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2472 ),
2473 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2474};
2475pub const METADATA_SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS: Hint = Hint {
2476 module: "hints",
2477 name: "SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS",
2478 short_name: "WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS",
2479 value: crate::hints::SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS,
2480 doc: Some(
2481 "A variable controlling whether or not the RIDEV_NOHOTKEYS flag is set when\nenabling Windows raw keyboard events.\n\nThis blocks any hotkeys that have been registered by applications from\nhaving any effect beyond generating raw WM_INPUT events.\n\nThis flag does not affect system-hotkeys like ALT-TAB or CTRL-ALT-DEL, but\ndoes affect the Windows Logo key since it is a userland hotkey registered\nby explorer.exe.\n\nThe variable can be set to the following values:\n\n- \"0\": Hotkeys are not excluded. (default)\n- \"1\": Hotkeys are excluded.\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.4.0.\n",
2482 ),
2483 available_since: Some(SDL_VERSIONNUM(3, 4, 0)),
2484};
2485pub const METADATA_SDL_HINT_WINDOWS_FORCE_SEMAPHORE_KERNEL: Hint = Hint {
2486 module: "hints",
2487 name: "SDL_HINT_WINDOWS_FORCE_SEMAPHORE_KERNEL",
2488 short_name: "WINDOWS_FORCE_SEMAPHORE_KERNEL",
2489 value: crate::hints::SDL_HINT_WINDOWS_FORCE_SEMAPHORE_KERNEL,
2490 doc: Some(
2491 "A variable controlling whether SDL uses Kernel Semaphores on Windows.\n\nKernel Semaphores are inter-process and require a context switch on every\ninteraction. On Windows 8 and newer, the WaitOnAddress API is available.\nUsing that and atomics to implement semaphores increases performance. SDL\nwill fall back to Kernel Objects on older OS versions or if forced to by\nthis hint.\n\nThe variable can be set to the following values:\n\n- \"0\": Use Atomics and WaitOnAddress API when available, otherwise fall\nback to Kernel Objects. (default)\n- \"1\": Force the use of Kernel Objects in all cases.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2492 ),
2493 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2494};
2495pub const METADATA_SDL_HINT_WINDOWS_INTRESOURCE_ICON: Hint = Hint {
2496 module: "hints",
2497 name: "SDL_HINT_WINDOWS_INTRESOURCE_ICON",
2498 short_name: "WINDOWS_INTRESOURCE_ICON",
2499 value: crate::hints::SDL_HINT_WINDOWS_INTRESOURCE_ICON,
2500 doc: Some(
2501 "A variable to specify custom icon resource id from RC file on Windows\nplatform.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2502 ),
2503 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2504};
2505pub const METADATA_SDL_HINT_WINDOWS_INTRESOURCE_ICON_SMALL: Hint = Hint {
2506 module: "hints",
2507 name: "SDL_HINT_WINDOWS_INTRESOURCE_ICON_SMALL",
2508 short_name: "WINDOWS_INTRESOURCE_ICON_SMALL",
2509 value: crate::hints::SDL_HINT_WINDOWS_INTRESOURCE_ICON_SMALL,
2510 doc: Some(
2511 "A variable to specify custom icon resource id from RC file on Windows\nplatform.\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2512 ),
2513 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2514};
2515pub const METADATA_SDL_HINT_WINDOWS_USE_D3D9EX: Hint = Hint {
2516 module: "hints",
2517 name: "SDL_HINT_WINDOWS_USE_D3D9EX",
2518 short_name: "WINDOWS_USE_D3D9EX",
2519 value: crate::hints::SDL_HINT_WINDOWS_USE_D3D9EX,
2520 doc: Some(
2521 "A variable controlling whether SDL uses the D3D9Ex API introduced in\nWindows Vista, instead of normal D3D9.\n\nDirect3D 9Ex contains changes to state management that can eliminate device\nloss errors during scenarios like Alt+Tab or UAC prompts. D3D9Ex may\nrequire some changes to your application to cope with the new behavior, so\nthis is disabled by default.\n\nFor more information on Direct3D 9Ex, see:\n\n- <https://docs.microsoft.com/en-us/windows/win32/direct3darticles/graphics-apis-in-windows-vista#direct3d-9ex>\n- <https://docs.microsoft.com/en-us/windows/win32/direct3darticles/direct3d-9ex-improvements>\n\nThe variable can be set to the following values:\n\n- \"0\": Use the original Direct3D 9 API. (default)\n- \"1\": Use the Direct3D 9Ex API on Vista and later (and fall back if D3D9Ex\nis unavailable)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2522 ),
2523 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2524};
2525pub const METADATA_SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE: Hint = Hint {
2526 module: "hints",
2527 name: "SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE",
2528 short_name: "WINDOWS_ERASE_BACKGROUND_MODE",
2529 value: crate::hints::SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE,
2530 doc: Some(
2531 "A variable controlling whether SDL will clear the window contents when the\nWM_ERASEBKGND message is received.\n\nThe variable can be set to the following values:\n\n- \"0\"/\"never\": Never clear the window.\n- \"1\"/\"initial\": Clear the window when the first WM_ERASEBKGND event fires.\n(default)\n- \"2\"/\"always\": Clear the window on every WM_ERASEBKGND event.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2532 ),
2533 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2534};
2535pub const METADATA_SDL_HINT_X11_FORCE_OVERRIDE_REDIRECT: Hint = Hint {
2536 module: "hints",
2537 name: "SDL_HINT_X11_FORCE_OVERRIDE_REDIRECT",
2538 short_name: "X11_FORCE_OVERRIDE_REDIRECT",
2539 value: crate::hints::SDL_HINT_X11_FORCE_OVERRIDE_REDIRECT,
2540 doc: Some(
2541 "A variable controlling whether X11 windows are marked as override-redirect.\n\nIf set, this _might_ increase framerate at the expense of the desktop not\nworking as expected. Override-redirect windows aren't noticed by the window\nmanager at all.\n\nYou should probably only use this for fullscreen windows, and you probably\nshouldn't even use it for that. But it's here if you want to try!\n\nThe variable can be set to the following values:\n\n- \"0\": Do not mark the window as override-redirect. (default)\n- \"1\": Mark the window as override-redirect.\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2542 ),
2543 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2544};
2545pub const METADATA_SDL_HINT_X11_WINDOW_TYPE: Hint = Hint {
2546 module: "hints",
2547 name: "SDL_HINT_X11_WINDOW_TYPE",
2548 short_name: "X11_WINDOW_TYPE",
2549 value: crate::hints::SDL_HINT_X11_WINDOW_TYPE,
2550 doc: Some(
2551 "A variable specifying the type of an X11 window.\n\nDuring [`SDL_CreateWindow`], SDL uses the _NET_WM_WINDOW_TYPE X11 property to\nreport to the window manager the type of window it wants to create. This\nmight be set to various things if [`SDL_WINDOW_TOOLTIP`] or\n[`SDL_WINDOW_POPUP_MENU`], etc, were specified. For \"normal\" windows that\nhaven't set a specific type, this hint can be used to specify a custom\ntype. For example, a dock window might set this to\n\"_NET_WM_WINDOW_TYPE_DOCK\".\n\nThis hint should be set before creating a window.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2552 ),
2553 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2554};
2555pub const METADATA_SDL_HINT_X11_XCB_LIBRARY: Hint = Hint {
2556 module: "hints",
2557 name: "SDL_HINT_X11_XCB_LIBRARY",
2558 short_name: "X11_XCB_LIBRARY",
2559 value: crate::hints::SDL_HINT_X11_XCB_LIBRARY,
2560 doc: Some(
2561 "Specify the XCB library to load for the X11 driver.\n\nThe default is platform-specific, often \"libX11-xcb.so.1\".\n\nThis hint should be set before initializing the video subsystem.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2562 ),
2563 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2564};
2565pub const METADATA_SDL_HINT_XINPUT_ENABLED: Hint = Hint {
2566 module: "hints",
2567 name: "SDL_HINT_XINPUT_ENABLED",
2568 short_name: "XINPUT_ENABLED",
2569 value: crate::hints::SDL_HINT_XINPUT_ENABLED,
2570 doc: Some(
2571 "A variable controlling whether XInput should be used for controller\nhandling.\n\nThe variable can be set to the following values:\n\n- \"0\": XInput is not enabled.\n- \"1\": XInput is enabled. (default)\n\nThis hint should be set before SDL is initialized.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2572 ),
2573 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2574};
2575pub const METADATA_SDL_HINT_ASSERT: Hint = Hint {
2576 module: "hints",
2577 name: "SDL_HINT_ASSERT",
2578 short_name: "ASSERT",
2579 value: crate::hints::SDL_HINT_ASSERT,
2580 doc: Some(
2581 "A variable controlling response to [`SDL_assert`] failures.\n\nThe variable can be set to the following case-sensitive values:\n\n- \"abort\": Program terminates immediately.\n- \"break\": Program triggers a debugger breakpoint.\n- \"retry\": Program reruns the SDL_assert's test again.\n- \"ignore\": Program continues on, ignoring this assertion failure this\ntime.\n- \"always_ignore\": Program continues on, ignoring this assertion failure\nfor the rest of the run.\n\nNote that [`SDL_SetAssertionHandler`] offers a programmatic means to deal with\nassertion failures through a callback, and this hint is largely intended to\nbe used via environment variables by end users and automated tools.\n\nThis hint should be set before an assertion failure is triggered and can be\nchanged at any time.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2582 ),
2583 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2584};
2585pub const METADATA_SDL_HINT_PEN_MOUSE_EVENTS: Hint = Hint {
2586 module: "hints",
2587 name: "SDL_HINT_PEN_MOUSE_EVENTS",
2588 short_name: "PEN_MOUSE_EVENTS",
2589 value: crate::hints::SDL_HINT_PEN_MOUSE_EVENTS,
2590 doc: Some(
2591 "A variable controlling whether pen events should generate synthetic mouse\nevents.\n\nThe variable can be set to the following values:\n\n- \"0\": Pen events will not generate mouse events.\n- \"1\": Pen events will generate mouse events. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2592 ),
2593 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2594};
2595pub const METADATA_SDL_HINT_PEN_TOUCH_EVENTS: Hint = Hint {
2596 module: "hints",
2597 name: "SDL_HINT_PEN_TOUCH_EVENTS",
2598 short_name: "PEN_TOUCH_EVENTS",
2599 value: crate::hints::SDL_HINT_PEN_TOUCH_EVENTS,
2600 doc: Some(
2601 "A variable controlling whether pen events should generate synthetic touch\nevents.\n\nThe variable can be set to the following values:\n\n- \"0\": Pen events will not generate touch events.\n- \"1\": Pen events will generate touch events. (default)\n\nThis hint can be set anytime.\n\n## Availability\nThis hint is available since SDL 3.2.0.\n",
2602 ),
2603 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2604};
2605pub const METADATA_SDL_HintPriority: Group = Group {
2606 module: "hints",
2607 kind: GroupKind::Enum,
2608 name: "SDL_HintPriority",
2609 short_name: "HintPriority",
2610 doc: Some(
2611 "An enumeration of hint priorities.\n\n## Availability\nThis enum is available since SDL 3.2.0.\n",
2612 ),
2613 available_since: Some(SDL_VERSIONNUM(3, 2, 0)),
2614 values: &[
2615 GroupValue {
2616 name: "SDL_HINT_DEFAULT",
2617 short_name: "DEFAULT",
2618 doc: None,
2619 available_since: None,
2620 },
2621 GroupValue {
2622 name: "SDL_HINT_NORMAL",
2623 short_name: "NORMAL",
2624 doc: None,
2625 available_since: None,
2626 },
2627 GroupValue {
2628 name: "SDL_HINT_OVERRIDE",
2629 short_name: "OVERRIDE",
2630 doc: None,
2631 available_since: None,
2632 },
2633 ],
2634};