|
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2023 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.
|
|
*/
|
|
|
|
/**
|
|
* \file begin_code.h
|
|
*
|
|
* This file sets things up for C dynamic library function definitions,
|
|
* static inlined functions, and structures aligned at 4-byte alignment.
|
|
* If you don't like ugly C preprocessor code, don't look at this file. :)
|
|
*/
|
|
|
|
/* This shouldn't be nested -- included it around code only. */
|
|
#ifdef _begin_code_h
|
|
#error Nested inclusion of begin_code.h
|
|
#endif
|
|
#define _begin_code_h
|
|
|
|
#ifndef SDL_DEPRECATED
|
|
# if defined(__GNUC__) && (__GNUC__ >= 4) /* technically, this arrived in gcc 3.1, but oh well. */
|
|
# define SDL_DEPRECATED __attribute__((deprecated))
|
|
# else
|
|
# define SDL_DEPRECATED
|
|
# endif
|
|
#endif
|
|
|
|
#ifndef SDL_UNUSED
|
|
# ifdef __GNUC__
|
|
# define SDL_UNUSED __attribute__((unused))
|
|
# else
|
|
# define SDL_UNUSED
|
|
# endif
|
|
#endif
|
|
|
|
/* Some compilers use a special export keyword */
|
|
#ifndef DECLSPEC
|
|
# if defined(__WIN32__) || defined(__WINRT__) || defined(__CYGWIN__) || defined(__GDK__)
|
|
# ifdef DLL_EXPORT
|
|
# define DECLSPEC __declspec(dllexport)
|
|
# else
|
|
# define DECLSPEC
|
|
# endif
|
|
# elif defined(__OS2__)
|
|
# ifdef BUILD_SDL
|
|
# define DECLSPEC __declspec(dllexport)
|
|
# else
|
|
# define DECLSPEC
|
|
# endif
|
|
# else
|
|
# if defined(__GNUC__) && __GNUC__ >= 4
|
|
# define DECLSPEC __attribute__ ((visibility("default")))
|
|
# else
|
|
# define DECLSPEC
|
|
# endif
|
|
# endif
|
|
#endif
|
|
|
|
/* By default SDL uses the C calling convention */
|
|
#ifndef SDLCALL
|
|
#if (defined(__WIN32__) || defined(__WINRT__) || defined(__GDK__)) && !defined(__GNUC__)
|
|
#define SDLCALL __cdecl
|
|
#elif defined(__OS2__) || defined(__EMX__)
|
|
#define SDLCALL _System
|
|
# if defined (__GNUC__) && !defined(_System)
|
|
# define _System /* for old EMX/GCC compat. */
|
|
# endif
|
|
#else
|
|
#define SDLCALL
|
|
#endif
|
|
#endif /* SDLCALL */
|
|
|
|
/* Removed DECLSPEC on Symbian OS because SDL cannot be a DLL in EPOC */
|
|
#ifdef __SYMBIAN32__
|
|
#undef DECLSPEC
|
|
#define DECLSPEC
|
|
#endif /* __SYMBIAN32__ */
|
|
|
|
/* Force structure packing at 4 byte alignment.
|
|
This is necessary if the header is included in code which has structure
|
|
packing set to an alternate value, say for loading structures from disk.
|
|
The packing is reset to the previous value in close_code.h
|
|
*/
|
|
#if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__)
|
|
#ifdef _MSC_VER
|
|
#pragma warning(disable: 4103)
|
|
#endif
|
|
#ifdef __clang__
|
|
#pragma clang diagnostic ignored "-Wpragma-pack"
|
|
#endif
|
|
#ifdef __BORLANDC__
|
|
#pragma nopackwarning
|
|
#endif
|
|
#ifdef _WIN64
|
|
/* Use 8-byte alignment on 64-bit architectures, so pointers are aligned */
|
|
#pragma pack(push,8)
|
|
#else
|
|
#pragma pack(push,4)
|
|
#endif
|
|
#endif /* Compiler needs structure packing set */
|
|
|
|
#ifndef SDL_INLINE
|
|
#if defined(__GNUC__)
|
|
#define SDL_INLINE __inline__
|
|
#elif defined(_MSC_VER) || defined(__BORLANDC__) || \
|
|
defined(__DMC__) || defined(__SC__) || \
|
|
defined(__WATCOMC__) || defined(__LCC__) || \
|
|
defined(__DECC) || defined(__CC_ARM)
|
|
#define SDL_INLINE __inline
|
|
#ifndef __inline__
|
|
#define __inline__ __inline
|
|
#endif
|
|
#else
|
|
#define SDL_INLINE inline
|
|
#ifndef __inline__
|
|
#define __inline__ inline
|
|
#endif
|
|
#endif
|
|
#endif /* SDL_INLINE not defined */
|
|
|
|
#ifndef SDL_FORCE_INLINE
|
|
#if defined(_MSC_VER)
|
|
#define SDL_FORCE_INLINE __forceinline
|
|
#elif ( (defined(__GNUC__) && (__GNUC__ >= 4)) || defined(__clang__) )
|
|
#define SDL_FORCE_INLINE __attribute__((always_inline)) static __inline__
|
|
#else
|
|
#define SDL_FORCE_INLINE static SDL_INLINE
|
|
#endif
|
|
#endif /* SDL_FORCE_INLINE not defined */
|
|
|
|
#ifndef SDL_NORETURN
|
|
#if defined(__GNUC__)
|
|
#define SDL_NORETURN __attribute__((noreturn))
|
|
#elif defined(_MSC_VER)
|
|
#define SDL_NORETURN __declspec(noreturn)
|
|
#else
|
|
#define SDL_NORETURN
|
|
#endif
|
|
#endif /* SDL_NORETURN not defined */
|
|
|
|
/* Apparently this is needed by several Windows compilers */
|
|
#if !defined(__MACH__)
|
|
#ifndef NULL
|
|
#ifdef __cplusplus
|
|
#define NULL 0
|
|
#else
|
|
#define NULL ((void *)0)
|
|
#endif
|
|
#endif /* NULL */
|
|
#endif /* ! Mac OS X - breaks precompiled headers */
|
|
|
|
#ifndef SDL_FALLTHROUGH
|
|
#if (defined(__cplusplus) && __cplusplus >= 201703L) || \
|
|
(defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202000L)
|
|
#define SDL_FALLTHROUGH [[fallthrough]]
|
|
#else
|
|
#if defined(__has_attribute)
|
|
#define _HAS_FALLTHROUGH __has_attribute(__fallthrough__)
|
|
#else
|
|
#define _HAS_FALLTHROUGH 0
|
|
#endif /* __has_attribute */
|
|
#if _HAS_FALLTHROUGH && \
|
|
((defined(__GNUC__) && __GNUC__ >= 7) || \
|
|
(defined(__clang_major__) && __clang_major__ >= 10))
|
|
#define SDL_FALLTHROUGH __attribute__((__fallthrough__))
|
|
#else
|
|
#define SDL_FALLTHROUGH do {} while (0) /* fallthrough */
|
|
#endif /* _HAS_FALLTHROUGH */
|
|
#undef _HAS_FALLTHROUGH
|
|
#endif /* C++17 or C2x */
|
|
#endif /* SDL_FALLTHROUGH not defined */
|