|
@@ -145,6 +145,26 @@ extern "C" {
|
|
|
*/
|
|
|
#define SDL_HINT_ANDROID_TRAP_BACK_BUTTON "SDL_ANDROID_TRAP_BACK_BUTTON"
|
|
|
|
|
|
+/**
|
|
|
+ * \brief Specify an application name.
|
|
|
+ *
|
|
|
+ * This hint lets you specify the application name sent to the OS when
|
|
|
+ * required. For example, this will often appear in volume control applets for
|
|
|
+ * audio streams, and in lists of applications which are inhibiting the
|
|
|
+ * screensaver. You should use a string that describes your program ("My Game
|
|
|
+ * 2: The Revenge")
|
|
|
+ *
|
|
|
+ * Setting this to "" or leaving it unset will have SDL use a reasonable
|
|
|
+ * default: probably the application's name or "SDL Application" if SDL
|
|
|
+ * doesn't have any better information.
|
|
|
+ *
|
|
|
+ * Note that, for audio streams, this can be overridden with
|
|
|
+ * SDL_HINT_AUDIO_DEVICE_APP_NAME.
|
|
|
+ *
|
|
|
+ * On targets where this is not supported, this hint does nothing.
|
|
|
+ */
|
|
|
+#define SDL_HINT_APP_NAME "SDL_APP_NAME"
|
|
|
+
|
|
|
/**
|
|
|
* \brief A variable controlling whether controllers used with the Apple TV
|
|
|
* generate UI events.
|
|
@@ -199,8 +219,9 @@ extern "C" {
|
|
|
* that describes your program ("My Game 2: The Revenge")
|
|
|
*
|
|
|
* Setting this to "" or leaving it unset will have SDL use a reasonable
|
|
|
- * default: probably the application's name or "SDL Application" if SDL
|
|
|
- * doesn't have any better information.
|
|
|
+ * default: this will be the name set with SDL_HINT_APP_NAME, if that hint is
|
|
|
+ * set. Otherwise, it'll probably the application's name or "SDL Application"
|
|
|
+ * if SDL doesn't have any better information.
|
|
|
*
|
|
|
* On targets where this is not supported, this hint does nothing.
|
|
|
*/
|
|
@@ -1103,6 +1124,26 @@ extern "C" {
|
|
|
*/
|
|
|
#define SDL_HINT_RPI_VIDEO_LAYER "SDL_RPI_VIDEO_LAYER"
|
|
|
|
|
|
+/**
|
|
|
+ * \brief Specify an "activity name" for screensaver inhibition.
|
|
|
+ *
|
|
|
+ * Some platforms, notably Linux desktops, list the applications which are
|
|
|
+ * inhibiting the screensaver or other power-saving features.
|
|
|
+ *
|
|
|
+ * This hint lets you specify the "activity name" sent to the OS when
|
|
|
+ * SDL_DisableScreenSaver() is used (or the screensaver is automatically
|
|
|
+ * disabled). The contents of this hint are used when the screensaver is
|
|
|
+ * disabled. You should use a string that describes what your program is doing
|
|
|
+ * (and, therefore, why the screensaver is disabled). For example, "Playing a
|
|
|
+ * game" or "Watching a video".
|
|
|
+ *
|
|
|
+ * Setting this to "" or leaving it unset will have SDL use a reasonable
|
|
|
+ * default: "Playing a game" or something similar.
|
|
|
+ *
|
|
|
+ * On targets where this is not supported, this hint does nothing.
|
|
|
+ */
|
|
|
+#define SDL_HINT_SCREENSAVER_INHIBIT_ACTIVITY_NAME "SDL_SCREENSAVER_INHIBIT_ACTIVITY_NAME"
|
|
|
+
|
|
|
/**
|
|
|
* \brief Specifies whether SDL_THREAD_PRIORITY_TIME_CRITICAL should be treated as realtime.
|
|
|
*
|