sdl3_sys/metadata/generated/
hints.rs

1//! Metadata for items in the `crate::hints` module
2
3use 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};