Mercurial > sdl-ios-xcode
annotate include/begin_code.h @ 3618:276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
I reworked this a little. The 1.2 branch isn't really very elegant about this.
author | Ryan C. Gordon <icculus@icculus.org> |
---|---|
date | Wed, 06 Jan 2010 20:58:03 +0000 |
parents | d3baf5ac4e37 |
children | 838fcbc09c68 |
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 | |
3407
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
23 /** |
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
24 * \file begin_code.h |
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
25 * |
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
26 * This file sets things up for C dynamic library function definitions, |
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
27 * static inlined functions, and structures aligned at 4-byte alignment. |
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
28 * If you don't like ugly C preprocessor code, don't look at this file. :) |
d3baf5ac4e37
Partial fix for bug #859
Sam Lantinga <slouken@libsdl.org>
parents:
3292
diff
changeset
|
29 */ |
0 | 30 |
31 /* This shouldn't be nested -- included it around code only. */ | |
32 #ifdef _begin_code_h | |
33 #error Nested inclusion of begin_code.h | |
34 #endif | |
35 #define _begin_code_h | |
36 | |
37 /* Some compilers use a special export keyword */ | |
38 #ifndef DECLSPEC | |
3292 | 39 # if defined(__BEOS__) || defined(__HAIKU__) |
0 | 40 # if defined(__GNUC__) |
41 # define DECLSPEC __declspec(dllexport) | |
42 # else | |
43 # define DECLSPEC __declspec(export) | |
44 # endif | |
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
45 # elif defined(__WIN32__) |
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
46 # ifdef __BORLANDC__ |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
47 # 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
|
48 # define DECLSPEC |
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
49 # else |
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
50 # define DECLSPEC __declspec(dllimport) |
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
51 # endif |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
52 # else |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
53 # define DECLSPEC __declspec(dllexport) |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
251
diff
changeset
|
54 # endif |
3618
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
55 # elif defined(__OS2__) |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
56 # ifdef BUILD_SDL |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
57 # define DECLSPEC __declspec(dllexport) |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
58 # else |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
59 # define DECLSPEC |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
60 # endif |
1190 | 61 # else |
1595
4aa7df2476e7
Only use the visibility attribute in gcc 4.0 or newer
Sam Lantinga <slouken@libsdl.org>
parents:
1574
diff
changeset
|
62 # 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
|
63 # 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
|
64 # else |
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
65 # define DECLSPEC |
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
66 # endif |
0 | 67 # endif |
68 #endif | |
69 | |
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
70 /* 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
|
71 #ifndef SDLCALL |
3618
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
72 # if defined(__WIN32__) && !defined(__GNUC__) |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
73 # define SDLCALL __cdecl |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
74 # elif defined(__OS2__) |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
75 /* Use the _System calling convention to be compatible with every OS/2 |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
76 compiler. (Please note that this used to be _cdecl for GCC, but that |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
77 was a bug. Someone should go examine and fix the XFree86 integration |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
78 instead. We shouldn't be passing SDLCALL function pointers between SDL |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
79 and XFree86!) */ |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
80 # define SDLCALL _System |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
81 # else |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
82 # define SDLCALL |
276a6474a449
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.
Ryan C. Gordon <icculus@icculus.org>
parents:
3407
diff
changeset
|
83 # endif |
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
84 #endif /* SDLCALL */ |
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
85 |
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
86 /* 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
|
87 #ifdef __SYMBIAN32__ |
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
88 #undef DECLSPEC |
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
89 #define DECLSPEC |
187
94645dc9479b
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
173
diff
changeset
|
90 #endif /* __SYMBIAN32__ */ |
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
91 |
0 | 92 /* Force structure packing at 4 byte alignment. |
93 This is necessary if the header is included in code which has structure | |
94 packing set to an alternate value, say for loading structures from disk. | |
95 The packing is reset to the previous value in close_code.h | |
96 */ | |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
97 #if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__) |
0 | 98 #ifdef _MSC_VER |
99 #pragma warning(disable: 4103) | |
100 #endif | |
101 #ifdef __BORLANDC__ | |
102 #pragma nopackwarning | |
103 #endif | |
195
3669d47b07d3
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
189
diff
changeset
|
104 #pragma pack(push,4) |
0 | 105 #endif /* Compiler needs structure packing set */ |
106 | |
107 /* Set up compiler-specific options for inlining functions */ | |
108 #ifndef SDL_INLINE_OKAY | |
109 #ifdef __GNUC__ | |
110 #define SDL_INLINE_OKAY | |
111 #else | |
112 /* 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
|
113 #if defined(_MSC_VER) || defined(__BORLANDC__) || \ |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
114 defined(__DMC__) || defined(__SC__) || \ |
1019
e3b3130f3af8
Date: Fri, 31 Dec 2004 04:14:09 +0900
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
115 defined(__WATCOMC__) || defined(__LCC__) || \ |
e3b3130f3af8
Date: Fri, 31 Dec 2004 04:14:09 +0900
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
116 defined(__DECC) |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
117 #ifndef __inline__ |
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
118 #define __inline__ __inline |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
119 #endif |
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
120 #define SDL_INLINE_OKAY |
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
121 #else |
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
122 #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
|
123 #ifndef __inline__ |
0 | 124 #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
|
125 #endif |
0 | 126 #define SDL_INLINE_OKAY |
127 #endif /* Not a funky compiler */ | |
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
128 #endif /* Visual C++ */ |
0 | 129 #endif /* GNU C */ |
130 #endif /* SDL_INLINE_OKAY */ | |
131 | |
132 /* If inlining isn't supported, remove "__inline__", turning static | |
133 inlined functions into static functions (resulting in code bloat | |
134 in all files which include the offending header files) | |
135 */ | |
136 #ifndef SDL_INLINE_OKAY | |
137 #define __inline__ | |
138 #endif | |
139 | |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
140 /* 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
|
141 #if !defined(__MACH__) |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
142 #ifndef NULL |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
143 #ifdef __cplusplus |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
144 #define NULL 0 |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
145 #else |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
146 #define NULL ((void *)0) |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
147 #endif |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
148 #endif /* NULL */ |
1621 | 149 #endif /* ! Mac OS X - breaks precompiled headers */ |