You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
187 lines
5.3 KiB
187 lines
5.3 KiB
/* |
|
Simple DirectMedia Layer |
|
Copyright (C) 1997-2022 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 (__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__) |
|
# 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(__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 _M_X64 |
|
/* 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 */
|
|
|