mirror of
https://github.com/libsdl-org/SDL.git
synced 2025-10-26 12:27:44 +00:00
4f55271571
It was intended to make the API easier to use, but various automatic garbage collection all had flaws, and making the application periodically clean up temporary memory added cognitive load to using the API, and in many cases was it was difficult to restructure threaded code to handle this. So, we're largely going back to the original system, where the API returns allocated results and you free them. In addition, to solve the problems we originally wanted temporary memory for: * Short strings with a finite count, like device names, get stored in a per-thread string pool. * Events continue to use temporary memory internally, which is cleaned up on the next event processing cycle.
71 lines
2.4 KiB
C
71 lines
2.4 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"
|
|
|
|
#ifndef SDL_utils_h_
|
|
#define SDL_utils_h_
|
|
|
|
/* Common utility functions that aren't in the public API */
|
|
|
|
/* Return the smallest power of 2 greater than or equal to 'x' */
|
|
extern int SDL_powerof2(int x);
|
|
|
|
extern void SDL_CalculateFraction(float x, int *numerator, int *denominator);
|
|
|
|
extern SDL_bool SDL_endswith(const char *string, const char *suffix);
|
|
|
|
/** Convert URI to a local filename, stripping the "file://"
|
|
* preamble and hostname if present, and writes the result
|
|
* to the dst buffer. Since URI-encoded characters take
|
|
* three times the space of normal characters, src and dst
|
|
* can safely point to the same buffer for in situ conversion.
|
|
*
|
|
* Returns the number of decoded bytes that wound up in
|
|
* the destination buffer, excluding the terminating NULL byte.
|
|
*
|
|
* On error, -1 is returned.
|
|
*/
|
|
extern int SDL_URIToLocal(const char *src, char *dst);
|
|
|
|
typedef enum
|
|
{
|
|
SDL_OBJECT_TYPE_UNKNOWN,
|
|
SDL_OBJECT_TYPE_WINDOW,
|
|
SDL_OBJECT_TYPE_RENDERER,
|
|
SDL_OBJECT_TYPE_TEXTURE,
|
|
SDL_OBJECT_TYPE_JOYSTICK,
|
|
SDL_OBJECT_TYPE_GAMEPAD,
|
|
SDL_OBJECT_TYPE_HAPTIC,
|
|
SDL_OBJECT_TYPE_SENSOR,
|
|
SDL_OBJECT_TYPE_HIDAPI_DEVICE,
|
|
SDL_OBJECT_TYPE_HIDAPI_JOYSTICK,
|
|
|
|
} SDL_ObjectType;
|
|
|
|
extern Uint32 SDL_GetNextObjectID(void);
|
|
extern void SDL_SetObjectValid(void *object, SDL_ObjectType type, SDL_bool valid);
|
|
extern SDL_bool SDL_ObjectValid(void *object, SDL_ObjectType type);
|
|
extern void SDL_SetObjectsInvalid(void);
|
|
|
|
extern const char *SDL_GetPersistentString(const char *string);
|
|
|
|
#endif /* SDL_utils_h_ */
|