Commit 028b0ae9 authored by Sam Lantinga's avatar Sam Lantinga

Added new docs for SDL 1.2.1

--HG--
extra : convert_revision : svn%3Ac70aab31-4412-0410-b14c-859654838e24/trunk%4056
parent 16ce3048
......@@ -20,6 +20,7 @@ EXTRA_DIST = \
guidetimeexamples.html \
guidevideo.html \
guidevideoexamples.html \
guidevideoopengl.html \
index.html \
joystick.html \
reference.html \
......
......@@ -4,7 +4,7 @@
>Audio</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>CD-ROM</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>Events</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -85,7 +85,7 @@ CLASS="TOC"
></DT
><DT
><A
HREF="event.html#AEN3194"
HREF="event.html#AEN3269"
>Introduction</A
></DT
><DT
......@@ -105,7 +105,7 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN3194"
NAME="AEN3269"
>Introduction</A
></H1
><P
......
......@@ -4,7 +4,7 @@
>Event Functions.</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>SDL Event Structures.</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>General</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>SDL Guide</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>About SDLdoc</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -74,9 +74,9 @@ NAME="GUIDEABOUTSDLDOC"
>About SDLdoc</A
></H1
><P
>SDLdoc (The SDL Documentation Project) was formed to completely rewrite the SDL documentation and to keep it continually up to date. The team consists completely of volunteers ranging from proplr working with SDL in their spare time to people who use SDL in their everyday working lives.</P
>SDLdoc (The SDL Documentation Project) was formed to completely rewrite the SDL documentation and to keep it continually up to date. The team consists completely of volunteers ranging from people working with SDL in their spare time to people who use SDL in their everyday working lives.</P
><P
>The latest version of this documentation can always be found at the project homepage: http://sdldoc.sourceforge.net.</P
>The latest version of this documentation can always be found here: http://sdldoc.csn.ul.ie Downloadable PS, man pages and html tarballs are available at http://sdldoc.csn.ul.ie/pub/</P
></DIV
><DIV
CLASS="NAVFOOTER"
......
......@@ -4,7 +4,7 @@
>Audio Examples</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -80,7 +80,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN343"
NAME="AEN382"
>Opening the audio device</A
></H2
><P
......@@ -110,7 +110,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN347"
NAME="AEN386"
>Playing audio</A
></H2
><P
......
......@@ -4,7 +4,7 @@
>Initializing SDL</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -133,7 +133,15 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>SDL_GetError</TT
>. Use this often, you can never know too much about an error.</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN60"
></A
><P
><B
>Example 1-1. Initializing SDL</B
></P
><PRE
CLASS="PROGRAMLISTING"
>#include "SDL.h" /* All SDL App's need this */
......@@ -160,7 +168,7 @@ int main() {
exit(0);
}&#13;</PRE
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
......
......@@ -4,7 +4,7 @@
>CDROM Examples</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -80,7 +80,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN354"
NAME="AEN393"
>Listing CD-ROM drives</A
></H2
><P
......@@ -107,7 +107,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN358"
NAME="AEN397"
>Opening the default drive</A
></H2
><P
......@@ -156,7 +156,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN362"
NAME="AEN401"
>Listing the tracks on a CD</A
></H2
><P
......@@ -182,7 +182,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN366"
NAME="AEN405"
>Play an entire CD</A
></H2
><P
......
......@@ -4,7 +4,7 @@
>Credits</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -81,10 +81,18 @@ BORDER="0"
><TBODY
><TR
><TD
>Sam Lantinga, slouken@libsdl.org</TD
></TR
><TR
><TD
>Martin Donlon, akawaka@skynet.ie</TD
></TR
><TR
><TD
>Mattias Engdegrd</TD
></TR
><TR
><TD
>Julian Peterson</TD
></TR
><TR
......
......@@ -4,7 +4,7 @@
>Event Examples</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -13,8 +13,8 @@ REL="UP"
TITLE="Examples"
HREF="guideexamples.html"><LINK
REL="PREVIOUS"
TITLE="Video Examples"
HREF="guidevideoexamples.html"><LINK
TITLE="Examples"
HREF="guideexamples.html"><LINK
REL="NEXT"
TITLE="Audio Examples"
HREF="guideaudioexamples.html"></HEAD
......@@ -44,7 +44,7 @@ WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="guidevideoexamples.html"
HREF="guideexamples.html"
>Prev</A
></TD
><TD
......@@ -80,7 +80,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN336"
NAME="AEN375"
>Filtering and Handling Events</A
></H2
><P
......@@ -192,7 +192,7 @@ WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="guidevideoexamples.html"
HREF="guideexamples.html"
>Prev</A
></TD
><TD
......@@ -217,7 +217,7 @@ HREF="guideaudioexamples.html"
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Video Examples</TD
>Examples</TD
><TD
WIDTH="34%"
ALIGN="center"
......
......@@ -4,7 +4,7 @@
>Examples</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -16,8 +16,8 @@ REL="PREVIOUS"
TITLE="Handling the Keyboard"
HREF="guideinputkeyboard.html"><LINK
REL="NEXT"
TITLE="Video Examples"
HREF="guidevideoexamples.html"></HEAD
TITLE="Event Examples"
HREF="guideeventexamples.html"></HEAD
><BODY
CLASS="CHAPTER"
BGCOLOR="#FFF8DC"
......@@ -57,7 +57,7 @@ WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="guidevideoexamples.html"
HREF="guideeventexamples.html"
>Next</A
></TD
></TR
......@@ -81,16 +81,11 @@ CLASS="TOC"
></DT
><DT
><A
HREF="guideexamples.html#AEN297"
HREF="guideexamples.html#AEN369"
>Introduction</A
></DT
><DT
><A
HREF="guidevideoexamples.html"
>Video Examples</A
></DT
><DT
><A
HREF="guideeventexamples.html"
>Event Examples</A
></DT
......@@ -116,11 +111,11 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN297"
NAME="AEN369"
>Introduction</A
></H1
><P
>For the moment these examples are taken directly from the old SDL documentation.</P
>For the moment these examples are taken directly from the old SDL documentation. By the 1.2 release these examples should hopefully deal with most common SDL programming problems.</P
></DIV
></DIV
><DIV
......@@ -154,7 +149,7 @@ WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="guidevideoexamples.html"
HREF="guideeventexamples.html"
>Next</A
></TD
></TR
......@@ -176,7 +171,7 @@ HREF="guide.html"
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Video Examples</TD
>Event Examples</TD
></TR
></TABLE
></DIV
......
This diff is collapsed.
......@@ -4,7 +4,7 @@
>Handling the Keyboard</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -78,7 +78,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN205"
NAME="AEN271"
>Keyboard Related Structures</A
></H2
><P
......@@ -88,7 +88,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN208"
NAME="AEN274"
>SDLKey</A
></H3
><P
......@@ -114,7 +114,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN216"
NAME="AEN282"
>SDLMod</A
></H3
><P
......@@ -134,7 +134,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN222"
NAME="AEN288"
>SDL_keysym</A
></H3
><PRE
......@@ -215,7 +215,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN241"
NAME="AEN307"
>SDL_KeyboardEvent</A
></H3
><PRE
......@@ -283,7 +283,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN258"
NAME="AEN324"
>Reading Keyboard Events</A
></H2
><P
......@@ -308,8 +308,17 @@ CLASS="LITERAL"
> events using a <TT
CLASS="LITERAL"
>switch</TT
> statement, like so:
<PRE
> statement, like so:</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN334"
></A
><P
><B
>Example 3-10. Reading Keyboard Events</B
></P
><PRE
CLASS="PROGRAMLISTING"
> SDL_Event event;
.
......@@ -334,15 +343,16 @@ CLASS="PROGRAMLISTING"
}
.
.</PRE
>
This is a very basic example. No information about the key press or release is interpreted. We will explore the other extreme out our first full example below - reporting all available information about a keyboard event.</P
></DIV
><P
>This is a very basic example. No information about the key press or release is interpreted. We will explore the other extreme out our first full example below - reporting all available information about a keyboard event.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN269"
NAME="AEN338"
>A More Detailed Look</A
></H2
><P
......@@ -384,11 +394,11 @@ CLASS="NOTE"
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN282"
NAME="AEN351"
></A
><P
><B
>Example 3-1. keys.c - Key event information</B
>Example 3-11. Interpreting Key Event Information</B
></P
><PRE
CLASS="PROGRAMLISTING"
......@@ -405,7 +415,7 @@ CLASS="PROGRAMLISTING"
int quit = 0;
/* Initialise SDL */
if( SDL_Init( SDL_INIT_VIDEO ) ){
if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0){
fprintf( stderr, "Could not initialise SDL: %s\n", SDL_GetError() );
exit( -1 );
}
......@@ -518,13 +528,13 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN285"
NAME="AEN354"
>Game-type Input</A
></H2
><P
>I have found that people using keyboard events for games and other interactive applications don't always understand one fundemental point.</P
><A
NAME="AEN288"
NAME="AEN357"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
......@@ -575,8 +585,17 @@ CLASS="PROGRAMLISTING"
>
At first glance you may think this is a perfectly reasonable piece of code for the task, but it isn't. Like I said keyboard events only occur when a key changes state, so the user would have to press and release the left cursor key 100 times to move the alien 100 pixels to the left.</P
><P
>To get around this problem we must not use the events to change the position of the alien, we use the events to set flags which are then used in a seperate section of code to move the alien. Something like this:
<PRE
>To get around this problem we must not use the events to change the position of the alien, we use the events to set flags which are then used in a seperate section of code to move the alien. Something like this:</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN363"
></A
><P
><B
>Example 3-12. Proper Game Movement</B
></P
><PRE
CLASS="PROGRAMLISTING"
> /* Alien screen coordinates */
int alien_x=0, alien_y=0;
......@@ -649,8 +668,9 @@ CLASS="PROGRAMLISTING"
/* Update the alien position */
alien_x += alien_xvel;
alien_y += alien_yvel;</PRE
>
As can be seen, we use two extra variables, alien_xvel and alien_yvel, which represent the motion of the ship, it is these variables that we update when we detect keypresses and releases.</P
></DIV
><P
>As can be seen, we use two extra variables, alien_xvel and alien_yvel, which represent the motion of the ship, it is these variables that we update when we detect keypresses and releases.</P
></DIV
></DIV
><DIV
......
......@@ -4,7 +4,7 @@
>Preface</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>The Basics</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>Time Examples</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -80,7 +80,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN373"
NAME="AEN412"
>Time based game loop</A
></H2
><P
......
This diff is collapsed.
......@@ -4,7 +4,7 @@
>Video Examples</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -80,7 +80,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN303"
NAME="AEN375"
>Initializing the video display</A
></H2
><P
......@@ -112,7 +112,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN307"
NAME="AEN379"
>Initializing the best video mode</A
></H2
><P
......@@ -134,7 +134,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN311"
NAME="AEN383"
>Loading and displaying a BMP file</A
></H2
><P
......@@ -211,7 +211,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN315"
NAME="AEN387"
>Drawing directly to the display</A
></H2
><P
......@@ -276,7 +276,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN319"
NAME="AEN391"
>Fastest possible surface blit</A
></H2
><P
......
This diff is collapsed.
......@@ -4,7 +4,7 @@
></TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="NEXT"
TITLE="SDL Guide"
......@@ -87,7 +87,12 @@ HREF="guidevideo.html"
><DL
><DT
><A
HREF="guidevideo.html#GUIDEVIDEOOPENGL"
HREF="guidevideo.html#GUIDEVIDEOINTRO"
>Introduction to SDL Video</A
></DT
><DT
><A
HREF="guidevideoopengl.html"
>Using OpenGL With SDL</A
></DT
></DL
......@@ -120,16 +125,11 @@ HREF="guideexamples.html"
><DL
><DT
><A
HREF="guideexamples.html#AEN297"
HREF="guideexamples.html#AEN369"
>Introduction</A
></DT
><DT
><A
HREF="guidevideoexamples.html"
>Video Examples</A
></DT
><DT
><A
HREF="guideeventexamples.html"
>Event Examples</A
></DT
......@@ -305,7 +305,7 @@ HREF="sdlcreatergbsurfacefrom.html"
><A
HREF="sdlfreesurface.html"
>SDL_FreeSurface</A
> &#8212; Frees (deletes) and SDL_Surface</DT
> &#8212; Frees (deletes) a SDL_Surface</DT
><DT
><A
HREF="sdllocksurface.html"
......@@ -542,7 +542,7 @@ HREF="event.html"
><DL
><DT
><A
HREF="event.html#AEN3194"
HREF="event.html#AEN3269"
>Introduction</A
></DT
><DT
......@@ -965,7 +965,7 @@ CLASS="LOT"
></DT
><DT
>8-1. <A
HREF="sdlkey.html#AEN4177"
HREF="sdlkey.html#AEN4252"
>SDL Keysym definitions</A
></DT
><DT
......@@ -984,14 +984,109 @@ CLASS="LOT"
>List of Examples</B
></DT
><DT
>1-1. <A
HREF="guidebasicsinit.html#AEN60"
>Initializing SDL</A
></DT
><DT
>2-1. <A
HREF="guidevideo.html#AEN87"
>gl.c - SDL OpenGL Example</A
HREF="guidevideo.html#AEN71"
>Initializing the Video Display</A
></DT
><DT
>2-2. <A
HREF="guidevideo.html#AEN77"
>Initializing the Best Video Mode</A
></DT
><DT
>2-3. <A
HREF="guidevideo.html#AEN83"
>Loading and Displaying a BMP File</A
></DT
><DT
>2-4. <A
HREF="guidevideo.html#AEN90"
>getpixel()</A
></DT
><DT
>2-5. <A
HREF="guidevideo.html#AEN93"
>putpixel()</A
></DT
><DT
>2-6. <A
HREF="guidevideo.html#AEN97"
>Using putpixel()</A
></DT
><DT
>2-7. <A
HREF="guidevideoopengl.html#AEN114"
>Initializing SDL with OpenGL</A
></DT
><DT
>2-8. <A
HREF="guidevideoopengl.html#AEN128"
>SDL and OpenGL</A
></DT
><DT
>3-1. <A
HREF="guideinputkeyboard.html#AEN282"
>keys.c - Key event information</A
HREF="guideinput.html#AEN141"
>Initializing SDL with Joystick Support</A
></DT
><DT
>3-2. <A
HREF="guideinput.html#AEN154"
>Querying the Number of Available Joysticks</A
></DT
><DT
>3-3. <A
HREF="guideinput.html#AEN183"
>Opening a Joystick</A
></DT
><DT
>3-4. <A
HREF="guideinput.html#AEN191"
>Joystick Axis Events</A
></DT
><DT
>3-5. <A
HREF="guideinput.html#AEN195"
>More Joystick Axis Events</A
></DT
><DT
>3-6. <A
HREF="guideinput.html#AEN203"
>Joystick Button Events</A
></DT
><DT
>3-7. <A
HREF="guideinput.html#AEN217"
>Joystick Ball Events</A
></DT
><DT
>3-8. <A
HREF="guideinput.html#AEN244"
>Joystick Hat Events</A
></DT
><DT
>3-9. <A
HREF="guideinput.html#AEN265"
>Querying Joystick Characteristics</A
></DT
><DT
>3-10. <A
HREF="guideinputkeyboard.html#AEN334"
>Reading Keyboard Events</A
></DT
><DT
>3-11. <A
HREF="guideinputkeyboard.html#AEN351"
>Interpreting Key Event Information</A
></DT
><DT
>3-12. <A
HREF="guideinputkeyboard.html#AEN363"
>Proper Game Movement</A
></DT
></DL
></DIV
......
......@@ -4,7 +4,7 @@
>Joystick</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>SDL Reference</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......
......@@ -4,7 +4,7 @@
>SDL_ActiveEvent</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLACTIVEEVENT"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN3447"
NAME="AEN3522"
></A
><H2
>Name</H2
......@@ -81,7 +81,7 @@ NAME="AEN3447"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3450"
NAME="AEN3525"
></A
><H2
>Structure Definition</H2
......@@ -96,14 +96,14 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3453"
NAME="AEN3528"
></A
><H2
>Structure Data</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3455"
NAME="AEN3530"
></A
><P
></P
......@@ -187,7 +187,7 @@ CLASS="STRUCTFIELD"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3476"
NAME="AEN3551"
></A
><H2
>Description</H2
......@@ -245,7 +245,7 @@ CLASS="NOTE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3492"
NAME="AEN3567"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_AddTimer</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLADDTIMER"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7854"
NAME="AEN7933"
></A
><H2
>Name</H2
......@@ -82,14 +82,14 @@ elapsed.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7857"
NAME="AEN7936"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7858"
NAME="AEN7937"
></A
><P
></P
......@@ -125,7 +125,7 @@ typedef Uint32 (*SDL_NewTimerCallback)(Uint32 interval, void *param);</PRE
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7867"
NAME="AEN7946"
></A
><H2
>Description</H2
......@@ -153,9 +153,15 @@ CLASS="FUNCTION"
>.</P
><P
>The timer callback function may run in a different thread than your
main program, and so shouldn't call any functions from within itself.</P
main program, and so shouldn't call any functions from within itself.
You may always call <A
HREF="sdlpushevent.html"
>SDL_PushEvent</A
>, however.</P
><P
>The maximum resolution of this timer is 10 ms, which means that if
>The granularity of the timer is platform-dependent, but you should count
on it being at least 10 ms as this is the most common number.
This means that if
you request a 16 ms timer, your callback will run approximately 20 ms
later on an unloaded system. If you wanted to set a flag signaling
a frame update at 30 frames per second (every 33 ms), you might set a
......@@ -173,7 +179,7 @@ HREF="sdlinit.html"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7878"
NAME="AEN7958"
></A
><H2
>Return Value</H2
......@@ -187,7 +193,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7882"
NAME="AEN7962"
></A
><H2
>Examples</H2
......@@ -200,7 +206,7 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7886"
NAME="AEN7966"
></A
><H2
>See Also</H2
......@@ -211,6 +217,13 @@ HREF="sdlremovetimer.html"
CLASS="FUNCTION"
>SDL_RemoveTimer</TT
></A
>,
<A
HREF="sdlpushevent.html"
><TT
CLASS="FUNCTION"
>SDL_PushEvent</TT
></A
></P
></DIV
><DIV
......
......@@ -4,7 +4,7 @@
>SDL_AudioCVT</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLAUDIOCVT"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6262"
NAME="AEN6337"
></A
><H2
>Name</H2
......@@ -81,7 +81,7 @@ NAME="AEN6262"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6265"
NAME="AEN6340"
></A
><H2
>Structure Definition</H2
......@@ -104,14 +104,14 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6268"
NAME="AEN6343"
></A
><H2
>Structure Data</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6270"
NAME="AEN6345"
></A
><P
></P
......@@ -318,7 +318,7 @@ VALIGN="TOP"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6322"
NAME="AEN6397"
></A
><H2
>Description</H2
......@@ -459,7 +459,7 @@ CLASS="STRUCTFIELD"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6367"
NAME="AEN6442"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_AudioSpec</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLAUDIOSPEC"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN5885"
NAME="AEN5960"
></A
><H2
>Name</H2
......@@ -81,7 +81,7 @@ NAME="AEN5885"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5888"
NAME="AEN5963"
></A
><H2
>Structure Definition</H2
......@@ -101,14 +101,14 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5891"
NAME="AEN5966"
></A
><H2
>Structure Data</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5893"
NAME="AEN5968"
></A
><P
></P
......@@ -245,7 +245,7 @@ VALIGN="TOP"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5928"
NAME="AEN6003"
></A
><H2
>Description</H2
......@@ -295,7 +295,7 @@ CLASS="FUNCTION"
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5942"
NAME="AEN6017"
></A
><P
></P
......@@ -499,7 +499,7 @@ CLASS="STRUCTFIELD"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6017"
NAME="AEN6092"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_BlitSurface</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLBLITSURFACE"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1806"
NAME="AEN1883"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN1806"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1809"
NAME="AEN1886"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1810"
NAME="AEN1887"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1816"
NAME="AEN1893"
></A
><H2
>Description</H2
......@@ -170,27 +170,37 @@ CLASS="PARAMETER"
> is not modified).</P
><P
>The blit function should not be called on a locked surface.</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>The results of blitting operations vary greatly depending on whether <TT
CLASS="LITERAL"
>SDL_SRCAPLHA</TT
> is set or not. See <A
HREF="sdlsetalpha.html"
>SDL_SetAlpha</A
>.</P
></BLOCKQUOTE
></DIV
> for an explaination of how this affects your results. Colorkeying and alpha attributes also interact with surface blitting, as the following pseudo-code should hopefully explain.
<PRE
CLASS="PROGRAMLISTING"
>if (source surface has SDL_SRCALPHA set) {
if (source surface has alpha channel (that is, format-&#62;Amask != 0))
blit using per-pixel alpha, ignoring any colour key
else {
if (source surface has SDL_SRCCOLORKEY set)
blit using the colour key AND the per-surface alpha value
else
blit using the per-surface alpha value
}
} else {
if (source surface has SDL_SRCCOLORKEY set)
blit using the colour key
else
ordinary opaque rectangular blit
}</PRE
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1835"
NAME="AEN1912"
></A
><H2
>Return Value</H2
......@@ -226,7 +236,7 @@ have access to the video memory again.</P
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1843"
NAME="AEN1920"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_BuildAudioCVT</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLBUILDAUDIOCVT"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6380"
NAME="AEN6455"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6380"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6383"
NAME="AEN6458"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6384"
NAME="AEN6459"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6390"
NAME="AEN6465"
></A
><H2
>Description</H2
......@@ -172,7 +172,7 @@ CLASS="STRUCTNAME"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6406"
NAME="AEN6481"
></A
><H2
>Return Values</H2
......@@ -185,7 +185,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6410"
NAME="AEN6485"
></A
><H2
>Examples</H2
......@@ -201,7 +201,7 @@ CLASS="FUNCTION"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6415"
NAME="AEN6490"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CD</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCD"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6941"
NAME="AEN7017"
></A
><H2
>Name</H2
......@@ -81,7 +81,7 @@ NAME="AEN6941"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6944"
NAME="AEN7020"
></A
><H2
>Structure Definition</H2
......@@ -99,14 +99,14 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6947"
NAME="AEN7023"
></A
><H2
>Structure Data</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6949"
NAME="AEN7025"
></A
><P
></P
......@@ -222,7 +222,7 @@ CLASS="STRUCTNAME"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6979"
NAME="AEN7055"
></A
><H2
>Description</H2
......@@ -252,7 +252,7 @@ CLASS="LITERAL"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6989"
NAME="AEN7065"
></A
><H2
>Examples</H2
......@@ -269,7 +269,7 @@ frame_offset=MSF_TO_FRAMES(min, sec, frame);</PRE
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6992"
NAME="AEN7068"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDClose</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDCLOSE"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6916"
NAME="AEN6992"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6916"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6919"
NAME="AEN6995"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6920"
NAME="AEN6996"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6926"
NAME="AEN7002"
></A
><H2
>Description</H2
......@@ -127,7 +127,7 @@ CLASS="PARAMETER"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6930"
NAME="AEN7006"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDEject</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDEJECT"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6888"
NAME="AEN6964"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6888"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6891"
NAME="AEN6967"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6892"
NAME="AEN6968"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6898"
NAME="AEN6974"
></A
><H2
>Description</H2
......@@ -127,7 +127,7 @@ CLASS="PARAMETER"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6902"
NAME="AEN6978"
></A
><H2
>Return Value</H2
......@@ -143,7 +143,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6907"
NAME="AEN6983"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDName</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDNAME"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6615"
NAME="AEN6691"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6615"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6618"
NAME="AEN6694"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6619"
NAME="AEN6695"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6625"
NAME="AEN6701"
></A
><H2
>Description</H2
......@@ -130,7 +130,7 @@ CLASS="FUNCTION"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6630"
NAME="AEN6706"
></A
><H2
>Examples</H2
......@@ -156,7 +156,7 @@ NAME="AEN6630"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6640"
NAME="AEN6716"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDNumDrives</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDNUMDRIVES"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6593"
NAME="AEN6669"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6593"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6596"
NAME="AEN6672"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6597"
NAME="AEN6673"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6603"
NAME="AEN6679"
></A
><H2
>Description</H2
......@@ -122,7 +122,7 @@ NAME="AEN6603"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6606"
NAME="AEN6682"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDOpen</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDOPEN"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6649"
NAME="AEN6725"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6649"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6652"
NAME="AEN6728"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6653"
NAME="AEN6729"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6659"
NAME="AEN6735"
></A
><H2
>Description</H2
......@@ -137,7 +137,7 @@ Drive 0 is the system default CD-ROM.</P
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6667"
NAME="AEN6743"
></A
><H2
>Examples</H2
......@@ -178,7 +178,7 @@ SDL_CDClose(cdrom);</PRE
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6670"
NAME="AEN6746"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDPause</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDPAUSE"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6800"
NAME="AEN6876"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6800"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6803"
NAME="AEN6879"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6804"
NAME="AEN6880"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6810"
NAME="AEN6886"
></A
><H2
>Description</H2
......@@ -127,7 +127,7 @@ CLASS="PARAMETER"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6814"
NAME="AEN6890"
></A
><H2
>Return Value</H2
......@@ -143,7 +143,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6819"
NAME="AEN6895"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDPlay</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDPLAY"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6718"
NAME="AEN6794"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6718"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6721"
NAME="AEN6797"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6722"
NAME="AEN6798"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6728"
NAME="AEN6804"
></A
><H2
>Description</H2
......@@ -137,7 +137,7 @@ CLASS="PARAMETER"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6734"
NAME="AEN6810"
></A
><H2
>Return Values</H2
......@@ -153,7 +153,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6739"
NAME="AEN6815"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDPlayTracks</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDPLAYTRACKS"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6750"
NAME="AEN6826"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6750"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6753"
NAME="AEN6829"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6754"
NAME="AEN6830"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6760"
NAME="AEN6836"
></A
><H2
>Description</H2
......@@ -186,7 +186,7 @@ CLASS="NOTE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6778"
NAME="AEN6854"
></A
><H2
>Return Value</H2
......@@ -203,7 +203,7 @@ if there was an error.</P
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6783"
NAME="AEN6859"
></A
><H2
>Examples</H2
......@@ -228,7 +228,7 @@ if(CD_INDRIVE(SDL_CDStatus(cdrom)))
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6787"
NAME="AEN6863"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDResume</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDRESUME"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6830"
NAME="AEN6906"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6830"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6833"
NAME="AEN6909"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6834"
NAME="AEN6910"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6840"
NAME="AEN6916"
></A
><H2
>Description</H2
......@@ -127,7 +127,7 @@ CLASS="PARAMETER"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6844"
NAME="AEN6920"
></A
><H2
>Return Value</H2
......@@ -143,7 +143,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6849"
NAME="AEN6925"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDStatus</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDSTATUS"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6683"
NAME="AEN6759"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6683"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6686"
NAME="AEN6762"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6687"
NAME="AEN6763"
></A
><P
></P
......@@ -116,7 +116,7 @@ CLASS="FUNCSYNOPSISINFO"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6694"
NAME="AEN6770"
></A
><H2
>Description</H2
......@@ -164,7 +164,7 @@ CLASS="STRUCTNAME"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6706"
NAME="AEN6782"
></A
><H2
>Example</H2
......@@ -190,7 +190,7 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6709"
NAME="AEN6785"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDStop</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDSTOP"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6860"
NAME="AEN6936"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6860"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6863"
NAME="AEN6939"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6864"
NAME="AEN6940"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6870"
NAME="AEN6946"
></A
><H2
>Description</H2
......@@ -127,7 +127,7 @@ CLASS="PARAMETER"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6874"
NAME="AEN6950"
></A
><H2
>Return Value</H2
......@@ -143,7 +143,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6879"
NAME="AEN6955"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CDtrack</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCDTRACK"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7003"
NAME="AEN7079"
></A
><H2
>Name</H2
......@@ -81,7 +81,7 @@ NAME="AEN7003"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7006"
NAME="AEN7082"
></A
><H2
>Structure Definition</H2
......@@ -97,14 +97,14 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7009"
NAME="AEN7085"
></A
><H2
>Structure Data</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7011"
NAME="AEN7087"
></A
><P
></P
......@@ -187,7 +187,7 @@ VALIGN="TOP"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7032"
NAME="AEN7108"
></A
><H2
>Description</H2
......@@ -230,7 +230,7 @@ CLASS="LITERAL"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7044"
NAME="AEN7120"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CloseAudio</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCLOSEAUDIO"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6555"
NAME="AEN6631"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6555"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6558"
NAME="AEN6634"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6559"
NAME="AEN6635"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6565"
NAME="AEN6641"
></A
><H2
>Description</H2
......@@ -122,7 +122,7 @@ NAME="AEN6565"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6568"
NAME="AEN6644"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_Color</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCOLOR"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2581"
NAME="AEN2660"
></A
><H2
>Name</H2
......@@ -81,7 +81,7 @@ NAME="AEN2581"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2584"
NAME="AEN2663"
></A
><H2
>Structure Definition</H2
......@@ -97,14 +97,14 @@ CLASS="PROGRAMLISTING"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2587"
NAME="AEN2666"
></A
><H2
>Structure Data</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2589"
NAME="AEN2668"
></A
><P
></P
......@@ -181,7 +181,7 @@ VALIGN="TOP"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2608"
NAME="AEN2687"
></A
><H2
>Description</H2
......@@ -203,7 +203,7 @@ CLASS="FUNCTION"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2615"
NAME="AEN2694"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CondBroadcast</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCONDBROADCAST"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7712"
NAME="AEN7788"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7712"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7715"
NAME="AEN7791"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7716"
NAME="AEN7792"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7722"
NAME="AEN7798"
></A
><H2
>Description</H2
......@@ -134,7 +134,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7728"
NAME="AEN7804"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CondSignal</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCONDSIGNAL"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7685"
NAME="AEN7761"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7685"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7688"
NAME="AEN7764"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7689"
NAME="AEN7765"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7695"
NAME="AEN7771"
></A
><H2
>Description</H2
......@@ -134,7 +134,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7701"
NAME="AEN7777"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CondWait</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCONDWAIT"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7739"
NAME="AEN7815"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7739"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7742"
NAME="AEN7818"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7743"
NAME="AEN7819"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7749"
NAME="AEN7825"
></A
><H2
>Description</H2
......@@ -134,7 +134,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7755"
NAME="AEN7831"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CondWaitTimeout</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCONDWAITTIMEOUT"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7768"
NAME="AEN7844"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7768"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7771"
NAME="AEN7847"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7772"
NAME="AEN7848"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7778"
NAME="AEN7854"
></A
><H2
>Description</H2
......@@ -147,7 +147,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7787"
NAME="AEN7863"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_ConvertAudio</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCONVERTAUDIO"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6426"
NAME="AEN6501"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN6426"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6429"
NAME="AEN6504"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN6430"
NAME="AEN6505"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6436"
NAME="AEN6511"
></A
><H2
>Description</H2
......@@ -240,7 +240,7 @@ CLASS="STRUCTNAME"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6471"
NAME="AEN6546"
></A
><H2
>Examples</H2
......@@ -317,7 +317,7 @@ SDL_ConvertAudio(&#38;wav_cvt);
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6474"
NAME="AEN6549"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_ConvertSurface</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCONVERTSURFACE"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1766"
NAME="AEN1843"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN1766"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1769"
NAME="AEN1846"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1770"
NAME="AEN1847"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1776"
NAME="AEN1853"
></A
><H2
>Description</H2
......@@ -151,7 +151,7 @@ CLASS="FUNCTION"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1787"
NAME="AEN1864"
></A
><H2
>Return Value</H2
......@@ -165,7 +165,7 @@ CLASS="LITERAL"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1791"
NAME="AEN1868"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateCond</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATECOND"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7634"
NAME="AEN7710"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7634"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7637"
NAME="AEN7713"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7638"
NAME="AEN7714"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7644"
NAME="AEN7720"
></A
><H2
>Description</H2
......@@ -123,7 +123,7 @@ NAME="AEN7644"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7647"
NAME="AEN7723"
></A
><H2
>Examples</H2
......@@ -143,7 +143,7 @@ SDL_DestroyCond(cond);</PRE
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7650"
NAME="AEN7726"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateCursor</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATECURSOR"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1989"
NAME="AEN2068"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN1989"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1992"
NAME="AEN2071"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1993"
NAME="AEN2072"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1999"
NAME="AEN2078"
></A
><H2
>Description</H2
......@@ -134,7 +134,7 @@ The cursor width must be a multiple of 8 bits.</P
<DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2005"
NAME="AEN2084"
></A
><P
></P
......@@ -210,7 +210,7 @@ HREF="sdlfreecursor.html"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2026"
NAME="AEN2105"
></A
><H2
>Example</H2
......@@ -301,7 +301,7 @@ static SDL_Cursor *init_system_cursor(const char *image[])
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2029"
NAME="AEN2108"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateMutex</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATEMUTEX"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7195"
NAME="AEN7271"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7195"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7198"
NAME="AEN7274"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7199"
NAME="AEN7275"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7205"
NAME="AEN7281"
></A
><H2
>Description</H2
......@@ -123,7 +123,7 @@ NAME="AEN7205"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7208"
NAME="AEN7284"
></A
><H2
>Examples</H2
......@@ -152,7 +152,7 @@ SDL_DestroyMutex(mut);&#13;</PRE
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7211"
NAME="AEN7287"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateRGBSurface</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATERGBSURFACE"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1316"
NAME="AEN1358"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN1316"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1319"
NAME="AEN1361"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1320"
NAME="AEN1362"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1326"
NAME="AEN1368"
></A
><H2
>Description</H2
......@@ -153,7 +153,7 @@ CLASS="PARAMETER"
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1338"
NAME="AEN1380"
></A
><P
></P
......@@ -198,7 +198,21 @@ CLASS="LITERAL"
><TD
ALIGN="LEFT"
VALIGN="TOP"
>With this flag SDL will attempt to find the best location for this surface, either in system memory or video memory, to obtain hardware colorkey blitting support.</TD
>This flag turns on colourkeying for blits from this surface. If
<TT
CLASS="LITERAL"
>SDL_HWSURFACE</TT
> is also specified and colourkeyed blits
are hardware-accelerated, then SDL will attempt to place the surface in
video memory.
Use <A
HREF="sdlsetcolorkey.html"
><TT
CLASS="FUNCTION"
>SDL_SetColorKey</TT
></A
>
to set or clear this flag after surface creation.</TD
></TR
><TR
><TD
......@@ -211,18 +225,108 @@ CLASS="LITERAL"
><TD
ALIGN="LEFT"
VALIGN="TOP"
>With this flag SDL will attempt to find the best location for this surface, either in system memory or video memory, to obtain hardware alpha support</TD
>This flag turns on alpha-blending for blits from this surface. If
<TT
CLASS="LITERAL"
>SDL_HWSURFACE</TT
> is also specified and alpha-blending blits
are hardware-accelerated, then the surface will be placed in video memory if
possible.
Use <A
HREF="sdlsetalpha.html"
><TT
CLASS="FUNCTION"
>SDL_SetAlpha</TT
></A
> to
set or clear this flag after surface creation.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>If an alpha-channel is specified (that is, if <TT
CLASS="PARAMETER"
><I
>Amask</I
></TT
> is
nonzero), then the <TT
CLASS="LITERAL"
>SDL_SRCALPHA</TT
> flag is automatically
set. You may remove this flag by calling
<A
HREF="sdlsetalpha.html"
><TT
CLASS="FUNCTION"
>SDL_SetAlpha</TT
></A
>
after surface creation.</P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1357"
NAME="AEN1411"
></A
><H2
>Return Value</H2
><P
>Returns the created surface, or <SPAN
CLASS="RETURNVALUE"
>NULL</SPAN
> upon error.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1415"
></A
><H2
>Example</H2
><PRE
CLASS="PROGRAMLISTING"
> /* Create a 32-bit surface with the bytes of each pixel in R,G,B,A order,
as expected by OpenGL for textures */
SDL_Surface *surface;
Uint32 rmask, gmask, bmask, amask;
/* SDL interprets each pixel as a 32-bit number, so our masks must depend
on the endianness (byte order) of the machine */
#if SDL_BYTEORDER == SDL_BIG_ENDIAN
rmask = 0xff000000;
gmask = 0x00ff0000;
bmask = 0x0000ff00;
amask = 0x000000ff;
#else
rmask = 0x000000ff;
gmask = 0x0000ff00;
bmask = 0x00ff0000;
amask = 0xff000000;
#endif
surface = SDL_CreateRGBSurface(SDL_SWSURFACE, width, height, 32,
rmask, gmask, bmask, amask);
if(surface == NULL) {
fprintf(stderr, "CreateRGBSurface failed: %s\n", SDL_GetError());
exit(1);
}</PRE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1418"
></A
><H2
>See Also</H2
......@@ -268,6 +372,20 @@ HREF="sdlsurface.html"
CLASS="STRUCTNAME"
>SDL_Surface</SPAN
></A
>
<A
HREF="sdlsetalpha.html"
><TT
CLASS="FUNCTION"
>SDL_SetAlpha</TT
></A
>
<A
HREF="sdlsetcolorkey.html"
><TT
CLASS="FUNCTION"
>SDL_SetColorKey</TT
></A
></P
></DIV
><DIV
......
......@@ -4,7 +4,7 @@
>SDL_CreateRGBSurfaceFrom</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATERGBSURFACEFROM"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1376"
NAME="AEN1441"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN1376"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1379"
NAME="AEN1444"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN1380"
NAME="AEN1445"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1386"
NAME="AEN1451"
></A
><H2
>Description</H2
......@@ -132,7 +132,7 @@ CLASS="PARAMETER"
> specified in the parameter list. The pixel data is not copied into the <SPAN
CLASS="STRUCTNAME"
>SDL_Surface</SPAN
> structure so it should no be freed until the surface has been freed with a called to <A
> structure so it should not be freed until the surface has been freed with a called to <A
HREF="sdlfreesurface.html"
>SDL_FreeSurface</A
>. <TT
......@@ -153,7 +153,20 @@ CLASS="FUNCTION"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1398"
NAME="AEN1463"
></A
><H2
>Return Value</H2
><P
>Returns the created surface, or <SPAN
CLASS="RETURNVALUE"
>NULL</SPAN
> upon error.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1467"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateSemaphore</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATESEMAPHORE"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7311"
NAME="AEN7387"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7311"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7314"
NAME="AEN7390"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7315"
NAME="AEN7391"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7321"
NAME="AEN7397"
></A
><H2
>Description</H2
......@@ -152,7 +152,7 @@ will atomically increment the semaphore value.</P
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7330"
NAME="AEN7406"
></A
><H2
>Return Value</H2
......@@ -166,7 +166,7 @@ CLASS="RETURNVALUE"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7334"
NAME="AEN7410"
></A
><H2
>Examples</H2
......@@ -185,7 +185,7 @@ if (my_sem == NULL) {
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7338"
NAME="AEN7414"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateThread</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATETHREAD"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7076"
NAME="AEN7152"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7076"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7079"
NAME="AEN7155"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7080"
NAME="AEN7156"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7086"
NAME="AEN7162"
></A
><H2
>Description</H2
......@@ -140,7 +140,7 @@ The thread quits when this function returns.</P
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7092"
NAME="AEN7168"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_CreateYUVOverlay</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLCREATEYUVOVERLAY"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2310"
NAME="AEN2389"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN2310"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2313"
NAME="AEN2392"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN2314"
NAME="AEN2393"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2320"
NAME="AEN2399"
></A
><H2
>Description</H2
......@@ -159,7 +159,7 @@ CLASS="STRUCTNAME"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2333"
NAME="AEN2412"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_Delay</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLDELAY"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7830"
NAME="AEN7906"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7830"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7833"
NAME="AEN7909"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7834"
NAME="AEN7910"
></A
><P
></P
......@@ -112,7 +112,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7840"
NAME="AEN7916"
></A
><H2
>Description</H2
......@@ -124,11 +124,25 @@ CLASS="FUNCTION"
CLASS="EMPHASIS"
>least</I
> the specified time, but possible longer due to OS scheduling.</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>Count on a delay granularity of <I
CLASS="EMPHASIS"
>at least</I
> 10 ms.
Some platforms have shorter clock ticks but this is the most common.</P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7845"
NAME="AEN7924"
></A
><H2
>See Also</H2
......
......@@ -4,7 +4,7 @@
>SDL_DestroyCond</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
......@@ -73,7 +73,7 @@ NAME="SDLDESTROYCOND"
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7663"
NAME="AEN7739"
></A
><H2
>Name</H2
......@@ -81,14 +81,14 @@ NAME="AEN7663"
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7666"
NAME="AEN7742"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN7667"
NAME="AEN7743"
></A
><P
></P
......@@ -113,7 +113,7 @@ CLASS="FSFUNC"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7673"
NAME="AEN7749"
></A
><H2
>Description</H2
......@@ -123,7 +123,7 @@ NAME="AEN7673"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7676"
NAME="AEN7752"
></A
><H2
>See Also</H2
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment