Mercurial > sdl-ios-xcode
annotate docs/html/sdlquit.html @ 765:4c2ba6161939
Editors Note: The original patch was modified to use SDL_Delay() instead of
nanosleep because nanosleep may not be portable to all systems
using SDL with the ALSA backend. This may be a moot point with
the switch to blocking writes anyway...
Date: Sat, 27 Dec 2003 21:47:36 +0100
From: Michel Daenzer
To: Debian Bug Tracking System
Subject: [SDL] Bug#225252: [PATCH] ALSA fixes
Package: libsdl1.2debian-all
Version: 1.2.6-2
Severity: normal
Tags: patch
For SDL 1.2.6, the ALSA backend was changed to call snd_pcm_open() with
SND_PCM_NONBLOCK. That's a good idea per se, however, it causes high CPU
usage, interrupted sound and stuttering in some games here. Taking a nanosleep
whenever snd_pcm_writei() returns -EAGAIN fixes this, but I think it's more
efficient to use blocking mode for the actual sound playback. Feedback from the
SDL and ALSA lists appreciated.
The patch also fixes the default ALSA device to be used.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Sun, 04 Jan 2004 15:40:50 +0000 |
| parents | 55f1f1b3e27d |
| children | 355632dca928 |
| rev | line source |
|---|---|
| 0 | 1 <HTML |
| 2 ><HEAD | |
| 3 ><TITLE | |
| 4 >SDL_Quit</TITLE | |
| 5 ><META | |
| 6 NAME="GENERATOR" | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64 |
| 0 | 8 "><LINK |
| 9 REL="HOME" | |
| 10 TITLE="SDL Library Documentation" | |
| 11 HREF="index.html"><LINK | |
| 12 REL="UP" | |
| 13 TITLE="General" | |
| 14 HREF="general.html"><LINK | |
| 15 REL="PREVIOUS" | |
| 16 TITLE="SDL_QuitSubSystem" | |
| 17 HREF="sdlquitsubsystem.html"><LINK | |
| 18 REL="NEXT" | |
| 19 TITLE="SDL_WasInit" | |
| 20 HREF="sdlwasinit.html"></HEAD | |
| 21 ><BODY | |
| 22 CLASS="REFENTRY" | |
| 23 BGCOLOR="#FFF8DC" | |
| 24 TEXT="#000000" | |
| 25 LINK="#0000ee" | |
| 26 VLINK="#551a8b" | |
| 27 ALINK="#ff0000" | |
| 28 ><DIV | |
| 29 CLASS="NAVHEADER" | |
| 30 ><TABLE | |
| 31 WIDTH="100%" | |
| 32 BORDER="0" | |
| 33 CELLPADDING="0" | |
| 34 CELLSPACING="0" | |
| 35 ><TR | |
| 36 ><TH | |
| 37 COLSPAN="3" | |
| 38 ALIGN="center" | |
| 39 >SDL Library Documentation</TH | |
| 40 ></TR | |
| 41 ><TR | |
| 42 ><TD | |
| 43 WIDTH="10%" | |
| 44 ALIGN="left" | |
| 45 VALIGN="bottom" | |
| 46 ><A | |
| 47 HREF="sdlquitsubsystem.html" | |
| 48 >Prev</A | |
| 49 ></TD | |
| 50 ><TD | |
| 51 WIDTH="80%" | |
| 52 ALIGN="center" | |
| 53 VALIGN="bottom" | |
| 54 ></TD | |
| 55 ><TD | |
| 56 WIDTH="10%" | |
| 57 ALIGN="right" | |
| 58 VALIGN="bottom" | |
| 59 ><A | |
| 60 HREF="sdlwasinit.html" | |
| 61 >Next</A | |
| 62 ></TD | |
| 63 ></TR | |
| 64 ></TABLE | |
| 65 ><HR | |
| 66 ALIGN="LEFT" | |
| 67 WIDTH="100%"></DIV | |
| 68 ><H1 | |
| 69 ><A | |
| 70 NAME="SDLQUIT" | |
| 71 >SDL_Quit</A | |
| 72 ></H1 | |
| 73 ><DIV | |
| 74 CLASS="REFNAMEDIV" | |
| 75 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
76 NAME="AEN585" |
| 0 | 77 ></A |
| 78 ><H2 | |
| 79 >Name</H2 | |
| 80 >SDL_Quit -- Shut down SDL</DIV | |
| 81 ><DIV | |
| 82 CLASS="REFSYNOPSISDIV" | |
| 83 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
84 NAME="AEN588" |
| 0 | 85 ></A |
| 86 ><H2 | |
| 87 >Synopsis</H2 | |
| 88 ><DIV | |
| 89 CLASS="FUNCSYNOPSIS" | |
| 90 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
91 NAME="AEN589" |
| 0 | 92 ></A |
| 93 ><P | |
| 94 ></P | |
| 95 ><PRE | |
| 96 CLASS="FUNCSYNOPSISINFO" | |
| 97 >#include "SDL.h"</PRE | |
| 98 ><P | |
| 99 ><CODE | |
| 100 ><CODE | |
| 101 CLASS="FUNCDEF" | |
| 102 >void <B | |
| 103 CLASS="FSFUNC" | |
| 104 >SDL_Quit</B | |
| 105 ></CODE | |
| 106 >(void);</CODE | |
| 107 ></P | |
| 108 ><P | |
| 109 ></P | |
| 110 ></DIV | |
| 111 ></DIV | |
| 112 ><DIV | |
| 113 CLASS="REFSECT1" | |
| 114 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
115 NAME="AEN595" |
| 0 | 116 ></A |
| 117 ><H2 | |
| 118 >Description</H2 | |
| 119 ><P | |
| 120 ><TT | |
| 121 CLASS="FUNCTION" | |
| 122 >SDL_Quit</TT | |
| 123 > shuts down all SDL subsystems and frees the resources allocated to them. This should always be called before you exit. For the sake of simplicity you can set <TT | |
| 124 CLASS="FUNCTION" | |
| 125 >SDL_Quit</TT | |
| 126 > as your <TT | |
| 127 CLASS="FUNCTION" | |
| 128 >atexit</TT | |
| 129 > call, like: | |
| 130 <PRE | |
| 131 CLASS="PROGRAMLISTING" | |
| 132 >SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO); | |
| 133 atexit(SDL_Quit); | |
| 134 . | |
| 135 .</PRE | |
| 136 ></P | |
| 137 ><DIV | |
| 138 CLASS="NOTE" | |
| 139 ><BLOCKQUOTE | |
| 140 CLASS="NOTE" | |
| 141 ><P | |
| 142 ><B | |
| 143 >Note: </B | |
| 144 >While using <TT | |
| 145 CLASS="FUNCTION" | |
| 146 >atexit</TT | |
| 147 > maybe be fine for small programs, more advanced users should shut down SDL in their own cleanup code. Plus, using <TT | |
| 148 CLASS="FUNCTION" | |
| 149 >atexit</TT | |
| 150 > in a library is a sure way to crash dynamically loaded code</P | |
| 151 ></BLOCKQUOTE | |
| 152 ></DIV | |
| 153 ></DIV | |
| 154 ><DIV | |
| 155 CLASS="REFSECT1" | |
| 156 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
157 NAME="AEN606" |
| 0 | 158 ></A |
| 159 ><H2 | |
| 160 >See Also</H2 | |
| 161 ><P | |
| 162 ><A | |
| 163 HREF="sdlquitsubsystem.html" | |
| 164 ><TT | |
| 165 CLASS="FUNCTION" | |
| 166 >SDL_QuitSubsystem</TT | |
| 167 ></A | |
| 168 >, | |
| 169 <A | |
| 170 HREF="sdlinit.html" | |
| 171 ><TT | |
| 172 CLASS="FUNCTION" | |
| 173 >SDL_Init</TT | |
| 174 ></A | |
| 175 ></P | |
| 176 ></DIV | |
| 177 ><DIV | |
| 178 CLASS="NAVFOOTER" | |
| 179 ><HR | |
| 180 ALIGN="LEFT" | |
| 181 WIDTH="100%"><TABLE | |
| 182 WIDTH="100%" | |
| 183 BORDER="0" | |
| 184 CELLPADDING="0" | |
| 185 CELLSPACING="0" | |
| 186 ><TR | |
| 187 ><TD | |
| 188 WIDTH="33%" | |
| 189 ALIGN="left" | |
| 190 VALIGN="top" | |
| 191 ><A | |
| 192 HREF="sdlquitsubsystem.html" | |
| 193 >Prev</A | |
| 194 ></TD | |
| 195 ><TD | |
| 196 WIDTH="34%" | |
| 197 ALIGN="center" | |
| 198 VALIGN="top" | |
| 199 ><A | |
| 200 HREF="index.html" | |
| 201 >Home</A | |
| 202 ></TD | |
| 203 ><TD | |
| 204 WIDTH="33%" | |
| 205 ALIGN="right" | |
| 206 VALIGN="top" | |
| 207 ><A | |
| 208 HREF="sdlwasinit.html" | |
| 209 >Next</A | |
| 210 ></TD | |
| 211 ></TR | |
| 212 ><TR | |
| 213 ><TD | |
| 214 WIDTH="33%" | |
| 215 ALIGN="left" | |
| 216 VALIGN="top" | |
| 217 >SDL_QuitSubSystem</TD | |
| 218 ><TD | |
| 219 WIDTH="34%" | |
| 220 ALIGN="center" | |
| 221 VALIGN="top" | |
| 222 ><A | |
| 223 HREF="general.html" | |
| 224 >Up</A | |
| 225 ></TD | |
| 226 ><TD | |
| 227 WIDTH="33%" | |
| 228 ALIGN="right" | |
| 229 VALIGN="top" | |
| 230 >SDL_WasInit</TD | |
| 231 ></TR | |
| 232 ></TABLE | |
| 233 ></DIV | |
| 234 ></BODY | |
| 235 ></HTML | |
| 236 > |