summaryrefslogtreecommitdiff
path: root/src/dynapi/SDL_dynapi.h
diff options
context:
space:
mode:
authorRyan C. Gordon <icculus@icculus.org>2013-12-09 16:03:18 -0500
committerRyan C. Gordon <icculus@icculus.org>2013-12-09 16:03:18 -0500
commit3dfc14ade20bb585aa9dd6f30cdbe1992029532f (patch)
treed708bb4c9986f8eea349df0fce94ee967b8fd830 /src/dynapi/SDL_dynapi.h
parent03d5719413ab981b5122d5a69fc3ffda9f263901 (diff)
Implemented the Dynamic API magic.
Diffstat (limited to 'src/dynapi/SDL_dynapi.h')
-rw-r--r--src/dynapi/SDL_dynapi.h50
1 files changed, 50 insertions, 0 deletions
diff --git a/src/dynapi/SDL_dynapi.h b/src/dynapi/SDL_dynapi.h
new file mode 100644
index 0000000000..eb1c014408
--- /dev/null
+++ b/src/dynapi/SDL_dynapi.h
@@ -0,0 +1,50 @@
+/*
+ Simple DirectMedia Layer
+ Copyright (C) 1997-2013 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.
+*/
+
+#ifndef _SDL_dynapi_h
+#define _SDL_dynapi_h
+
+/* IMPORTANT:
+ This is the master switch to disabling the dynamic API. We made it so you
+ have to hand-edit an internal source file in SDL to turn it off; you
+ can do it if you want it badly enough, but hopefully you won't want to.
+ You should understand the ramifications of turning this off: it makes it
+ hard to update your SDL in the field, and impossible if you've statically
+ linked SDL into your app. Understand that platforms change, and if we can't
+ drop in an updated SDL, your application can definitely break some time
+ in the future, even if it's fine today.
+ To be sure, as new system-level video and audio APIs are introduced, an
+ updated SDL can transparently take advantage of them, but your program will
+ not without this feature. Think hard before turning it off.
+*/
+#ifdef SDL_DYNAMIC_API /* Tried to force it on the command line? */
+#error Nope, you have to edit this file to force this off.
+#endif
+
+#if defined(__APPLE__) && TARGET_OS_IPHONE /* probably not useful on iOS. */
+#define SDL_DYNAMIC_API 0
+#else /* everyone else. */
+#define SDL_DYNAMIC_API 1
+#endif
+
+#endif
+
+/* vi: set ts=4 sw=4 expandtab: */