mirror of
https://github.com/libsdl-org/SDL.git
synced 2025-06-01 01:17:40 +00:00

This declares that any `const char *` returned from SDL is owned by SDL, and promises to be valid _at least_ until the next time the event queue runs, or SDL_Quit() is called, even if the thing that owns the string gets destroyed or changed before then. This is noted in the headers as "the SDL_GetStringRule", so this will both be greppable to find a detailed explaination in docs/README-strings.md and wikiheaders will automatically turn it into a link we can point at the appropriate documentation. Fixes #9902. (and several FIXMEs, both known and yet-undocumented.)
681 lines
20 KiB
C
681 lines
20 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2024 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any damages
|
|
arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
including commercial applications, and to alter it and redistribute it
|
|
freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
claim that you wrote the original software. If you use this software
|
|
in a product, an acknowledgment in the product documentation would be
|
|
appreciated but is not required.
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
misrepresented as being the original software.
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
*/
|
|
#include "SDL_internal.h"
|
|
#include "SDL3/SDL_revision.h"
|
|
|
|
#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_GDK)
|
|
#include "core/windows/SDL_windows.h"
|
|
#elif !defined(SDL_PLATFORM_WINRT)
|
|
#include <unistd.h> /* _exit(), etc. */
|
|
#endif
|
|
|
|
/* this checks for HAVE_DBUS_DBUS_H internally. */
|
|
#include "core/linux/SDL_dbus.h"
|
|
|
|
#ifdef SDL_PLATFORM_EMSCRIPTEN
|
|
#include <emscripten.h>
|
|
#endif
|
|
|
|
/* Initialization code for SDL */
|
|
|
|
#include "SDL_assert_c.h"
|
|
#include "SDL_hints_c.h"
|
|
#include "SDL_log_c.h"
|
|
#include "SDL_properties_c.h"
|
|
#include "audio/SDL_sysaudio.h"
|
|
#include "cpuinfo/SDL_cpuinfo_c.h"
|
|
#include "video/SDL_video_c.h"
|
|
#include "events/SDL_events_c.h"
|
|
#include "haptic/SDL_haptic_c.h"
|
|
#include "joystick/SDL_gamepad_c.h"
|
|
#include "joystick/SDL_joystick_c.h"
|
|
#include "sensor/SDL_sensor_c.h"
|
|
#include "camera/SDL_camera_c.h"
|
|
|
|
#define SDL_INIT_EVERYTHING ~0U
|
|
|
|
/* Initialization/Cleanup routines */
|
|
#include "timer/SDL_timer_c.h"
|
|
#ifdef SDL_VIDEO_DRIVER_WINDOWS
|
|
extern int SDL_HelperWindowCreate(void);
|
|
extern int SDL_HelperWindowDestroy(void);
|
|
#endif
|
|
extern void SDL_FreeEnvironmentMemory(void);
|
|
|
|
#ifdef SDL_BUILD_MAJOR_VERSION
|
|
SDL_COMPILE_TIME_ASSERT(SDL_BUILD_MAJOR_VERSION,
|
|
SDL_MAJOR_VERSION == SDL_BUILD_MAJOR_VERSION);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_BUILD_MINOR_VERSION,
|
|
SDL_MINOR_VERSION == SDL_BUILD_MINOR_VERSION);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_BUILD_MICRO_VERSION,
|
|
SDL_MICRO_VERSION == SDL_BUILD_MICRO_VERSION);
|
|
#endif
|
|
|
|
/* Limited by its encoding in SDL_VERSIONNUM */
|
|
SDL_COMPILE_TIME_ASSERT(SDL_MAJOR_VERSION_min, SDL_MAJOR_VERSION >= 0);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_MAJOR_VERSION_max, SDL_MAJOR_VERSION <= 10);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_MINOR_VERSION_min, SDL_MINOR_VERSION >= 0);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_MINOR_VERSION_max, SDL_MINOR_VERSION <= 999);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_MICRO_VERSION_min, SDL_MICRO_VERSION >= 0);
|
|
SDL_COMPILE_TIME_ASSERT(SDL_MICRO_VERSION_max, SDL_MICRO_VERSION <= 999);
|
|
|
|
/* This is not declared in any header, although it is shared between some
|
|
parts of SDL, because we don't want anything calling it without an
|
|
extremely good reason. */
|
|
extern SDL_NORETURN void SDL_ExitProcess(int exitcode);
|
|
SDL_NORETURN void SDL_ExitProcess(int exitcode)
|
|
{
|
|
#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_GDK)
|
|
/* "if you do not know the state of all threads in your process, it is
|
|
better to call TerminateProcess than ExitProcess"
|
|
https://msdn.microsoft.com/en-us/library/windows/desktop/ms682658(v=vs.85).aspx */
|
|
TerminateProcess(GetCurrentProcess(), exitcode);
|
|
/* MingW doesn't have TerminateProcess marked as noreturn, so add an
|
|
ExitProcess here that will never be reached but make MingW happy. */
|
|
ExitProcess(exitcode);
|
|
#elif defined(SDL_PLATFORM_EMSCRIPTEN)
|
|
emscripten_cancel_main_loop(); /* this should "kill" the app. */
|
|
emscripten_force_exit(exitcode); /* this should "kill" the app. */
|
|
exit(exitcode);
|
|
#elif defined(SDL_PLATFORM_HAIKU) /* Haiku has _Exit, but it's not marked noreturn. */
|
|
_exit(exitcode);
|
|
#elif defined(HAVE__EXIT) /* Upper case _Exit() */
|
|
_Exit(exitcode);
|
|
#else
|
|
_exit(exitcode);
|
|
#endif
|
|
}
|
|
|
|
/* The initialized subsystems */
|
|
#ifdef SDL_MAIN_NEEDED
|
|
static SDL_bool SDL_MainIsReady = SDL_FALSE;
|
|
#else
|
|
static SDL_bool SDL_MainIsReady = SDL_TRUE;
|
|
#endif
|
|
static SDL_bool SDL_bInMainQuit = SDL_FALSE;
|
|
static Uint8 SDL_SubsystemRefCount[32];
|
|
|
|
/* Private helper to increment a subsystem's ref counter. */
|
|
static void SDL_IncrementSubsystemRefCount(Uint32 subsystem)
|
|
{
|
|
const int subsystem_index = SDL_MostSignificantBitIndex32(subsystem);
|
|
SDL_assert((subsystem_index < 0) || (SDL_SubsystemRefCount[subsystem_index] < 255));
|
|
if (subsystem_index >= 0) {
|
|
++SDL_SubsystemRefCount[subsystem_index];
|
|
}
|
|
}
|
|
|
|
/* Private helper to decrement a subsystem's ref counter. */
|
|
static void SDL_DecrementSubsystemRefCount(Uint32 subsystem)
|
|
{
|
|
const int subsystem_index = SDL_MostSignificantBitIndex32(subsystem);
|
|
if ((subsystem_index >= 0) && (SDL_SubsystemRefCount[subsystem_index] > 0)) {
|
|
if (SDL_bInMainQuit) {
|
|
SDL_SubsystemRefCount[subsystem_index] = 0;
|
|
} else {
|
|
--SDL_SubsystemRefCount[subsystem_index];
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Private helper to check if a system needs init. */
|
|
static SDL_bool SDL_ShouldInitSubsystem(Uint32 subsystem)
|
|
{
|
|
const int subsystem_index = SDL_MostSignificantBitIndex32(subsystem);
|
|
SDL_assert((subsystem_index < 0) || (SDL_SubsystemRefCount[subsystem_index] < 255));
|
|
return ((subsystem_index >= 0) && (SDL_SubsystemRefCount[subsystem_index] == 0));
|
|
}
|
|
|
|
/* Private helper to check if a system needs to be quit. */
|
|
static SDL_bool SDL_ShouldQuitSubsystem(Uint32 subsystem)
|
|
{
|
|
const int subsystem_index = SDL_MostSignificantBitIndex32(subsystem);
|
|
if ((subsystem_index >= 0) && (SDL_SubsystemRefCount[subsystem_index] == 0)) {
|
|
return SDL_FALSE;
|
|
}
|
|
|
|
/* If we're in SDL_Quit, we shut down every subsystem, even if refcount
|
|
* isn't zero.
|
|
*/
|
|
return (((subsystem_index >= 0) && (SDL_SubsystemRefCount[subsystem_index] == 1)) || SDL_bInMainQuit);
|
|
}
|
|
|
|
/* Private helper to either increment's existing ref counter,
|
|
* or fully init a new subsystem. */
|
|
static SDL_bool SDL_InitOrIncrementSubsystem(Uint32 subsystem)
|
|
{
|
|
int subsystem_index = SDL_MostSignificantBitIndex32(subsystem);
|
|
SDL_assert((subsystem_index < 0) || (SDL_SubsystemRefCount[subsystem_index] < 255));
|
|
if (subsystem_index < 0) {
|
|
return SDL_FALSE;
|
|
}
|
|
if (SDL_SubsystemRefCount[subsystem_index] > 0) {
|
|
++SDL_SubsystemRefCount[subsystem_index];
|
|
return SDL_TRUE;
|
|
}
|
|
return SDL_InitSubSystem(subsystem) == 0;
|
|
}
|
|
|
|
void SDL_SetMainReady(void)
|
|
{
|
|
SDL_MainIsReady = SDL_TRUE;
|
|
}
|
|
|
|
int SDL_InitSubSystem(Uint32 flags)
|
|
{
|
|
Uint32 flags_initialized = 0;
|
|
|
|
if (!SDL_MainIsReady) {
|
|
return SDL_SetError("Application didn't initialize properly, did you include SDL_main.h in the file containing your main() function?");
|
|
}
|
|
|
|
SDL_InitLog();
|
|
SDL_InitProperties();
|
|
SDL_GetGlobalProperties();
|
|
|
|
/* Clear the error message */
|
|
SDL_ClearError();
|
|
|
|
#ifdef SDL_USE_LIBDBUS
|
|
SDL_DBus_Init();
|
|
#endif
|
|
|
|
#ifdef SDL_VIDEO_DRIVER_WINDOWS
|
|
if (flags & (SDL_INIT_HAPTIC | SDL_INIT_JOYSTICK)) {
|
|
if (SDL_HelperWindowCreate() < 0) {
|
|
goto quit_and_error;
|
|
}
|
|
}
|
|
#endif
|
|
|
|
SDL_InitTicks();
|
|
|
|
/* Initialize the event subsystem */
|
|
if (flags & SDL_INIT_EVENTS) {
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_EVENTS)) {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_EVENTS);
|
|
if (SDL_InitEvents() < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_EVENTS);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_EVENTS);
|
|
}
|
|
flags_initialized |= SDL_INIT_EVENTS;
|
|
}
|
|
|
|
/* Initialize the timer subsystem */
|
|
if (flags & SDL_INIT_TIMER) {
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_TIMER)) {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_TIMER);
|
|
if (SDL_InitTimers() < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_TIMER);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_TIMER);
|
|
}
|
|
flags_initialized |= SDL_INIT_TIMER;
|
|
}
|
|
|
|
/* Initialize the video subsystem */
|
|
if (flags & SDL_INIT_VIDEO) {
|
|
#ifndef SDL_VIDEO_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_VIDEO)) {
|
|
/* video implies events */
|
|
if (!SDL_InitOrIncrementSubsystem(SDL_INIT_EVENTS)) {
|
|
goto quit_and_error;
|
|
}
|
|
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_VIDEO);
|
|
if (SDL_VideoInit(NULL) < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_VIDEO);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_VIDEO);
|
|
}
|
|
flags_initialized |= SDL_INIT_VIDEO;
|
|
#else
|
|
SDL_SetError("SDL not built with video support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
/* Initialize the audio subsystem */
|
|
if (flags & SDL_INIT_AUDIO) {
|
|
#ifndef SDL_AUDIO_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_AUDIO)) {
|
|
/* audio implies events */
|
|
if (!SDL_InitOrIncrementSubsystem(SDL_INIT_EVENTS)) {
|
|
goto quit_and_error;
|
|
}
|
|
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_AUDIO);
|
|
if (SDL_InitAudio(NULL) < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_AUDIO);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_AUDIO);
|
|
}
|
|
flags_initialized |= SDL_INIT_AUDIO;
|
|
#else
|
|
SDL_SetError("SDL not built with audio support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
/* Initialize the joystick subsystem */
|
|
if (flags & SDL_INIT_JOYSTICK) {
|
|
#ifndef SDL_JOYSTICK_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_JOYSTICK)) {
|
|
/* joystick implies events */
|
|
if (!SDL_InitOrIncrementSubsystem(SDL_INIT_EVENTS)) {
|
|
goto quit_and_error;
|
|
}
|
|
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_JOYSTICK);
|
|
if (SDL_InitJoysticks() < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_JOYSTICK);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_JOYSTICK);
|
|
}
|
|
flags_initialized |= SDL_INIT_JOYSTICK;
|
|
#else
|
|
SDL_SetError("SDL not built with joystick support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
if (flags & SDL_INIT_GAMEPAD) {
|
|
#ifndef SDL_JOYSTICK_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_GAMEPAD)) {
|
|
/* game controller implies joystick */
|
|
if (!SDL_InitOrIncrementSubsystem(SDL_INIT_JOYSTICK)) {
|
|
goto quit_and_error;
|
|
}
|
|
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_GAMEPAD);
|
|
if (SDL_InitGamepads() < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_GAMEPAD);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_GAMEPAD);
|
|
}
|
|
flags_initialized |= SDL_INIT_GAMEPAD;
|
|
#else
|
|
SDL_SetError("SDL not built with joystick support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
/* Initialize the haptic subsystem */
|
|
if (flags & SDL_INIT_HAPTIC) {
|
|
#ifndef SDL_HAPTIC_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_HAPTIC)) {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_HAPTIC);
|
|
if (SDL_InitHaptics() < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_HAPTIC);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_HAPTIC);
|
|
}
|
|
flags_initialized |= SDL_INIT_HAPTIC;
|
|
#else
|
|
SDL_SetError("SDL not built with haptic (force feedback) support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
/* Initialize the sensor subsystem */
|
|
if (flags & SDL_INIT_SENSOR) {
|
|
#ifndef SDL_SENSOR_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_SENSOR)) {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_SENSOR);
|
|
if (SDL_InitSensors() < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_SENSOR);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_SENSOR);
|
|
}
|
|
flags_initialized |= SDL_INIT_SENSOR;
|
|
#else
|
|
SDL_SetError("SDL not built with sensor support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
/* Initialize the camera subsystem */
|
|
if (flags & SDL_INIT_CAMERA) {
|
|
#ifndef SDL_CAMERA_DISABLED
|
|
if (SDL_ShouldInitSubsystem(SDL_INIT_CAMERA)) {
|
|
/* camera implies events */
|
|
if (!SDL_InitOrIncrementSubsystem(SDL_INIT_EVENTS)) {
|
|
goto quit_and_error;
|
|
}
|
|
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_CAMERA);
|
|
if (SDL_CameraInit(NULL) < 0) {
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_CAMERA);
|
|
goto quit_and_error;
|
|
}
|
|
} else {
|
|
SDL_IncrementSubsystemRefCount(SDL_INIT_CAMERA);
|
|
}
|
|
flags_initialized |= SDL_INIT_CAMERA;
|
|
#else
|
|
SDL_SetError("SDL not built with camera support");
|
|
goto quit_and_error;
|
|
#endif
|
|
}
|
|
|
|
(void)flags_initialized; /* make static analysis happy, since this only gets used in error cases. */
|
|
|
|
return SDL_ClearError();
|
|
|
|
quit_and_error:
|
|
SDL_QuitSubSystem(flags_initialized);
|
|
return -1;
|
|
}
|
|
|
|
int SDL_Init(Uint32 flags)
|
|
{
|
|
return SDL_InitSubSystem(flags);
|
|
}
|
|
|
|
void SDL_QuitSubSystem(Uint32 flags)
|
|
{
|
|
/* Shut down requested initialized subsystems */
|
|
|
|
#ifndef SDL_CAMERA_DISABLED
|
|
if (flags & SDL_INIT_CAMERA) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_CAMERA)) {
|
|
SDL_QuitCamera();
|
|
/* camera implies events */
|
|
SDL_QuitSubSystem(SDL_INIT_EVENTS);
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_CAMERA);
|
|
}
|
|
#endif
|
|
|
|
#ifndef SDL_SENSOR_DISABLED
|
|
if (flags & SDL_INIT_SENSOR) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_SENSOR)) {
|
|
SDL_QuitSensors();
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_SENSOR);
|
|
}
|
|
#endif
|
|
|
|
#ifndef SDL_JOYSTICK_DISABLED
|
|
if (flags & SDL_INIT_GAMEPAD) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_GAMEPAD)) {
|
|
SDL_QuitGamepads();
|
|
/* game controller implies joystick */
|
|
SDL_QuitSubSystem(SDL_INIT_JOYSTICK);
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_GAMEPAD);
|
|
}
|
|
|
|
if (flags & SDL_INIT_JOYSTICK) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_JOYSTICK)) {
|
|
SDL_QuitJoysticks();
|
|
/* joystick implies events */
|
|
SDL_QuitSubSystem(SDL_INIT_EVENTS);
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_JOYSTICK);
|
|
}
|
|
#endif
|
|
|
|
#ifndef SDL_HAPTIC_DISABLED
|
|
if (flags & SDL_INIT_HAPTIC) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_HAPTIC)) {
|
|
SDL_QuitHaptics();
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_HAPTIC);
|
|
}
|
|
#endif
|
|
|
|
#ifndef SDL_AUDIO_DISABLED
|
|
if (flags & SDL_INIT_AUDIO) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_AUDIO)) {
|
|
SDL_QuitAudio();
|
|
/* audio implies events */
|
|
SDL_QuitSubSystem(SDL_INIT_EVENTS);
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_AUDIO);
|
|
}
|
|
#endif
|
|
|
|
#ifndef SDL_VIDEO_DISABLED
|
|
if (flags & SDL_INIT_VIDEO) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_VIDEO)) {
|
|
SDL_VideoQuit();
|
|
/* video implies events */
|
|
SDL_QuitSubSystem(SDL_INIT_EVENTS);
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_VIDEO);
|
|
}
|
|
#endif
|
|
|
|
if (flags & SDL_INIT_TIMER) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_TIMER)) {
|
|
SDL_QuitTimers();
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_TIMER);
|
|
}
|
|
|
|
if (flags & SDL_INIT_EVENTS) {
|
|
if (SDL_ShouldQuitSubsystem(SDL_INIT_EVENTS)) {
|
|
SDL_QuitEvents();
|
|
}
|
|
SDL_DecrementSubsystemRefCount(SDL_INIT_EVENTS);
|
|
}
|
|
}
|
|
|
|
Uint32 SDL_WasInit(Uint32 flags)
|
|
{
|
|
int i;
|
|
int num_subsystems = SDL_arraysize(SDL_SubsystemRefCount);
|
|
Uint32 initialized = 0;
|
|
|
|
/* Fast path for checking one flag */
|
|
if (SDL_HasExactlyOneBitSet32(flags)) {
|
|
int subsystem_index = SDL_MostSignificantBitIndex32(flags);
|
|
return SDL_SubsystemRefCount[subsystem_index] ? flags : 0;
|
|
}
|
|
|
|
if (!flags) {
|
|
flags = SDL_INIT_EVERYTHING;
|
|
}
|
|
|
|
num_subsystems = SDL_min(num_subsystems, SDL_MostSignificantBitIndex32(flags) + 1);
|
|
|
|
/* Iterate over each bit in flags, and check the matching subsystem. */
|
|
for (i = 0; i < num_subsystems; ++i) {
|
|
if ((flags & 1) && SDL_SubsystemRefCount[i] > 0) {
|
|
initialized |= (1 << i);
|
|
}
|
|
|
|
flags >>= 1;
|
|
}
|
|
|
|
return initialized;
|
|
}
|
|
|
|
void SDL_Quit(void)
|
|
{
|
|
SDL_bInMainQuit = SDL_TRUE;
|
|
|
|
/* Quit all subsystems */
|
|
#ifdef SDL_VIDEO_DRIVER_WINDOWS
|
|
SDL_HelperWindowDestroy();
|
|
#endif
|
|
SDL_QuitSubSystem(SDL_INIT_EVERYTHING);
|
|
|
|
SDL_QuitTicks();
|
|
|
|
#ifdef SDL_USE_LIBDBUS
|
|
SDL_DBus_Quit();
|
|
#endif
|
|
|
|
SDL_SetObjectsInvalid();
|
|
SDL_ClearHints();
|
|
SDL_AssertionsQuit();
|
|
|
|
SDL_QuitCPUInfo();
|
|
|
|
SDL_QuitProperties();
|
|
SDL_QuitLog();
|
|
|
|
/* Now that every subsystem has been quit, we reset the subsystem refcount
|
|
* and the list of initialized subsystems.
|
|
*/
|
|
SDL_memset(SDL_SubsystemRefCount, 0x0, sizeof(SDL_SubsystemRefCount));
|
|
|
|
SDL_CleanupTLS();
|
|
|
|
SDL_FreeEnvironmentMemory();
|
|
|
|
SDL_bInMainQuit = SDL_FALSE;
|
|
}
|
|
|
|
/* Get the library version number */
|
|
int SDL_GetVersion(void)
|
|
{
|
|
return SDL_VERSION;
|
|
}
|
|
|
|
/* Get the library source revision */
|
|
const char *SDL_GetRevision(void)
|
|
{
|
|
return SDL_REVISION; // a string literal, no need to SDL_FreeLater it.
|
|
}
|
|
|
|
// Get the name of the platform
|
|
// (a string literal, no need to SDL_FreeLater it.)
|
|
const char *SDL_GetPlatform(void)
|
|
{
|
|
#if defined(SDL_PLATFORM_AIX)
|
|
return "AIX";
|
|
#elif defined(SDL_PLATFORM_ANDROID)
|
|
return "Android";
|
|
#elif defined(SDL_PLATFORM_BSDI)
|
|
return "BSDI";
|
|
#elif defined(SDL_PLATFORM_EMSCRIPTEN)
|
|
return "Emscripten";
|
|
#elif defined(SDL_PLATFORM_FREEBSD)
|
|
return "FreeBSD";
|
|
#elif defined(SDL_PLATFORM_HAIKU)
|
|
return "Haiku";
|
|
#elif defined(SDL_PLATFORM_HPUX)
|
|
return "HP-UX";
|
|
#elif defined(SDL_PLATFORM_IRIX)
|
|
return "Irix";
|
|
#elif defined(SDL_PLATFORM_LINUX)
|
|
return "Linux";
|
|
#elif defined(__MINT__)
|
|
return "Atari MiNT";
|
|
#elif defined(SDL_PLATFORM_MACOS)
|
|
return "macOS";
|
|
#elif defined(SDL_PLATFORM_NETBSD)
|
|
return "NetBSD";
|
|
#elif defined(SDL_PLATFORM_OPENBSD)
|
|
return "OpenBSD";
|
|
#elif defined(SDL_PLATFORM_OS2)
|
|
return "OS/2";
|
|
#elif defined(SDL_PLATFORM_OSF)
|
|
return "OSF/1";
|
|
#elif defined(SDL_PLATFORM_QNXNTO)
|
|
return "QNX Neutrino";
|
|
#elif defined(SDL_PLATFORM_RISCOS)
|
|
return "RISC OS";
|
|
#elif defined(SDL_PLATFORM_SOLARIS)
|
|
return "Solaris";
|
|
#elif defined(SDL_PLATFORM_WIN32)
|
|
return "Windows";
|
|
#elif defined(SDL_PLATFORM_WINRT)
|
|
return "WinRT";
|
|
#elif defined(SDL_PLATFORM_WINGDK)
|
|
return "WinGDK";
|
|
#elif defined(SDL_PLATFORM_XBOXONE)
|
|
return "Xbox One";
|
|
#elif defined(SDL_PLATFORM_XBOXSERIES)
|
|
return "Xbox Series X|S";
|
|
#elif defined(SDL_PLATFORM_IOS)
|
|
return "iOS";
|
|
#elif defined(SDL_PLATFORM_TVOS)
|
|
return "tvOS";
|
|
#elif defined(SDL_PLATFORM_PS2)
|
|
return "PlayStation 2";
|
|
#elif defined(SDL_PLATFORM_PSP)
|
|
return "PlayStation Portable";
|
|
#elif defined(SDL_PLATFORM_VITA)
|
|
return "PlayStation Vita";
|
|
#elif defined(SDL_PLATFORM_NGAGE)
|
|
return "Nokia N-Gage";
|
|
#elif defined(SDL_PLATFORM_3DS)
|
|
return "Nintendo 3DS";
|
|
#elif defined(__managarm__)
|
|
return "Managarm";
|
|
#else
|
|
return "Unknown (see SDL_platform.h)";
|
|
#endif
|
|
}
|
|
|
|
SDL_bool SDL_IsTablet(void)
|
|
{
|
|
#ifdef SDL_PLATFORM_ANDROID
|
|
extern SDL_bool SDL_IsAndroidTablet(void);
|
|
return SDL_IsAndroidTablet();
|
|
#elif defined(SDL_PLATFORM_IOS)
|
|
extern SDL_bool SDL_IsIPad(void);
|
|
return SDL_IsIPad();
|
|
#else
|
|
return SDL_FALSE;
|
|
#endif
|
|
}
|
|
|
|
#ifdef SDL_PLATFORM_WIN32
|
|
|
|
#if (!defined(HAVE_LIBC) || defined(__WATCOMC__)) && !defined(SDL_STATIC_LIB)
|
|
/* FIXME: Still need to include DllMain() on Watcom C ? */
|
|
|
|
BOOL APIENTRY MINGW32_FORCEALIGN _DllMainCRTStartup(HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved)
|
|
{
|
|
switch (ul_reason_for_call) {
|
|
case DLL_PROCESS_ATTACH:
|
|
case DLL_THREAD_ATTACH:
|
|
case DLL_THREAD_DETACH:
|
|
case DLL_PROCESS_DETACH:
|
|
break;
|
|
}
|
|
return TRUE;
|
|
}
|
|
#endif /* Building DLL */
|
|
|
|
#endif /* defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_GDK) */
|