Mercurial > sdl-ios-xcode
annotate include/begin_code.h @ 3291:b273b2a8a1ea
Added reminder to look into 2D vblank synchronization
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Mon, 21 Sep 2009 09:16:35 +0000 |
| parents | a67a961e2171 |
| children | 245a7d79577c |
| rev | line source |
|---|---|
| 0 | 1 /* |
| 2 SDL - Simple DirectMedia Layer | |
| 2859 | 3 Copyright (C) 1997-2009 Sam Lantinga |
| 0 | 4 |
| 5 This library is free software; you can redistribute it and/or | |
| 6 modify it under the terms of the GNU Library General Public | |
| 7 License as published by the Free Software Foundation; either | |
| 8 version 2 of the License, or (at your option) any later version. | |
| 9 | |
| 10 This library is distributed in the hope that it will be useful, | |
| 11 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| 13 Library General Public License for more details. | |
| 14 | |
| 15 You should have received a copy of the GNU Library General Public | |
| 16 License along with this library; if not, write to the Free | |
| 17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
| 18 | |
| 19 Sam Lantinga | |
|
251
b8688cfdc232
Updated the headers with the correct e-mail address
Sam Lantinga <slouken@libsdl.org>
parents:
195
diff
changeset
|
20 slouken@libsdl.org |
| 0 | 21 */ |
| 22 | |
| 23 /* This file sets things up for C dynamic library function definitions, | |
| 24 static inlined functions, and structures aligned at 4-byte alignment. | |
| 25 If you don't like ugly C preprocessor code, don't look at this file. :) | |
| 26 */ | |
| 27 | |
| 28 /* This shouldn't be nested -- included it around code only. */ | |
| 29 #ifdef _begin_code_h | |
| 30 #error Nested inclusion of begin_code.h | |
| 31 #endif | |
| 32 #define _begin_code_h | |
| 33 | |
| 34 /* Some compilers use a special export keyword */ | |
| 35 #ifndef DECLSPEC | |
|
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
36 # if defined(__BEOS__) |
| 0 | 37 # if defined(__GNUC__) |
| 38 # define DECLSPEC __declspec(dllexport) | |
| 39 # else | |
| 40 # define DECLSPEC __declspec(export) | |
| 41 # endif | |
|
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
42 # elif defined(__WIN32__) |
|
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
43 # ifdef __BORLANDC__ |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
44 # ifdef BUILD_SDL |
|
1895
c121d94672cb
SDL 1.2 is moving to a branch, and SDL 1.3 is becoming the head.
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
45 # define DECLSPEC |
|
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
46 # else |
|
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
47 # define DECLSPEC __declspec(dllimport) |
|
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
48 # endif |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
49 # else |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
50 # define DECLSPEC __declspec(dllexport) |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
51 # endif |
| 1190 | 52 # else |
|
1595
4aa7df2476e7
Only use the visibility attribute in gcc 4.0 or newer
Sam Lantinga <slouken@libsdl.org>
parents:
1574
diff
changeset
|
53 # if defined(__GNUC__) && __GNUC__ >= 4 |
|
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
54 # define DECLSPEC __attribute__ ((visibility("default"))) |
|
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
55 # else |
|
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
56 # define DECLSPEC |
|
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
57 # endif |
| 0 | 58 # endif |
| 59 #endif | |
| 60 | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
61 /* By default SDL uses the C calling convention */ |
|
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
62 #ifndef SDLCALL |
|
1402
d910939febfa
Use consistent identifiers for the various platforms we support.
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
63 #if defined(__WIN32__) && !defined(__GNUC__) |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
64 #define SDLCALL __cdecl |
|
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
65 #else |
|
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
66 #define SDLCALL |
|
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
67 #endif |
|
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
68 #endif /* SDLCALL */ |
|
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
69 |
|
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
70 /* Removed DECLSPEC on Symbian OS because SDL cannot be a DLL in EPOC */ |
|
1895
c121d94672cb
SDL 1.2 is moving to a branch, and SDL 1.3 is becoming the head.
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
71 #ifdef __SYMBIAN32__ |
|
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
72 #undef DECLSPEC |
|
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
73 #define DECLSPEC |
|
187
94645dc9479b
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
173
diff
changeset
|
74 #endif /* __SYMBIAN32__ */ |
|
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
75 |
| 0 | 76 /* Force structure packing at 4 byte alignment. |
| 77 This is necessary if the header is included in code which has structure | |
| 78 packing set to an alternate value, say for loading structures from disk. | |
| 79 The packing is reset to the previous value in close_code.h | |
| 80 */ | |
|
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
81 #if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__) |
| 0 | 82 #ifdef _MSC_VER |
| 83 #pragma warning(disable: 4103) | |
| 84 #endif | |
| 85 #ifdef __BORLANDC__ | |
| 86 #pragma nopackwarning | |
| 87 #endif | |
|
195
3669d47b07d3
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
189
diff
changeset
|
88 #pragma pack(push,4) |
| 0 | 89 #endif /* Compiler needs structure packing set */ |
| 90 | |
| 91 /* Set up compiler-specific options for inlining functions */ | |
| 92 #ifndef SDL_INLINE_OKAY | |
| 93 #ifdef __GNUC__ | |
| 94 #define SDL_INLINE_OKAY | |
| 95 #else | |
| 96 /* Add any special compiler-specific cases here */ | |
|
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
97 #if defined(_MSC_VER) || defined(__BORLANDC__) || \ |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
98 defined(__DMC__) || defined(__SC__) || \ |
|
1019
e3b3130f3af8
Date: Fri, 31 Dec 2004 04:14:09 +0900
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
99 defined(__WATCOMC__) || defined(__LCC__) || \ |
|
e3b3130f3af8
Date: Fri, 31 Dec 2004 04:14:09 +0900
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
100 defined(__DECC) |
|
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
101 #ifndef __inline__ |
|
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
102 #define __inline__ __inline |
|
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
103 #endif |
|
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
104 #define SDL_INLINE_OKAY |
|
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
105 #else |
|
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
106 #if !defined(__MRC__) && !defined(_SGI_SOURCE) |
|
2123
9a48d1a6fbec
Merged r3075:3076 from branches/SDL-1.2: Careful with __inline__ #define.
Ryan C. Gordon <icculus@icculus.org>
parents:
1978
diff
changeset
|
107 #ifndef __inline__ |
| 0 | 108 #define __inline__ inline |
|
2123
9a48d1a6fbec
Merged r3075:3076 from branches/SDL-1.2: Careful with __inline__ #define.
Ryan C. Gordon <icculus@icculus.org>
parents:
1978
diff
changeset
|
109 #endif |
| 0 | 110 #define SDL_INLINE_OKAY |
| 111 #endif /* Not a funky compiler */ | |
|
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
112 #endif /* Visual C++ */ |
| 0 | 113 #endif /* GNU C */ |
| 114 #endif /* SDL_INLINE_OKAY */ | |
| 115 | |
| 116 /* If inlining isn't supported, remove "__inline__", turning static | |
| 117 inlined functions into static functions (resulting in code bloat | |
| 118 in all files which include the offending header files) | |
| 119 */ | |
| 120 #ifndef SDL_INLINE_OKAY | |
| 121 #define __inline__ | |
| 122 #endif | |
| 123 | |
|
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
124 /* Apparently this is needed by several Windows compilers */ |
|
346
a18ea34d9efe
Fixed precompiled headers on MacOS X
Sam Lantinga <slouken@libsdl.org>
parents:
337
diff
changeset
|
125 #if !defined(__MACH__) |
|
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
126 #ifndef NULL |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
127 #ifdef __cplusplus |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
128 #define NULL 0 |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
129 #else |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
130 #define NULL ((void *)0) |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
131 #endif |
|
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
132 #endif /* NULL */ |
| 1621 | 133 #endif /* ! Mac OS X - breaks precompiled headers */ |