Mercurial > sdl-ios-xcode
annotate include/begin_code.h @ 4216:5b99971a27b4 SDL-1.2
Fixed bug #698
Hans de Goede 2009-02-13 01:10:52 PST
Since the new "glitch free" version of pulseaudio (used in Fedora 10 amongst
others), the sound of SDL using apps (like a simple playmus call) has been
crackling.
While looking in to fixing this I noticed that the current pulseaudio code in
SDL uses pa_simple. However pa_simple uses a thread to pump pulseaudio events
and ipc, given that SDL already has its own thread for audio handling this is
clearly suboptimal, leading to unnecessary context switching IPC, etc. Also
pa_simple does not allow one to implement the WaitAudio() callback for SDL
audiodrivers properly.
Given that my work is mostly a rewrite (although some original pieces remain)
I'm attaching the new .c and .h file, as that is easier to review then the huge
diff.
Let me know if you also want the diff.
This new version has the following features:
-no longer use an additional thread next to the SDL sound thread
-do not crackle with glitch free audio
-when used with a newer pulse, which does glitch free audio, the total latency
is
the same as with the alsa driver
-proper WaitAudio() implementation, saving another mixlen worth of latency
-adds a WaitDone() implementation
This patch has been written in consultancy with Lennart Poetering (the
pulseaudio author) and has been reviewed by him for correct use of the pa API.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Mon, 21 Sep 2009 09:27:08 +0000 |
parents | 430e6690c4cd |
children | 4c4113c2162c |
rev | line source |
---|---|
0 | 1 /* |
2 SDL - Simple DirectMedia Layer | |
4159 | 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 | |
4164
7a4c511c980a
Date: Fri, 6 Mar 2009 12:41:17 -0800
Sam Lantinga <slouken@libsdl.org>
parents:
4159
diff
changeset
|
36 # if defined(__BEOS__) || defined(__HAIKU__) |
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 |
636
d9c2ab142f2f
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
346
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 |
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
52 # elif defined(__OS2__) |
1190 | 53 # ifdef __WATCOMC__ |
54 # ifdef BUILD_SDL | |
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
55 # define DECLSPEC __declspec(dllexport) |
1190 | 56 # else |
1574
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
57 # define DECLSPEC |
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
58 # endif |
4193
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
59 # elif defined (__GNUC__) && __GNUC__ < 4 |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
60 # /* Added support for GCC-EMX <v4.x */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
61 # /* this is needed for XFree86/OS2 developement */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
62 # /* F. Ambacher(anakor@snafu.de) 05.2008 */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
63 # ifdef BUILD_SDL |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
64 # define DECLSPEC __declspec(dllexport) |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
65 # else |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
66 # define DECLSPEC |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
67 # endif |
1190 | 68 # else |
69 # define DECLSPEC | |
70 # endif | |
71 # else | |
1595
4aa7df2476e7
Only use the visibility attribute in gcc 4.0 or newer
Sam Lantinga <slouken@libsdl.org>
parents:
1574
diff
changeset
|
72 # 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
|
73 # 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
|
74 # else |
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
75 # define DECLSPEC |
0fd72308659e
Default to use the visibility attribute, on gcc (is this okay?)
Sam Lantinga <slouken@libsdl.org>
parents:
1573
diff
changeset
|
76 # endif |
0 | 77 # endif |
78 #endif | |
79 | |
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
80 /* 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
|
81 #ifndef SDLCALL |
4193
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
82 # if defined(__WIN32__) && !defined(__GNUC__) |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
83 # define SDLCALL __cdecl |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
84 # elif defined(__OS2__) |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
85 # if defined (__GNUC__) && __GNUC__ < 4 |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
86 # /* Added support for GCC-EMX <v4.x */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
87 # /* this is needed for XFree86/OS2 developement */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
88 # /* F. Ambacher(anakor@snafu.de) 05.2008 */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
89 # define SDLCALL _cdecl |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
90 # else |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
91 # /* On other compilers on OS/2, we use the _System calling convention */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
92 # /* to be compatible with every compiler */ |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
93 # define SDLCALL _System |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
94 # endif |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
95 # else |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
96 # define SDLCALL |
430e6690c4cd
GCC 3.03 support on OS/2.
Ryan C. Gordon <icculus@icculus.org>
parents:
4164
diff
changeset
|
97 # endif |
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
98 #endif /* SDLCALL */ |
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
99 |
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
100 #ifdef __SYMBIAN32__ |
3975 | 101 #ifndef EKA2 |
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
102 #undef DECLSPEC |
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
103 #define DECLSPEC |
3975 | 104 #elif !defined(__WINS__) |
105 #undef DECLSPEC | |
106 #define DECLSPEC __declspec(dllexport) | |
4091
98b219f9ff17
Removed some C++ style comments from the public headers.
Ryan C. Gordon <icculus@icculus.org>
parents:
3975
diff
changeset
|
107 #endif /* !EKA2 */ |
98b219f9ff17
Removed some C++ style comments from the public headers.
Ryan C. Gordon <icculus@icculus.org>
parents:
3975
diff
changeset
|
108 #endif /* __SYMBIAN32__ */ |
173
83018110dce8
Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
85
diff
changeset
|
109 |
0 | 110 /* Force structure packing at 4 byte alignment. |
111 This is necessary if the header is included in code which has structure | |
112 packing set to an alternate value, say for loading structures from disk. | |
113 The packing is reset to the previous value in close_code.h | |
114 */ | |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
115 #if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__) |
0 | 116 #ifdef _MSC_VER |
117 #pragma warning(disable: 4103) | |
118 #endif | |
119 #ifdef __BORLANDC__ | |
120 #pragma nopackwarning | |
121 #endif | |
195
3669d47b07d3
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
189
diff
changeset
|
122 #pragma pack(push,4) |
1402
d910939febfa
Use consistent identifiers for the various platforms we support.
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
123 #elif (defined(__MWERKS__) && defined(__MACOS__)) |
189
175917167aac
Date: Thu, 13 Sep 2001 14:14:42 -0400
Sam Lantinga <slouken@libsdl.org>
parents:
187
diff
changeset
|
124 #pragma options align=mac68k4byte |
175917167aac
Date: Thu, 13 Sep 2001 14:14:42 -0400
Sam Lantinga <slouken@libsdl.org>
parents:
187
diff
changeset
|
125 #pragma enumsalwaysint on |
0 | 126 #endif /* Compiler needs structure packing set */ |
127 | |
128 /* Set up compiler-specific options for inlining functions */ | |
129 #ifndef SDL_INLINE_OKAY | |
130 #ifdef __GNUC__ | |
131 #define SDL_INLINE_OKAY | |
132 #else | |
133 /* 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
|
134 #if defined(_MSC_VER) || defined(__BORLANDC__) || \ |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
135 defined(__DMC__) || defined(__SC__) || \ |
1019
e3b3130f3af8
Date: Fri, 31 Dec 2004 04:14:09 +0900
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
136 defined(__WATCOMC__) || defined(__LCC__) || \ |
3975 | 137 defined(__DECC) || defined(__EABI__) |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
138 #ifndef __inline__ |
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
139 #define __inline__ __inline |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
140 #endif |
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
141 #define SDL_INLINE_OKAY |
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
142 #else |
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
143 #if !defined(__MRC__) && !defined(_SGI_SOURCE) |
3965
19d708301fab
Make sure __inline__ isn't defined before #defining it, since some compilers
Ryan C. Gordon <icculus@icculus.org>
parents:
1621
diff
changeset
|
144 #ifndef __inline__ |
0 | 145 #define __inline__ inline |
3965
19d708301fab
Make sure __inline__ isn't defined before #defining it, since some compilers
Ryan C. Gordon <icculus@icculus.org>
parents:
1621
diff
changeset
|
146 #endif |
0 | 147 #define SDL_INLINE_OKAY |
148 #endif /* Not a funky compiler */ | |
85
60c7960354e0
Added support for Visual C++ inline keyword
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
149 #endif /* Visual C++ */ |
0 | 150 #endif /* GNU C */ |
151 #endif /* SDL_INLINE_OKAY */ | |
152 | |
153 /* If inlining isn't supported, remove "__inline__", turning static | |
154 inlined functions into static functions (resulting in code bloat | |
155 in all files which include the offending header files) | |
156 */ | |
157 #ifndef SDL_INLINE_OKAY | |
158 #define __inline__ | |
159 #endif | |
160 | |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
161 /* 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
|
162 #if !defined(__MACH__) |
288
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
163 #ifndef NULL |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
164 #ifdef __cplusplus |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
165 #define NULL 0 |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
166 #else |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
167 #define NULL ((void *)0) |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
168 #endif |
2f5a6062db86
Updated for Watcom C++ and LCC compilers
Sam Lantinga <slouken@libsdl.org>
parents:
274
diff
changeset
|
169 #endif /* NULL */ |
1621 | 170 #endif /* ! Mac OS X - breaks precompiled headers */ |