Module fermium::hints [−][src]
Expand description
SDL configuration variables
This file contains functions to set and get configuration hints, as well as listing each of them alphabetically.
The convention for naming hints is SDL_HINT_X, where “SDL_X” is the environment variable that can be used to override the default.
In general these hints are just that - they may or may not be supported or applicable on any given platform, but they provide a way for an application or user to give the library a hint as to how they would like the library to work.
Structs
An enumeration of hint priorities.
Constants
A variable controlling whether the Android / iOS built-in accelerometer should be listed as a joystick device.
If set to “0” then never set the top most bit on a SDL Window, even if the video mode expects it. This is a debugging aid for developers and not expected to be used by end users. The default is “1”
Android APK expansion main file version. Should be a string number like “1”, “2” etc.
Android APK expansion patch file version. Should be a string number like “1”, “2” etc.
A variable to control whether the event loop will block itself when the app is paused.
A variable to control whether SDL will pause audio in background (Requires SDL_ANDROID_BLOCK_ON_PAUSE as “Non blocking”)
A variable to control whether we trap the Android back button to handle it manually. This is necessary for the right mouse button to work on some Android devices, or to be able to trap the back button for use in your code reliably. If set to true, the back button will show up as an SDL_KEYDOWN / SDL_KEYUP pair with a keycode of SDL_SCANCODE_AC_BACK.
A variable controlling whether controllers used with the Apple TV generate UI events.
A variable controlling whether the Apple TV remote’s joystick axes will automatically match the rotation of the remote.
A variable controlling the audio category on iOS and Mac OS X
Specify an application name for an audio device.
Specify an application name for an audio device.
Specify an application role for an audio device.
A variable that causes SDL to not ignore audio “monitors”
A variable controlling speed/quality tradeoff of audio resampling.
A variable controlling whether SDL updates joystick state when getting input events
A variable controlling whether SDL updates sensor state when getting input events
Prevent SDL from using version 4 of the bitmap header when saving BMPs.
Disable giving back control to the browser automatically when running with asyncify
Override the binding element for keyboard inputs for Emscripten builds
A variable that controls whether Steam Controllers should be exposed using the SDL joystick and game controller APIs
A variable controlling whether SDL logs all events pushed onto its internal queue.
A variable controlling how 3D acceleration is used to accelerate the SDL screen surface.
A variable that lets you manually hint extra gamecontroller db entries.
A variable that lets you provide a file with extra gamecontroller db entries.
A variable that overrides the automatic controller type detection
A variable containing a list of devices to skip when scanning for game controllers.
If set, all devices will be skipped when scanning for game controllers except for the ones listed in this variable.
If set, game controller face buttons report their values according to their labels instead of their positional layout.
A variable controlling whether grabbing input grabs the keyboard
A variable controlling whether the idle timer is disabled on iOS.
A variable to control whether certain IMEs should handle text editing internally instead of sending SDL_TEXTEDITING events.
A variable controlling whether the home indicator bar on iPhone X should be hidden.
A variable that lets you enable joystick (and gamecontroller) events even when your app is in the background.
A variable controlling whether the HIDAPI joystick drivers should be used.
A variable controlling whether the HIDAPI driver for XBox controllers on Windows should pull correlated data from XInput.
A variable controlling whether the HIDAPI driver for Nintendo GameCube controllers should be used.
A variable controlling whether the HIDAPI driver for PS4 controllers should be used.
A variable controlling whether extended input reports should be used for PS4 controllers when using the HIDAPI driver.
A variable controlling whether the HIDAPI driver for PS5 controllers should be used.
A variable controlling whether the HIDAPI driver for Steam Controllers should be used.
A variable controlling whether the HIDAPI driver for Nintendo Switch controllers should be used.
A variable controlling whether the HIDAPI driver for XBox controllers should be used.
A variable controlling whether the RAWINPUT joystick drivers should be used for better handling XInput-capable devices.
A variable controlling whether a separate thread should be used for handling joystick detection and raw input messages on Windows
A variable controlling whether joysticks on Linux adhere to their HID-defined deadzones or return unfiltered values.
When set don’t force the SDL app to become a foreground process
A variable that determines whether ctrl+click should generate a right-click event on Mac
A variable setting the double click radius, in pixels.
A variable setting the double click time, in milliseconds.
Allow mouse click events when clicking to focus an SDL window
A variable setting the speed scale for mouse motion, in floating point, when the mouse is not in relative mode
A variable controlling whether relative mouse mode is implemented using mouse warping
A variable controlling whether relative mouse motion is affected by renderer scaling
A variable setting the scale for mouse motion, in floating point, when the mouse is in relative mode
A variable controlling whether mouse events should generate synthetic touch events
Tell SDL not to catch the SIGINT or SIGTERM signals.
A variable controlling what driver to use for OpenGL ES contexts.
A variable controlling which orientations are allowed on iOS/Android.
Override for SDL_GetPreferredLocales()
A variable describing the content orientation on QtWayland-based platforms.
Flags to set on QtWayland windows to integrate with the native window manager.
A variable controlling whether the 2D render API is compatible or efficient.
A variable controlling whether to enable Direct3D 11+’s Debug Layer.
A variable controlling whether the Direct3D device is initialized for thread-safe operations.
A variable specifying which render driver to use.
A variable controlling whether the OpenGL render driver uses shaders if they are available.
A variable controlling the scaling quality
A variable controlling whether updates to the SDL screen surface should be synchronized with the vertical refresh, to avoid tearing.
A variable to control whether the return key on the soft keyboard should hide the soft keyboard on Android and iOS.
Tell SDL which Dispmanx layer to use on a Raspberry PI
Specifies whether SDL_THREAD_PRIORITY_TIME_CRITICAL should be treated as realtime.
A string specifying additional information to use with SDL_SetThreadPriority.
A string specifying SDL’s threads stack size in bytes or “0” for the backend’s default size
A variable that controls the timer resolution, in milliseconds.
A variable controlling whether touch events should generate synthetic mouse events
A variable controlling whether the Android / tvOS remotes should be listed as joystick devices, instead of sending keyboard events.
A variable controlling whether the screensaver is enabled.
Tell the video driver that we only want a double buffer.
A variable controlling whether the graphics context is externally managed.
If set to 1, then do not allow high-DPI windows. (“Retina” on Mac and iOS)
A variable that dictates policy for fullscreen Spaces on Mac OS X.
Minimize your SDL_Window if it loses key focus when in fullscreen mode.
A variable that is the address of another SDL_Window (as a hex string).
A variable specifying which shader compiler to preload when using the Chrome ANGLE binaries
A variable controlling whether X11 should use GLX or EGL by default
A variable controlling whether the X11 _NET_WM_BYPASS_COMPOSITOR hint should be used.
A variable controlling whether the X11 _NET_WM_PING protocol should be supported.
A variable forcing the visual ID chosen for new X11 windows
A variable controlling whether the X11 Xinerama extension should be used.
A variable controlling whether the X11 XRandR extension should be used.
A variable controlling whether the X11 VidMode extension should be used.
Controls how the fact chunk affects the loading of a WAVE file.
Controls how the size of the RIFF chunk affects the loading of a WAVE file.
Controls how a truncated WAVE file is handled.
Tell SDL not to name threads on Windows with the 0x406D1388 Exception.
A variable controlling whether the windows message loop is processed by SDL
A variable to specify custom icon resource id from RC file on Windows platform
A variable to specify custom icon resource id from RC file on Windows platform (small version)
Tell SDL not to generate window-close events for Alt+F4 on Windows.
A variable controlling whether the window frame and title bar are interactive when the cursor is hidden
Allows back-button-press events on Windows Phone to be marked as handled
Label text for a WinRT app’s privacy policy link
A URL to a WinRT app’s privacy policy
A variable that lets you disable the detection and use of Xinput gamepad devices
A variable that causes SDL to use the old axis and button mapping for XInput devices.
Functions
Add a function to watch a particular hint
Clear all hints
Remove a function watching a particular hint
Get a hint
Get a hint
Set a hint with normal priority
Set a hint with a specific priority