Added new docs for SDL 1.2.1
authorSam Lantinga <slouken@lokigames.com>
Sun, 10 Jun 2001 19:31:57 +0000
changeset 5555f1f1b3e27d
parent 54 028447a8a758
child 56 ce9cd2cf0d0d
Added new docs for SDL 1.2.1
docs/html/Makefile.am
docs/html/audio.html
docs/html/cdrom.html
docs/html/event.html
docs/html/eventfunctions.html
docs/html/eventstructures.html
docs/html/general.html
docs/html/guide.html
docs/html/guideaboutsdldoc.html
docs/html/guideaudioexamples.html
docs/html/guidebasicsinit.html
docs/html/guidecdromexamples.html
docs/html/guidecredits.html
docs/html/guideeventexamples.html
docs/html/guideexamples.html
docs/html/guideinput.html
docs/html/guideinputkeyboard.html
docs/html/guidepreface.html
docs/html/guidethebasics.html
docs/html/guidetimeexamples.html
docs/html/guidevideo.html
docs/html/guidevideoexamples.html
docs/html/guidevideoopengl.html
docs/html/index.html
docs/html/joystick.html
docs/html/reference.html
docs/html/sdlactiveevent.html
docs/html/sdladdtimer.html
docs/html/sdlaudiocvt.html
docs/html/sdlaudiospec.html
docs/html/sdlblitsurface.html
docs/html/sdlbuildaudiocvt.html
docs/html/sdlcd.html
docs/html/sdlcdclose.html
docs/html/sdlcdeject.html
docs/html/sdlcdname.html
docs/html/sdlcdnumdrives.html
docs/html/sdlcdopen.html
docs/html/sdlcdpause.html
docs/html/sdlcdplay.html
docs/html/sdlcdplaytracks.html
docs/html/sdlcdresume.html
docs/html/sdlcdstatus.html
docs/html/sdlcdstop.html
docs/html/sdlcdtrack.html
docs/html/sdlcloseaudio.html
docs/html/sdlcolor.html
docs/html/sdlcondbroadcast.html
docs/html/sdlcondsignal.html
docs/html/sdlcondwait.html
docs/html/sdlcondwaittimeout.html
docs/html/sdlconvertaudio.html
docs/html/sdlconvertsurface.html
docs/html/sdlcreatecond.html
docs/html/sdlcreatecursor.html
docs/html/sdlcreatemutex.html
docs/html/sdlcreatergbsurface.html
docs/html/sdlcreatergbsurfacefrom.html
docs/html/sdlcreatesemaphore.html
docs/html/sdlcreatethread.html
docs/html/sdlcreateyuvoverlay.html
docs/html/sdldelay.html
docs/html/sdldestroycond.html
docs/html/sdldestroymutex.html
docs/html/sdldestroysemaphore.html
docs/html/sdldisplayformat.html
docs/html/sdldisplayformatalpha.html
docs/html/sdldisplayyuvoverlay.html
docs/html/sdlenablekeyrepeat.html
docs/html/sdlenableunicode.html
docs/html/sdlevent.html
docs/html/sdleventstate.html
docs/html/sdlfillrect.html
docs/html/sdlflip.html
docs/html/sdlfreecursor.html
docs/html/sdlfreesurface.html
docs/html/sdlfreewav.html
docs/html/sdlfreeyuvoverlay.html
docs/html/sdlgetappstate.html
docs/html/sdlgetaudiostatus.html
docs/html/sdlgetcliprect.html
docs/html/sdlgetcursor.html
docs/html/sdlgeteventfilter.html
docs/html/sdlgetgammaramp.html
docs/html/sdlgetkeyname.html
docs/html/sdlgetkeystate.html
docs/html/sdlgetmodstate.html
docs/html/sdlgetmousestate.html
docs/html/sdlgetrelativemousestate.html
docs/html/sdlgetrgb.html
docs/html/sdlgetrgba.html
docs/html/sdlgetthreadid.html
docs/html/sdlgetticks.html
docs/html/sdlgetvideoinfo.html
docs/html/sdlgetvideosurface.html
docs/html/sdlglattr.html
docs/html/sdlglgetattribute.html
docs/html/sdlglgetprocaddress.html
docs/html/sdlglloadlibrary.html
docs/html/sdlglsetattribute.html
docs/html/sdlglswapbuffers.html
docs/html/sdlinit.html
docs/html/sdlinitsubsystem.html
docs/html/sdljoyaxisevent.html
docs/html/sdljoyballevent.html
docs/html/sdljoybuttonevent.html
docs/html/sdljoyhatevent.html
docs/html/sdljoystickclose.html
docs/html/sdljoystickeventstate.html
docs/html/sdljoystickgetaxis.html
docs/html/sdljoystickgetball.html
docs/html/sdljoystickgetbutton.html
docs/html/sdljoystickgethat.html
docs/html/sdljoystickindex.html
docs/html/sdljoystickname.html
docs/html/sdljoysticknumaxes.html
docs/html/sdljoysticknumballs.html
docs/html/sdljoysticknumbuttons.html
docs/html/sdljoysticknumhats.html
docs/html/sdljoystickopen.html
docs/html/sdljoystickopened.html
docs/html/sdljoystickupdate.html
docs/html/sdlkey.html
docs/html/sdlkeyboardevent.html
docs/html/sdlkeysym.html
docs/html/sdlkillthread.html
docs/html/sdllistmodes.html
docs/html/sdlloadbmp.html
docs/html/sdlloadwav.html
docs/html/sdllockaudio.html
docs/html/sdllocksurface.html
docs/html/sdllockyuvoverlay.html
docs/html/sdlmaprgb.html
docs/html/sdlmaprgba.html
docs/html/sdlmixaudio.html
docs/html/sdlmousebuttonevent.html
docs/html/sdlmousemotionevent.html
docs/html/sdlmutexp.html
docs/html/sdlmutexv.html
docs/html/sdlnumjoysticks.html
docs/html/sdlopenaudio.html
docs/html/sdloverlay.html
docs/html/sdlpalette.html
docs/html/sdlpauseaudio.html
docs/html/sdlpeepevents.html
docs/html/sdlpixelformat.html
docs/html/sdlpollevent.html
docs/html/sdlpumpevents.html
docs/html/sdlpushevent.html
docs/html/sdlquit.html
docs/html/sdlquitevent.html
docs/html/sdlquitsubsystem.html
docs/html/sdlrect.html
docs/html/sdlremovetimer.html
docs/html/sdlresizeevent.html
docs/html/sdlsavebmp.html
docs/html/sdlsempost.html
docs/html/sdlsemtrywait.html
docs/html/sdlsemvalue.html
docs/html/sdlsemwait.html
docs/html/sdlsemwaittimeout.html
docs/html/sdlsetalpha.html
docs/html/sdlsetcliprect.html
docs/html/sdlsetcolorkey.html
docs/html/sdlsetcolors.html
docs/html/sdlsetcursor.html
docs/html/sdlseteventfilter.html
docs/html/sdlsetgamma.html
docs/html/sdlsetgammaramp.html
docs/html/sdlsetmodstate.html
docs/html/sdlsetpalette.html
docs/html/sdlsettimer.html
docs/html/sdlsetvideomode.html
docs/html/sdlshowcursor.html
docs/html/sdlsurface.html
docs/html/sdlsyswmevent.html
docs/html/sdlthreadid.html
docs/html/sdlunlockaudio.html
docs/html/sdlunlocksurface.html
docs/html/sdlunlockyuvoverlay.html
docs/html/sdlupdaterect.html
docs/html/sdlupdaterects.html
docs/html/sdluserevent.html
docs/html/sdlvideodrivername.html
docs/html/sdlvideoinfo.html
docs/html/sdlvideomodeok.html
docs/html/sdlwaitevent.html
docs/html/sdlwaitthread.html
docs/html/sdlwarpmouse.html
docs/html/sdlwasinit.html
docs/html/sdlwmgetcaption.html
docs/html/sdlwmgrabinput.html
docs/html/sdlwmiconifywindow.html
docs/html/sdlwmsetcaption.html
docs/html/sdlwmseticon.html
docs/html/sdlwmtogglefullscreen.html
docs/html/thread.html
docs/html/time.html
docs/html/video.html
docs/html/wm.html
docs/man3/SDL_ActiveEvent.3
docs/man3/SDL_AddTimer.3
docs/man3/SDL_AudioCVT.3
docs/man3/SDL_AudioSpec.3
docs/man3/SDL_BlitSurface.3
docs/man3/SDL_BuildAudioCVT.3
docs/man3/SDL_CD.3
docs/man3/SDL_CDClose.3
docs/man3/SDL_CDEject.3
docs/man3/SDL_CDName.3
docs/man3/SDL_CDNumDrives.3
docs/man3/SDL_CDOpen.3
docs/man3/SDL_CDPause.3
docs/man3/SDL_CDPlay.3
docs/man3/SDL_CDPlayTracks.3
docs/man3/SDL_CDResume.3
docs/man3/SDL_CDStatus.3
docs/man3/SDL_CDStop.3
docs/man3/SDL_CDtrack.3
docs/man3/SDL_CloseAudio.3
docs/man3/SDL_Color.3
docs/man3/SDL_CondBroadcast.3
docs/man3/SDL_CondSignal.3
docs/man3/SDL_CondWait.3
docs/man3/SDL_CondWaitTimeout.3
docs/man3/SDL_ConvertAudio.3
docs/man3/SDL_ConvertSurface.3
docs/man3/SDL_CreateCond.3
docs/man3/SDL_CreateCursor.3
docs/man3/SDL_CreateMutex.3
docs/man3/SDL_CreateRGBSurface.3
docs/man3/SDL_CreateRGBSurfaceFrom.3
docs/man3/SDL_CreateSemaphore.3
docs/man3/SDL_CreateThread.3
docs/man3/SDL_CreateYUVOverlay.3
docs/man3/SDL_Delay.3
docs/man3/SDL_DestroyCond.3
docs/man3/SDL_DestroyMutex.3
docs/man3/SDL_DestroySemaphore.3
docs/man3/SDL_DisplayFormat.3
docs/man3/SDL_DisplayFormatAlpha.3
docs/man3/SDL_DisplayYUVOverlay.3
docs/man3/SDL_EnableKeyRepeat.3
docs/man3/SDL_EnableUNICODE.3
docs/man3/SDL_Event.3
docs/man3/SDL_EventState.3
docs/man3/SDL_FillRect.3
docs/man3/SDL_Flip.3
docs/man3/SDL_FreeCursor.3
docs/man3/SDL_FreeSurface.3
docs/man3/SDL_FreeWAV.3
docs/man3/SDL_FreeYUVOverlay.3
docs/man3/SDL_GL_GetAttribute.3
docs/man3/SDL_GL_GetProcAddress.3
docs/man3/SDL_GL_LoadLibrary.3
docs/man3/SDL_GL_SetAttribute.3
docs/man3/SDL_GL_SwapBuffers.3
docs/man3/SDL_GLattr.3
docs/man3/SDL_GetAppState.3
docs/man3/SDL_GetAudioStatus.3
docs/man3/SDL_GetClipRect.3
docs/man3/SDL_GetCursor.3
docs/man3/SDL_GetEventFilter.3
docs/man3/SDL_GetGamma.3
docs/man3/SDL_GetGammaRamp.3
docs/man3/SDL_GetKeyName.3
docs/man3/SDL_GetKeyState.3
docs/man3/SDL_GetModState.3
docs/man3/SDL_GetMouseState.3
docs/man3/SDL_GetRGB.3
docs/man3/SDL_GetRGBA.3
docs/man3/SDL_GetRelativeMouseState.3
docs/man3/SDL_GetThreadID.3
docs/man3/SDL_GetTicks.3
docs/man3/SDL_GetVideoInfo.3
docs/man3/SDL_GetVideoSurface.3
docs/man3/SDL_Init.3
docs/man3/SDL_InitSubSystem.3
docs/man3/SDL_JoyAxisEvent.3
docs/man3/SDL_JoyBallEvent.3
docs/man3/SDL_JoyButtonEvent.3
docs/man3/SDL_JoyHatEvent.3
docs/man3/SDL_JoystickClose.3
docs/man3/SDL_JoystickEventState.3
docs/man3/SDL_JoystickGetAxis.3
docs/man3/SDL_JoystickGetBall.3
docs/man3/SDL_JoystickGetButton.3
docs/man3/SDL_JoystickGetHat.3
docs/man3/SDL_JoystickIndex.3
docs/man3/SDL_JoystickName.3
docs/man3/SDL_JoystickNumAxes.3
docs/man3/SDL_JoystickNumBalls.3
docs/man3/SDL_JoystickNumButtons.3
docs/man3/SDL_JoystickNumHats.3
docs/man3/SDL_JoystickOpen.3
docs/man3/SDL_JoystickOpened.3
docs/man3/SDL_JoystickUpdate.3
docs/man3/SDL_KeyboardEvent.3
docs/man3/SDL_KillThread.3
docs/man3/SDL_ListModes.3
docs/man3/SDL_LoadBMP.3
docs/man3/SDL_LoadWAV.3
docs/man3/SDL_LockAudio.3
docs/man3/SDL_LockSurface.3
docs/man3/SDL_LockYUVOverlay.3
docs/man3/SDL_MapRGB.3
docs/man3/SDL_MapRGBA.3
docs/man3/SDL_MixAudio.3
docs/man3/SDL_MouseButtonEvent.3
docs/man3/SDL_MouseMotionEvent.3
docs/man3/SDL_NumJoysticks.3
docs/man3/SDL_OpenAudio.3
docs/man3/SDL_Overlay.3
docs/man3/SDL_Palette.3
docs/man3/SDL_PauseAudio.3
docs/man3/SDL_PeepEvents.3
docs/man3/SDL_PixelFormat.3
docs/man3/SDL_PollEvent.3
docs/man3/SDL_PumpEvents.3
docs/man3/SDL_PushEvent.3
docs/man3/SDL_Quit.3
docs/man3/SDL_QuitEvent.3
docs/man3/SDL_QuitSubSystem.3
docs/man3/SDL_RWFromFile.3
docs/man3/SDL_Rect.3
docs/man3/SDL_RemoveTimer.3
docs/man3/SDL_ResizeEvent.3
docs/man3/SDL_SaveBMP.3
docs/man3/SDL_SemPost.3
docs/man3/SDL_SemTryWait.3
docs/man3/SDL_SemValue.3
docs/man3/SDL_SemWait.3
docs/man3/SDL_SemWaitTimeout.3
docs/man3/SDL_SetAlpha.3
docs/man3/SDL_SetClipRect.3
docs/man3/SDL_SetColorKey.3
docs/man3/SDL_SetColors.3
docs/man3/SDL_SetCursor.3
docs/man3/SDL_SetEventFilter.3
docs/man3/SDL_SetGamma.3
docs/man3/SDL_SetGammaRamp.3
docs/man3/SDL_SetModState.3
docs/man3/SDL_SetPalette.3
docs/man3/SDL_SetTimer.3
docs/man3/SDL_SetVideoMode.3
docs/man3/SDL_ShowCursor.3
docs/man3/SDL_Surface.3
docs/man3/SDL_SysWMEvent.3
docs/man3/SDL_ThreadID.3
docs/man3/SDL_UnlockAudio.3
docs/man3/SDL_UnlockSurface.3
docs/man3/SDL_UnlockYUVOverlay.3
docs/man3/SDL_UpdateRect.3
docs/man3/SDL_UpdateRects.3
docs/man3/SDL_UserEvent.3
docs/man3/SDL_VideoDriverName.3
docs/man3/SDL_VideoInfo.3
docs/man3/SDL_VideoModeOK.3
docs/man3/SDL_WM_GetCaption.3
docs/man3/SDL_WM_GrabInput.3
docs/man3/SDL_WM_IconifyWindow.3
docs/man3/SDL_WM_SetCaption.3
docs/man3/SDL_WM_SetIcon.3
docs/man3/SDL_WM_ToggleFullScreen.3
docs/man3/SDL_WaitEvent.3
docs/man3/SDL_WaitThread.3
docs/man3/SDL_WarpMouse.3
docs/man3/SDL_WasInit.3
docs/man3/SDL_keysym.3
docs/man3/SDL_mutexP.3
docs/man3/SDL_mutexV.3
     1.1 --- a/docs/html/Makefile.am	Sun Jun 10 18:39:47 2001 +0000
     1.2 +++ b/docs/html/Makefile.am	Sun Jun 10 19:31:57 2001 +0000
     1.3 @@ -20,6 +20,7 @@
     1.4      guidetimeexamples.html \
     1.5      guidevideo.html \
     1.6      guidevideoexamples.html \
     1.7 +    guidevideoopengl.html \
     1.8      index.html \
     1.9      joystick.html \
    1.10      reference.html \
     2.1 --- a/docs/html/audio.html	Sun Jun 10 18:39:47 2001 +0000
     2.2 +++ b/docs/html/audio.html	Sun Jun 10 19:31:57 2001 +0000
     2.3 @@ -4,7 +4,7 @@
     2.4  >Audio</TITLE
     2.5  ><META
     2.6  NAME="GENERATOR"
     2.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     2.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     2.9  "><LINK
    2.10  REL="HOME"
    2.11  TITLE="SDL Library Documentation"
     3.1 --- a/docs/html/cdrom.html	Sun Jun 10 18:39:47 2001 +0000
     3.2 +++ b/docs/html/cdrom.html	Sun Jun 10 19:31:57 2001 +0000
     3.3 @@ -4,7 +4,7 @@
     3.4  >CD-ROM</TITLE
     3.5  ><META
     3.6  NAME="GENERATOR"
     3.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     3.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     3.9  "><LINK
    3.10  REL="HOME"
    3.11  TITLE="SDL Library Documentation"
     4.1 --- a/docs/html/event.html	Sun Jun 10 18:39:47 2001 +0000
     4.2 +++ b/docs/html/event.html	Sun Jun 10 19:31:57 2001 +0000
     4.3 @@ -4,7 +4,7 @@
     4.4  >Events</TITLE
     4.5  ><META
     4.6  NAME="GENERATOR"
     4.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     4.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     4.9  "><LINK
    4.10  REL="HOME"
    4.11  TITLE="SDL Library Documentation"
    4.12 @@ -85,7 +85,7 @@
    4.13  ></DT
    4.14  ><DT
    4.15  ><A
    4.16 -HREF="event.html#AEN3194"
    4.17 +HREF="event.html#AEN3269"
    4.18  >Introduction</A
    4.19  ></DT
    4.20  ><DT
    4.21 @@ -105,7 +105,7 @@
    4.22  ><H1
    4.23  CLASS="SECT1"
    4.24  ><A
    4.25 -NAME="AEN3194"
    4.26 +NAME="AEN3269"
    4.27  >Introduction</A
    4.28  ></H1
    4.29  ><P
     5.1 --- a/docs/html/eventfunctions.html	Sun Jun 10 18:39:47 2001 +0000
     5.2 +++ b/docs/html/eventfunctions.html	Sun Jun 10 19:31:57 2001 +0000
     5.3 @@ -4,7 +4,7 @@
     5.4  >Event Functions.</TITLE
     5.5  ><META
     5.6  NAME="GENERATOR"
     5.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     5.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     5.9  "><LINK
    5.10  REL="HOME"
    5.11  TITLE="SDL Library Documentation"
     6.1 --- a/docs/html/eventstructures.html	Sun Jun 10 18:39:47 2001 +0000
     6.2 +++ b/docs/html/eventstructures.html	Sun Jun 10 19:31:57 2001 +0000
     6.3 @@ -4,7 +4,7 @@
     6.4  >SDL Event Structures.</TITLE
     6.5  ><META
     6.6  NAME="GENERATOR"
     6.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     6.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     6.9  "><LINK
    6.10  REL="HOME"
    6.11  TITLE="SDL Library Documentation"
     7.1 --- a/docs/html/general.html	Sun Jun 10 18:39:47 2001 +0000
     7.2 +++ b/docs/html/general.html	Sun Jun 10 19:31:57 2001 +0000
     7.3 @@ -4,7 +4,7 @@
     7.4  >General</TITLE
     7.5  ><META
     7.6  NAME="GENERATOR"
     7.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     7.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     7.9  "><LINK
    7.10  REL="HOME"
    7.11  TITLE="SDL Library Documentation"
     8.1 --- a/docs/html/guide.html	Sun Jun 10 18:39:47 2001 +0000
     8.2 +++ b/docs/html/guide.html	Sun Jun 10 19:31:57 2001 +0000
     8.3 @@ -4,7 +4,7 @@
     8.4  >SDL Guide</TITLE
     8.5  ><META
     8.6  NAME="GENERATOR"
     8.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     8.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     8.9  "><LINK
    8.10  REL="HOME"
    8.11  TITLE="SDL Library Documentation"
     9.1 --- a/docs/html/guideaboutsdldoc.html	Sun Jun 10 18:39:47 2001 +0000
     9.2 +++ b/docs/html/guideaboutsdldoc.html	Sun Jun 10 19:31:57 2001 +0000
     9.3 @@ -4,7 +4,7 @@
     9.4  >About SDLdoc</TITLE
     9.5  ><META
     9.6  NAME="GENERATOR"
     9.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
     9.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
     9.9  "><LINK
    9.10  REL="HOME"
    9.11  TITLE="SDL Library Documentation"
    9.12 @@ -74,9 +74,9 @@
    9.13  >About SDLdoc</A
    9.14  ></H1
    9.15  ><P
    9.16 ->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
    9.17 +>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
    9.18  ><P
    9.19 ->The latest version of this documentation can always be found at the project homepage: http://sdldoc.sourceforge.net.</P
    9.20 +>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
    9.21  ></DIV
    9.22  ><DIV
    9.23  CLASS="NAVFOOTER"
    10.1 --- a/docs/html/guideaudioexamples.html	Sun Jun 10 18:39:47 2001 +0000
    10.2 +++ b/docs/html/guideaudioexamples.html	Sun Jun 10 19:31:57 2001 +0000
    10.3 @@ -4,7 +4,7 @@
    10.4  >Audio Examples</TITLE
    10.5  ><META
    10.6  NAME="GENERATOR"
    10.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    10.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    10.9  "><LINK
   10.10  REL="HOME"
   10.11  TITLE="SDL Library Documentation"
   10.12 @@ -80,7 +80,7 @@
   10.13  ><H2
   10.14  CLASS="SECT2"
   10.15  ><A
   10.16 -NAME="AEN343"
   10.17 +NAME="AEN382"
   10.18  >Opening the audio device</A
   10.19  ></H2
   10.20  ><P
   10.21 @@ -110,7 +110,7 @@
   10.22  ><H2
   10.23  CLASS="SECT2"
   10.24  ><A
   10.25 -NAME="AEN347"
   10.26 +NAME="AEN386"
   10.27  >Playing audio</A
   10.28  ></H2
   10.29  ><P
    11.1 --- a/docs/html/guidebasicsinit.html	Sun Jun 10 18:39:47 2001 +0000
    11.2 +++ b/docs/html/guidebasicsinit.html	Sun Jun 10 19:31:57 2001 +0000
    11.3 @@ -4,7 +4,7 @@
    11.4  >Initializing SDL</TITLE
    11.5  ><META
    11.6  NAME="GENERATOR"
    11.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    11.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    11.9  "><LINK
   11.10  REL="HOME"
   11.11  TITLE="SDL Library Documentation"
   11.12 @@ -133,7 +133,15 @@
   11.13  CLASS="FUNCTION"
   11.14  >SDL_GetError</TT
   11.15  >. Use this often, you can never know too much about an error.</P
   11.16 +><DIV
   11.17 +CLASS="EXAMPLE"
   11.18 +><A
   11.19 +NAME="AEN60"
   11.20 +></A
   11.21  ><P
   11.22 +><B
   11.23 +>Example 1-1. Initializing SDL</B
   11.24 +></P
   11.25  ><PRE
   11.26  CLASS="PROGRAMLISTING"
   11.27  >#include "SDL.h"   /* All SDL App's need this */
   11.28 @@ -160,7 +168,7 @@
   11.29  
   11.30      exit(0);
   11.31  }&#13;</PRE
   11.32 -></P
   11.33 +></DIV
   11.34  ></DIV
   11.35  ><DIV
   11.36  CLASS="NAVFOOTER"
    12.1 --- a/docs/html/guidecdromexamples.html	Sun Jun 10 18:39:47 2001 +0000
    12.2 +++ b/docs/html/guidecdromexamples.html	Sun Jun 10 19:31:57 2001 +0000
    12.3 @@ -4,7 +4,7 @@
    12.4  >CDROM Examples</TITLE
    12.5  ><META
    12.6  NAME="GENERATOR"
    12.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    12.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    12.9  "><LINK
   12.10  REL="HOME"
   12.11  TITLE="SDL Library Documentation"
   12.12 @@ -80,7 +80,7 @@
   12.13  ><H2
   12.14  CLASS="SECT2"
   12.15  ><A
   12.16 -NAME="AEN354"
   12.17 +NAME="AEN393"
   12.18  >Listing CD-ROM drives</A
   12.19  ></H2
   12.20  ><P
   12.21 @@ -107,7 +107,7 @@
   12.22  ><H2
   12.23  CLASS="SECT2"
   12.24  ><A
   12.25 -NAME="AEN358"
   12.26 +NAME="AEN397"
   12.27  >Opening the default drive</A
   12.28  ></H2
   12.29  ><P
   12.30 @@ -156,7 +156,7 @@
   12.31  ><H2
   12.32  CLASS="SECT2"
   12.33  ><A
   12.34 -NAME="AEN362"
   12.35 +NAME="AEN401"
   12.36  >Listing the tracks on a CD</A
   12.37  ></H2
   12.38  ><P
   12.39 @@ -182,7 +182,7 @@
   12.40  ><H2
   12.41  CLASS="SECT2"
   12.42  ><A
   12.43 -NAME="AEN366"
   12.44 +NAME="AEN405"
   12.45  >Play an entire CD</A
   12.46  ></H2
   12.47  ><P
    13.1 --- a/docs/html/guidecredits.html	Sun Jun 10 18:39:47 2001 +0000
    13.2 +++ b/docs/html/guidecredits.html	Sun Jun 10 19:31:57 2001 +0000
    13.3 @@ -4,7 +4,7 @@
    13.4  >Credits</TITLE
    13.5  ><META
    13.6  NAME="GENERATOR"
    13.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    13.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    13.9  "><LINK
   13.10  REL="HOME"
   13.11  TITLE="SDL Library Documentation"
   13.12 @@ -81,10 +81,18 @@
   13.13  ><TBODY
   13.14  ><TR
   13.15  ><TD
   13.16 +>Sam Lantinga, slouken@libsdl.org</TD
   13.17 +></TR
   13.18 +><TR
   13.19 +><TD
   13.20  >Martin Donlon, akawaka@skynet.ie</TD
   13.21  ></TR
   13.22  ><TR
   13.23  ><TD
   13.24 +>Mattias Engdegård</TD
   13.25 +></TR
   13.26 +><TR
   13.27 +><TD
   13.28  >Julian Peterson</TD
   13.29  ></TR
   13.30  ><TR
    14.1 --- a/docs/html/guideeventexamples.html	Sun Jun 10 18:39:47 2001 +0000
    14.2 +++ b/docs/html/guideeventexamples.html	Sun Jun 10 19:31:57 2001 +0000
    14.3 @@ -4,7 +4,7 @@
    14.4  >Event Examples</TITLE
    14.5  ><META
    14.6  NAME="GENERATOR"
    14.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    14.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    14.9  "><LINK
   14.10  REL="HOME"
   14.11  TITLE="SDL Library Documentation"
   14.12 @@ -13,8 +13,8 @@
   14.13  TITLE="Examples"
   14.14  HREF="guideexamples.html"><LINK
   14.15  REL="PREVIOUS"
   14.16 -TITLE="Video Examples"
   14.17 -HREF="guidevideoexamples.html"><LINK
   14.18 +TITLE="Examples"
   14.19 +HREF="guideexamples.html"><LINK
   14.20  REL="NEXT"
   14.21  TITLE="Audio Examples"
   14.22  HREF="guideaudioexamples.html"></HEAD
   14.23 @@ -44,7 +44,7 @@
   14.24  ALIGN="left"
   14.25  VALIGN="bottom"
   14.26  ><A
   14.27 -HREF="guidevideoexamples.html"
   14.28 +HREF="guideexamples.html"
   14.29  >Prev</A
   14.30  ></TD
   14.31  ><TD
   14.32 @@ -80,7 +80,7 @@
   14.33  ><H2
   14.34  CLASS="SECT2"
   14.35  ><A
   14.36 -NAME="AEN336"
   14.37 +NAME="AEN375"
   14.38  >Filtering and Handling Events</A
   14.39  ></H2
   14.40  ><P
   14.41 @@ -192,7 +192,7 @@
   14.42  ALIGN="left"
   14.43  VALIGN="top"
   14.44  ><A
   14.45 -HREF="guidevideoexamples.html"
   14.46 +HREF="guideexamples.html"
   14.47  >Prev</A
   14.48  ></TD
   14.49  ><TD
   14.50 @@ -217,7 +217,7 @@
   14.51  WIDTH="33%"
   14.52  ALIGN="left"
   14.53  VALIGN="top"
   14.54 ->Video Examples</TD
   14.55 +>Examples</TD
   14.56  ><TD
   14.57  WIDTH="34%"
   14.58  ALIGN="center"
    15.1 --- a/docs/html/guideexamples.html	Sun Jun 10 18:39:47 2001 +0000
    15.2 +++ b/docs/html/guideexamples.html	Sun Jun 10 19:31:57 2001 +0000
    15.3 @@ -4,7 +4,7 @@
    15.4  >Examples</TITLE
    15.5  ><META
    15.6  NAME="GENERATOR"
    15.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    15.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    15.9  "><LINK
   15.10  REL="HOME"
   15.11  TITLE="SDL Library Documentation"
   15.12 @@ -16,8 +16,8 @@
   15.13  TITLE="Handling the Keyboard"
   15.14  HREF="guideinputkeyboard.html"><LINK
   15.15  REL="NEXT"
   15.16 -TITLE="Video Examples"
   15.17 -HREF="guidevideoexamples.html"></HEAD
   15.18 +TITLE="Event Examples"
   15.19 +HREF="guideeventexamples.html"></HEAD
   15.20  ><BODY
   15.21  CLASS="CHAPTER"
   15.22  BGCOLOR="#FFF8DC"
   15.23 @@ -57,7 +57,7 @@
   15.24  ALIGN="right"
   15.25  VALIGN="bottom"
   15.26  ><A
   15.27 -HREF="guidevideoexamples.html"
   15.28 +HREF="guideeventexamples.html"
   15.29  >Next</A
   15.30  ></TD
   15.31  ></TR
   15.32 @@ -81,16 +81,11 @@
   15.33  ></DT
   15.34  ><DT
   15.35  ><A
   15.36 -HREF="guideexamples.html#AEN297"
   15.37 +HREF="guideexamples.html#AEN369"
   15.38  >Introduction</A
   15.39  ></DT
   15.40  ><DT
   15.41  ><A
   15.42 -HREF="guidevideoexamples.html"
   15.43 ->Video Examples</A
   15.44 -></DT
   15.45 -><DT
   15.46 -><A
   15.47  HREF="guideeventexamples.html"
   15.48  >Event Examples</A
   15.49  ></DT
   15.50 @@ -116,11 +111,11 @@
   15.51  ><H1
   15.52  CLASS="SECT1"
   15.53  ><A
   15.54 -NAME="AEN297"
   15.55 +NAME="AEN369"
   15.56  >Introduction</A
   15.57  ></H1
   15.58  ><P
   15.59 ->For the moment these examples are taken directly from the old SDL documentation.</P
   15.60 +>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
   15.61  ></DIV
   15.62  ></DIV
   15.63  ><DIV
   15.64 @@ -154,7 +149,7 @@
   15.65  ALIGN="right"
   15.66  VALIGN="top"
   15.67  ><A
   15.68 -HREF="guidevideoexamples.html"
   15.69 +HREF="guideeventexamples.html"
   15.70  >Next</A
   15.71  ></TD
   15.72  ></TR
   15.73 @@ -176,10 +171,10 @@
   15.74  WIDTH="33%"
   15.75  ALIGN="right"
   15.76  VALIGN="top"
   15.77 ->Video Examples</TD
   15.78 +>Event Examples</TD
   15.79  ></TR
   15.80  ></TABLE
   15.81  ></DIV
   15.82  ></BODY
   15.83  ></HTML
   15.84 ->
   15.85 +>
   15.86 \ No newline at end of file
    16.1 --- a/docs/html/guideinput.html	Sun Jun 10 18:39:47 2001 +0000
    16.2 +++ b/docs/html/guideinput.html	Sun Jun 10 19:31:57 2001 +0000
    16.3 @@ -4,7 +4,7 @@
    16.4  >Input handling</TITLE
    16.5  ><META
    16.6  NAME="GENERATOR"
    16.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    16.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    16.9  "><LINK
   16.10  REL="HOME"
   16.11  TITLE="SDL Library Documentation"
   16.12 @@ -13,8 +13,8 @@
   16.13  TITLE="SDL Guide"
   16.14  HREF="guide.html"><LINK
   16.15  REL="PREVIOUS"
   16.16 -TITLE="Graphics and Video"
   16.17 -HREF="guidevideo.html"><LINK
   16.18 +TITLE="Using OpenGL With SDL"
   16.19 +HREF="guidevideoopengl.html"><LINK
   16.20  REL="NEXT"
   16.21  TITLE="Handling the Keyboard"
   16.22  HREF="guideinputkeyboard.html"></HEAD
   16.23 @@ -44,7 +44,7 @@
   16.24  ALIGN="left"
   16.25  VALIGN="bottom"
   16.26  ><A
   16.27 -HREF="guidevideo.html"
   16.28 +HREF="guidevideoopengl.html"
   16.29  >Prev</A
   16.30  ></TD
   16.31  ><TD
   16.32 @@ -104,7 +104,7 @@
   16.33  ><H2
   16.34  CLASS="SECT2"
   16.35  ><A
   16.36 -NAME="AEN94"
   16.37 +NAME="AEN135"
   16.38  >Initialization</A
   16.39  ></H2
   16.40  ><P
   16.41 @@ -117,23 +117,33 @@
   16.42  CLASS="FUNCTION"
   16.43  >SDL_Init</TT
   16.44  ></A
   16.45 ->.  The joystick flag will usually be used in conjunction with other flags (like the video flag) because the joystick is usually used to control something.
   16.46 -<PRE
   16.47 +>.  The joystick flag will usually be used in conjunction with other flags (like the video flag) because the joystick is usually used to control something.</P
   16.48 +><DIV
   16.49 +CLASS="EXAMPLE"
   16.50 +><A
   16.51 +NAME="AEN141"
   16.52 +></A
   16.53 +><P
   16.54 +><B
   16.55 +>Example 3-1. Initializing SDL with Joystick Support</B
   16.56 +></P
   16.57 +><PRE
   16.58  CLASS="PROGRAMLISTING"
   16.59 ->    if ( ! SDL_Init( SDL_INIT_VIDEO | SDL_INIT_JOYSTICK ) )
   16.60 +>    if (SDL_Init( SDL_INIT_VIDEO | SDL_INIT_JOYSTICK ) &#60; 0)
   16.61      {
   16.62          fprintf(stderr, "Couldn't initialize SDL: %s\n", SDL_GetError());
   16.63          exit(1);
   16.64      }</PRE
   16.65 ->
   16.66 -This will attempt to start SDL with both the video and the joystick subsystems activated.</P
   16.67 +></DIV
   16.68 +><P
   16.69 +>This will attempt to start SDL with both the video and the joystick subsystems activated.</P
   16.70  ></DIV
   16.71  ><DIV
   16.72  CLASS="SECT2"
   16.73  ><H2
   16.74  CLASS="SECT2"
   16.75  ><A
   16.76 -NAME="AEN101"
   16.77 +NAME="AEN145"
   16.78  >Querying</A
   16.79  ></H2
   16.80  ><P
   16.81 @@ -154,8 +164,17 @@
   16.82  >.  The joystick is specified by an index where 0 is the first joystick and the last joystick is the number returned by <TT
   16.83  CLASS="FUNCTION"
   16.84  >SDL_NumJoysticks</TT
   16.85 -> - 1.  In the demonstration a list of all available joysticks is printed to stdout.  
   16.86 -<PRE
   16.87 +> - 1.  In the demonstration a list of all available joysticks is printed to stdout.</P
   16.88 +><DIV
   16.89 +CLASS="EXAMPLE"
   16.90 +><A
   16.91 +NAME="AEN154"
   16.92 +></A
   16.93 +><P
   16.94 +><B
   16.95 +>Example 3-2. Querying the Number of Available Joysticks</B
   16.96 +></P
   16.97 +><PRE
   16.98  CLASS="PROGRAMLISTING"
   16.99  >    printf("%i joysticks were found.\n\n", SDL_NumJoysticks() );
  16.100      printf("The names of the joysticks are:\n");
  16.101 @@ -164,14 +183,14 @@
  16.102      {
  16.103          printf("    %s\n", SDL_JoystickName(i));
  16.104      }</PRE
  16.105 -></P
  16.106 +></DIV
  16.107  ></DIV
  16.108  ><DIV
  16.109  CLASS="SECT2"
  16.110  ><H2
  16.111  CLASS="SECT2"
  16.112  ><A
  16.113 -NAME="AEN111"
  16.114 +NAME="AEN157"
  16.115  >Opening a Joystick and Receiving Joystick Events</A
  16.116  ></H2
  16.117  ><P
  16.118 @@ -250,15 +269,25 @@
  16.119  CLASS="FUNCTION"
  16.120  >SDL_JoystickOpen</TT
  16.121  ></A
  16.122 -> function. For the example we are only interested in events from the first joystick on the system, regardless of what it may be. To receive events from it we would do this:
  16.123 -<PRE
  16.124 +> function. For the example we are only interested in events from the first joystick on the system, regardless of what it may be. To receive events from it we would do this:</P
  16.125 +><DIV
  16.126 +CLASS="EXAMPLE"
  16.127 +><A
  16.128 +NAME="AEN183"
  16.129 +></A
  16.130 +><P
  16.131 +><B
  16.132 +>Example 3-3. Opening a Joystick</B
  16.133 +></P
  16.134 +><PRE
  16.135  CLASS="PROGRAMLISTING"
  16.136  >    SDL_Joystick *joystick;
  16.137  
  16.138      SDL_JoystickEventState(SDL_ENABLE);
  16.139      joystick = SDL_JoystickOpen(0);</PRE
  16.140 ->
  16.141 -If we wanted to receive events for other joysticks we would open them with calls to <TT
  16.142 +></DIV
  16.143 +><P
  16.144 +>If we wanted to receive events for other joysticks we would open them with calls to <TT
  16.145  CLASS="FUNCTION"
  16.146  >SDL_JoystickOpen</TT
  16.147  > just like we opened joystick 0, except we would store the <SPAN
  16.148 @@ -269,7 +298,7 @@
  16.149  >Up to this point all the code we have is used just to initialize the joysticks in order to read values at run time. All we need now is an event loop, which is something that all SDL programs should have anyway to receive the systems quit events. We must now add code to check the event loop for at least some of the above mentioned events. Let's assume our event loop looks like this:
  16.150  <PRE
  16.151  CLASS="PROGRAMLISTING"
  16.152 ->    SDL_Event *event;
  16.153 +>    SDL_Event event;
  16.154      /* Other initializtion code goes here */   
  16.155  
  16.156      /* Start main game loop here */
  16.157 @@ -291,8 +320,17 @@
  16.158  
  16.159      /* End loop here */</PRE
  16.160  >
  16.161 -To handle Joystick events we merely add cases for them, first we'll add axis handling code. Axis checks can get kinda of tricky because alot of the joystick events received are junk. Joystick axis have a tendency to vary just a little between polling due to the way they are designed. To compensate for this you have to set a threshold for changes and ignore the events that have'nt exceeded the threshold. 10% is usually a good threshold value.  This sounds a lot more complicated than it is. Here is the Axis event handler:
  16.162 -<PRE
  16.163 +To handle Joystick events we merely add cases for them, first we'll add axis handling code. Axis checks can get kinda of tricky because alot of the joystick events received are junk. Joystick axis have a tendency to vary just a little between polling due to the way they are designed. To compensate for this you have to set a threshold for changes and ignore the events that have'nt exceeded the threshold. 10% is usually a good threshold value.  This sounds a lot more complicated than it is. Here is the Axis event handler:</P
  16.164 +><DIV
  16.165 +CLASS="EXAMPLE"
  16.166 +><A
  16.167 +NAME="AEN191"
  16.168 +></A
  16.169 +><P
  16.170 +><B
  16.171 +>Example 3-4. Joystick Axis Events</B
  16.172 +></P
  16.173 +><PRE
  16.174  CLASS="PROGRAMLISTING"
  16.175  >    case SDL_JOYAXISMOTION:  /* Handle Joystick Motion */
  16.176      if ( ( event.jaxis.value &#60; -3200 ) || (event.jaxis.value &#62; 3200 ) ) 
  16.177 @@ -300,9 +338,19 @@
  16.178        /* code goes here */
  16.179      }
  16.180      break;</PRE
  16.181 ->
  16.182 -Another trick with axis events is that up-down and left-right movement are two different sets of axes. The most important axis is axis 0 (left-right) and axis 1 (up-down).  To handle them seperatly in the code we do the following:
  16.183 -<PRE
  16.184 +></DIV
  16.185 +><P
  16.186 +>Another trick with axis events is that up-down and left-right movement are two different sets of axes. The most important axis is axis 0 (left-right) and axis 1 (up-down).  To handle them seperatly in the code we do the following:</P
  16.187 +><DIV
  16.188 +CLASS="EXAMPLE"
  16.189 +><A
  16.190 +NAME="AEN195"
  16.191 +></A
  16.192 +><P
  16.193 +><B
  16.194 +>Example 3-5. More Joystick Axis Events</B
  16.195 +></P
  16.196 +><PRE
  16.197  CLASS="PROGRAMLISTING"
  16.198  >    case SDL_JOYAXISMOTION:  /* Handle Joystick Motion */
  16.199      if ( ( event.jaxis.value &#60; -3200 ) || (event.jaxis.value &#62; 3200 ) ) 
  16.200 @@ -318,8 +366,9 @@
  16.201          }
  16.202      }
  16.203      break;</PRE
  16.204 ->
  16.205 -Ideally the code here should use <TT
  16.206 +></DIV
  16.207 +><P
  16.208 +>Ideally the code here should use <TT
  16.209  CLASS="STRUCTFIELD"
  16.210  ><I
  16.211  >event.jaxis.value</I
  16.212 @@ -333,8 +382,17 @@
  16.213  ></TT
  16.214  > values.</P
  16.215  ><P
  16.216 ->Button handling is simple compared to the axis checking.
  16.217 -<PRE
  16.218 +>Button handling is simple compared to the axis checking.</P
  16.219 +><DIV
  16.220 +CLASS="EXAMPLE"
  16.221 +><A
  16.222 +NAME="AEN203"
  16.223 +></A
  16.224 +><P
  16.225 +><B
  16.226 +>Example 3-6. Joystick Button Events</B
  16.227 +></P
  16.228 +><PRE
  16.229  CLASS="PROGRAMLISTING"
  16.230  >    case SDL_JOYBUTTONDOWN:  /* Handle Joystick Button Presses */
  16.231      if ( event.jbutton.button == 0 ) 
  16.232 @@ -342,9 +400,9 @@
  16.233          /* code goes here */
  16.234      }
  16.235      break;</PRE
  16.236 ->
  16.237 -
  16.238 -Button checks are simpler than axis checks because a button can only be pressed or not pressed.  The <TT
  16.239 +></DIV
  16.240 +><P
  16.241 +>Button checks are simpler than axis checks because a button can only be pressed or not pressed.  The <TT
  16.242  CLASS="LITERAL"
  16.243  >SDL_JOYBUTTONDOWN</TT
  16.244  > event is triggered when a button is pressed and the <TT
  16.245 @@ -374,12 +432,21 @@
  16.246  ><H2
  16.247  CLASS="SECT2"
  16.248  ><A
  16.249 -NAME="AEN156"
  16.250 +NAME="AEN214"
  16.251  >Advanced Joystick Functions</A
  16.252  ></H2
  16.253  ><P
  16.254 ->That takes care of the controls that you can count on being on every joystick under the sun, but there are a few extra things that SDL can support.  Joyballs are next on our list, they are alot like axis we a few minor differences.  Joyballs store relative changes unlike the the absolute postion stored in a axis event. Also one trackball event contains both the change in x and they change in y.  Our case for it is as follows: 
  16.255 -<PRE
  16.256 +>That takes care of the controls that you can count on being on every joystick under the sun, but there are a few extra things that SDL can support.  Joyballs are next on our list, they are alot like axis we a few minor differences.  Joyballs store relative changes unlike the the absolute postion stored in a axis event. Also one trackball event contains both the change in x and they change in y.  Our case for it is as follows:</P
  16.257 +><DIV
  16.258 +CLASS="EXAMPLE"
  16.259 +><A
  16.260 +NAME="AEN217"
  16.261 +></A
  16.262 +><P
  16.263 +><B
  16.264 +>Example 3-7. Joystick Ball Events</B
  16.265 +></P
  16.266 +><PRE
  16.267  CLASS="PROGRAMLISTING"
  16.268  >    case SDL_JOYBALLMOTION:  /* Handle Joyball Motion */
  16.269      if( event.jball.ball == 0 )
  16.270 @@ -387,8 +454,9 @@
  16.271        /* ball handling */
  16.272      }
  16.273      break;</PRE
  16.274 ->
  16.275 -The above checks the first joyball on the joystick. The change in position will be stored in <TT
  16.276 +></DIV
  16.277 +><P
  16.278 +>The above checks the first joyball on the joystick. The change in position will be stored in <TT
  16.279  CLASS="STRUCTFIELD"
  16.280  ><I
  16.281  >event.jball.xrel</I
  16.282 @@ -488,9 +556,17 @@
  16.283  ></P
  16.284  >
  16.285  
  16.286 -Our case for the hat may resemble the following:
  16.287 -
  16.288 -<PRE
  16.289 +Our case for the hat may resemble the following:</P
  16.290 +><DIV
  16.291 +CLASS="EXAMPLE"
  16.292 +><A
  16.293 +NAME="AEN244"
  16.294 +></A
  16.295 +><P
  16.296 +><B
  16.297 +>Example 3-8. Joystick Hat Events</B
  16.298 +></P
  16.299 +><PRE
  16.300  CLASS="PROGRAMLISTING"
  16.301  >    case SDL_JOYHATMOTION:  /* Handle Hat Motion */
  16.302      if ( event.jhat.hat | SDL_HAT_UP )
  16.303 @@ -508,7 +584,7 @@
  16.304          /* Do right and down together stuff here */
  16.305      }
  16.306      break;</PRE
  16.307 -></P
  16.308 +></DIV
  16.309  ><P
  16.310  >In addition to the queries for number of joysticks on the system and their names there are additional functions to query the capabilities of attached joysticks:
  16.311  <P
  16.312 @@ -570,18 +646,26 @@
  16.313  ></P
  16.314  >
  16.315  
  16.316 -To use these functions we just have to pass in the joystick structure we got when we opened the joystick. For Example:
  16.317 -
  16.318 -<PRE
  16.319 +To use these functions we just have to pass in the joystick structure we got when we opened the joystick. For Example:</P
  16.320 +><DIV
  16.321 +CLASS="EXAMPLE"
  16.322 +><A
  16.323 +NAME="AEN265"
  16.324 +></A
  16.325 +><P
  16.326 +><B
  16.327 +>Example 3-9. Querying Joystick Characteristics</B
  16.328 +></P
  16.329 +><PRE
  16.330  CLASS="PROGRAMLISTING"
  16.331  >    int number_of_buttons;
  16.332      SDL_Joystick *joystick;
  16.333  
  16.334      joystick = SDL_JoystickOpen(0);
  16.335      number_of_buttons = SDL_JoystickNumButtons(joystick);</PRE
  16.336 ->
  16.337 -
  16.338 -This block of code would get the number of buttons on the first joystick in the system.	</P
  16.339 +></DIV
  16.340 +><P
  16.341 +>This block of code would get the number of buttons on the first joystick in the system.	</P
  16.342  ></DIV
  16.343  ></DIV
  16.344  ></DIV
  16.345 @@ -600,7 +684,7 @@
  16.346  ALIGN="left"
  16.347  VALIGN="top"
  16.348  ><A
  16.349 -HREF="guidevideo.html"
  16.350 +HREF="guidevideoopengl.html"
  16.351  >Prev</A
  16.352  ></TD
  16.353  ><TD
  16.354 @@ -625,7 +709,7 @@
  16.355  WIDTH="33%"
  16.356  ALIGN="left"
  16.357  VALIGN="top"
  16.358 ->Graphics and Video</TD
  16.359 +>Using OpenGL With SDL</TD
  16.360  ><TD
  16.361  WIDTH="34%"
  16.362  ALIGN="center"
    17.1 --- a/docs/html/guideinputkeyboard.html	Sun Jun 10 18:39:47 2001 +0000
    17.2 +++ b/docs/html/guideinputkeyboard.html	Sun Jun 10 19:31:57 2001 +0000
    17.3 @@ -4,7 +4,7 @@
    17.4  >Handling the Keyboard</TITLE
    17.5  ><META
    17.6  NAME="GENERATOR"
    17.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    17.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    17.9  "><LINK
   17.10  REL="HOME"
   17.11  TITLE="SDL Library Documentation"
   17.12 @@ -78,7 +78,7 @@
   17.13  ><H2
   17.14  CLASS="SECT2"
   17.15  ><A
   17.16 -NAME="AEN205"
   17.17 +NAME="AEN271"
   17.18  >Keyboard Related Structures</A
   17.19  ></H2
   17.20  ><P
   17.21 @@ -88,7 +88,7 @@
   17.22  ><H3
   17.23  CLASS="SECT3"
   17.24  ><A
   17.25 -NAME="AEN208"
   17.26 +NAME="AEN274"
   17.27  >SDLKey</A
   17.28  ></H3
   17.29  ><P
   17.30 @@ -114,7 +114,7 @@
   17.31  ><H3
   17.32  CLASS="SECT3"
   17.33  ><A
   17.34 -NAME="AEN216"
   17.35 +NAME="AEN282"
   17.36  >SDLMod</A
   17.37  ></H3
   17.38  ><P
   17.39 @@ -134,7 +134,7 @@
   17.40  ><H3
   17.41  CLASS="SECT3"
   17.42  ><A
   17.43 -NAME="AEN222"
   17.44 +NAME="AEN288"
   17.45  >SDL_keysym</A
   17.46  ></H3
   17.47  ><PRE
   17.48 @@ -215,7 +215,7 @@
   17.49  ><H3
   17.50  CLASS="SECT3"
   17.51  ><A
   17.52 -NAME="AEN241"
   17.53 +NAME="AEN307"
   17.54  >SDL_KeyboardEvent</A
   17.55  ></H3
   17.56  ><PRE
   17.57 @@ -283,7 +283,7 @@
   17.58  ><H2
   17.59  CLASS="SECT2"
   17.60  ><A
   17.61 -NAME="AEN258"
   17.62 +NAME="AEN324"
   17.63  >Reading Keyboard Events</A
   17.64  ></H2
   17.65  ><P
   17.66 @@ -308,8 +308,17 @@
   17.67  > events using a <TT
   17.68  CLASS="LITERAL"
   17.69  >switch</TT
   17.70 -> statement, like so:
   17.71 -<PRE
   17.72 +> statement, like so:</P
   17.73 +><DIV
   17.74 +CLASS="EXAMPLE"
   17.75 +><A
   17.76 +NAME="AEN334"
   17.77 +></A
   17.78 +><P
   17.79 +><B
   17.80 +>Example 3-10. Reading Keyboard Events</B
   17.81 +></P
   17.82 +><PRE
   17.83  CLASS="PROGRAMLISTING"
   17.84  >  SDL_Event event;
   17.85    .
   17.86 @@ -334,15 +343,16 @@
   17.87    }
   17.88    .
   17.89    .</PRE
   17.90 ->
   17.91 -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
   17.92 +></DIV
   17.93 +><P
   17.94 +>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
   17.95  ></DIV
   17.96  ><DIV
   17.97  CLASS="SECT2"
   17.98  ><H2
   17.99  CLASS="SECT2"
  17.100  ><A
  17.101 -NAME="AEN269"
  17.102 +NAME="AEN338"
  17.103  >A More Detailed Look</A
  17.104  ></H2
  17.105  ><P
  17.106 @@ -384,11 +394,11 @@
  17.107  ><DIV
  17.108  CLASS="EXAMPLE"
  17.109  ><A
  17.110 -NAME="AEN282"
  17.111 +NAME="AEN351"
  17.112  ></A
  17.113  ><P
  17.114  ><B
  17.115 ->Example 3-1. keys.c - Key event information</B
  17.116 +>Example 3-11. Interpreting Key Event Information</B
  17.117  ></P
  17.118  ><PRE
  17.119  CLASS="PROGRAMLISTING"
  17.120 @@ -405,7 +415,7 @@
  17.121          int quit = 0;
  17.122          
  17.123          /* Initialise SDL */
  17.124 -        if( SDL_Init( SDL_INIT_VIDEO ) ){
  17.125 +        if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0){
  17.126              fprintf( stderr, "Could not initialise SDL: %s\n", SDL_GetError() );
  17.127              exit( -1 );
  17.128          }
  17.129 @@ -518,13 +528,13 @@
  17.130  ><H2
  17.131  CLASS="SECT2"
  17.132  ><A
  17.133 -NAME="AEN285"
  17.134 +NAME="AEN354"
  17.135  >Game-type Input</A
  17.136  ></H2
  17.137  ><P
  17.138  >I have found that people using keyboard events for games and other interactive applications don't always understand one fundemental point.</P
  17.139  ><A
  17.140 -NAME="AEN288"
  17.141 +NAME="AEN357"
  17.142  ></A
  17.143  ><BLOCKQUOTE
  17.144  CLASS="BLOCKQUOTE"
  17.145 @@ -575,8 +585,17 @@
  17.146  >
  17.147  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
  17.148  ><P
  17.149 ->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:
  17.150 -<PRE
  17.151 +>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
  17.152 +><DIV
  17.153 +CLASS="EXAMPLE"
  17.154 +><A
  17.155 +NAME="AEN363"
  17.156 +></A
  17.157 +><P
  17.158 +><B
  17.159 +>Example 3-12. Proper Game Movement</B
  17.160 +></P
  17.161 +><PRE
  17.162  CLASS="PROGRAMLISTING"
  17.163  >    /* Alien screen coordinates */
  17.164      int alien_x=0, alien_y=0;
  17.165 @@ -649,8 +668,9 @@
  17.166      /* Update the alien position */
  17.167      alien_x += alien_xvel;
  17.168      alien_y += alien_yvel;</PRE
  17.169 ->
  17.170 -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
  17.171 +></DIV
  17.172 +><P
  17.173 +>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
  17.174  ></DIV
  17.175  ></DIV
  17.176  ><DIV
    18.1 --- a/docs/html/guidepreface.html	Sun Jun 10 18:39:47 2001 +0000
    18.2 +++ b/docs/html/guidepreface.html	Sun Jun 10 19:31:57 2001 +0000
    18.3 @@ -4,7 +4,7 @@
    18.4  >Preface</TITLE
    18.5  ><META
    18.6  NAME="GENERATOR"
    18.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    18.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    18.9  "><LINK
   18.10  REL="HOME"
   18.11  TITLE="SDL Library Documentation"
    19.1 --- a/docs/html/guidethebasics.html	Sun Jun 10 18:39:47 2001 +0000
    19.2 +++ b/docs/html/guidethebasics.html	Sun Jun 10 19:31:57 2001 +0000
    19.3 @@ -4,7 +4,7 @@
    19.4  >The Basics</TITLE
    19.5  ><META
    19.6  NAME="GENERATOR"
    19.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    19.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    19.9  "><LINK
   19.10  REL="HOME"
   19.11  TITLE="SDL Library Documentation"
    20.1 --- a/docs/html/guidetimeexamples.html	Sun Jun 10 18:39:47 2001 +0000
    20.2 +++ b/docs/html/guidetimeexamples.html	Sun Jun 10 19:31:57 2001 +0000
    20.3 @@ -4,7 +4,7 @@
    20.4  >Time Examples</TITLE
    20.5  ><META
    20.6  NAME="GENERATOR"
    20.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    20.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    20.9  "><LINK
   20.10  REL="HOME"
   20.11  TITLE="SDL Library Documentation"
   20.12 @@ -80,7 +80,7 @@
   20.13  ><H2
   20.14  CLASS="SECT2"
   20.15  ><A
   20.16 -NAME="AEN373"
   20.17 +NAME="AEN412"
   20.18  >Time based game loop</A
   20.19  ></H2
   20.20  ><P
    21.1 --- a/docs/html/guidevideo.html	Sun Jun 10 18:39:47 2001 +0000
    21.2 +++ b/docs/html/guidevideo.html	Sun Jun 10 19:31:57 2001 +0000
    21.3 @@ -4,7 +4,7 @@
    21.4  >Graphics and Video</TITLE
    21.5  ><META
    21.6  NAME="GENERATOR"
    21.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    21.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    21.9  "><LINK
   21.10  REL="HOME"
   21.11  TITLE="SDL Library Documentation"
   21.12 @@ -16,8 +16,8 @@
   21.13  TITLE="Initializing SDL"
   21.14  HREF="guidebasicsinit.html"><LINK
   21.15  REL="NEXT"
   21.16 -TITLE="Input handling"
   21.17 -HREF="guideinput.html"></HEAD
   21.18 +TITLE="Using OpenGL With SDL"
   21.19 +HREF="guidevideoopengl.html"></HEAD
   21.20  ><BODY
   21.21  CLASS="CHAPTER"
   21.22  BGCOLOR="#FFF8DC"
   21.23 @@ -57,7 +57,7 @@
   21.24  ALIGN="right"
   21.25  VALIGN="bottom"
   21.26  ><A
   21.27 -HREF="guideinput.html"
   21.28 +HREF="guidevideoopengl.html"
   21.29  >Next</A
   21.30  ></TD
   21.31  ></TR
   21.32 @@ -73,572 +73,322 @@
   21.33  >Chapter 2. Graphics and Video</A
   21.34  ></H1
   21.35  ><DIV
   21.36 +CLASS="TOC"
   21.37 +><DL
   21.38 +><DT
   21.39 +><B
   21.40 +>Table of Contents</B
   21.41 +></DT
   21.42 +><DT
   21.43 +><A
   21.44 +HREF="guidevideo.html#GUIDEVIDEOINTRO"
   21.45 +>Introduction to SDL Video</A
   21.46 +></DT
   21.47 +><DT
   21.48 +><A
   21.49 +HREF="guidevideoopengl.html"
   21.50 +>Using OpenGL With SDL</A
   21.51 +></DT
   21.52 +></DL
   21.53 +></DIV
   21.54 +><DIV
   21.55  CLASS="SECT1"
   21.56  ><H1
   21.57  CLASS="SECT1"
   21.58  ><A
   21.59 -NAME="GUIDEVIDEOOPENGL"
   21.60 ->Using OpenGL With SDL</A
   21.61 +NAME="GUIDEVIDEOINTRO"
   21.62 +>Introduction to SDL Video</A
   21.63  ></H1
   21.64  ><P
   21.65 ->SDL has the ability to create and use OpenGL contexts on several platforms(Linux/X11, Win32, BeOS, MacOS Classic/Toolbox, MacOS X, FreeBSD/X11 and Solaris/X11). This allows you to use SDL's audio, event handling, threads and times in your OpenGL applications (a function often performed by GLUT).</P
   21.66 +>Video is probably the most common thing that SDL is used for, and
   21.67 +so it has the most complete subsystem. Here are a few
   21.68 +examples to demonstrate the basics.</P
   21.69  ><DIV
   21.70  CLASS="SECT2"
   21.71  ><H2
   21.72  CLASS="SECT2"
   21.73  ><A
   21.74 -NAME="AEN65"
   21.75 ->Initialisation</A
   21.76 +NAME="AEN68"
   21.77 +>Initializing the Video Display</A
   21.78  ></H2
   21.79  ><P
   21.80 ->Initialising SDL to use OpenGL is not very different to initialising SDL normally. There are three differences; you must pass <TT
   21.81 -CLASS="LITERAL"
   21.82 ->SDL_OPENGL</TT
   21.83 -> to <A
   21.84 -HREF="sdlsetvideomode.html"
   21.85 -><TT
   21.86 -CLASS="FUNCTION"
   21.87 ->SDL_SetVideoMode</TT
   21.88 +>This is what almost all SDL programs have to do in one way or
   21.89 +another.</P
   21.90 +><DIV
   21.91 +CLASS="EXAMPLE"
   21.92 +><A
   21.93 +NAME="AEN71"
   21.94  ></A
   21.95 ->, you must specify several GL attributes (depth buffer size, framebuffer sizes) using <A
   21.96 -HREF="sdlglsetattribute.html"
   21.97 -><TT
   21.98 -CLASS="FUNCTION"
   21.99 ->SDL_GL_SetAttribute</TT
  21.100 -></A
  21.101 -> and finally, if you wish to use double buffering you must specify it as a GL attribute, <I
  21.102 -CLASS="EMPHASIS"
  21.103 ->not</I
  21.104 -> by passing the <TT
  21.105 -CLASS="LITERAL"
  21.106 ->SDL_DOUBLEBUF</TT
  21.107 -> flag to <TT
  21.108 -CLASS="FUNCTION"
  21.109 ->SDL_SetVideoMode</TT
  21.110 ->.
  21.111 -<PRE
  21.112 +><P
  21.113 +><B
  21.114 +>Example 2-1. Initializing the Video Display</B
  21.115 +></P
  21.116 +><PRE
  21.117  CLASS="PROGRAMLISTING"
  21.118 ->    /* Information about the current video settings. */
  21.119 -    const SDL_VideoInfo* info = NULL;
  21.120 -    /* Dimensions of our window. */
  21.121 -    int width = 0;
  21.122 -    int height = 0;
  21.123 -    /* Color depth in bits of our window. */
  21.124 -    int bpp = 0;
  21.125 -    /* Flags we will pass into SDL_SetVideoMode. */
  21.126 -    int flags = 0;
  21.127 +>    SDL_Surface *screen;
  21.128  
  21.129 -    /* First, initialize SDL's video subsystem. */
  21.130 -    if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0 ) {
  21.131 -        /* Failed, exit. */
  21.132 -        fprintf( stderr, "Video initialization failed: %s\n",
  21.133 -             SDL_GetError( ) );
  21.134 -        quit_tutorial( 1 );
  21.135 +    /* Initialize the SDL library */
  21.136 +    if( SDL_Init(SDL_INIT_VIDEO) &#60; 0 ) {
  21.137 +        fprintf(stderr,
  21.138 +                "Couldn't initialize SDL: %s\n", SDL_GetError());
  21.139 +        exit(1);
  21.140      }
  21.141  
  21.142 -    /* Let's get some video information. */
  21.143 -    info = SDL_GetVideoInfo( );
  21.144 -
  21.145 -    if( !info ) {
  21.146 -        /* This should probably never happen. */
  21.147 -        fprintf( stderr, "Video query failed: %s\n",
  21.148 -             SDL_GetError( ) );
  21.149 -        quit_tutorial( 1 );
  21.150 -    }
  21.151 -
  21.152 +    /* Clean up on exit */
  21.153 +    atexit(SDL_Quit);
  21.154 +    
  21.155      /*
  21.156 -     * Set our width/height to 640/480 (you would
  21.157 -     * of course let the user decide this in a normal
  21.158 -     * app). We get the bpp we will request from
  21.159 -     * the display. On X11, VidMode can't change
  21.160 -     * resolution, so this is probably being overly
  21.161 -     * safe. Under Win32, ChangeDisplaySettings
  21.162 -     * can change the bpp.
  21.163 +     * Initialize the display in a 640x480 8-bit palettized mode,
  21.164 +     * requesting a software surface
  21.165       */
  21.166 -    width = 640;
  21.167 -    height = 480;
  21.168 -    bpp = info-&#62;vfmt-&#62;BitsPerPixel;
  21.169 -
  21.170 -    /*
  21.171 -     * Now, we want to setup our requested
  21.172 -     * window attributes for our OpenGL window.
  21.173 -     * We want *at least* 5 bits of red, green
  21.174 -     * and blue. We also want at least a 16-bit
  21.175 -     * depth buffer.
  21.176 -     *
  21.177 -     * The last thing we do is request a double
  21.178 -     * buffered window. '1' turns on double
  21.179 -     * buffering, '0' turns it off.
  21.180 -     *
  21.181 -     * Note that we do not use SDL_DOUBLEBUF in
  21.182 -     * the flags to SDL_SetVideoMode. That does
  21.183 -     * not affect the GL attribute state, only
  21.184 -     * the standard 2D blitting setup.
  21.185 -     */
  21.186 -    SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
  21.187 -    SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
  21.188 -    SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
  21.189 -    SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
  21.190 -    SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
  21.191 -
  21.192 -    /*
  21.193 -     * We want to request that SDL provide us
  21.194 -     * with an OpenGL window, in a fullscreen
  21.195 -     * video mode.
  21.196 -     *
  21.197 -     * EXERCISE:
  21.198 -     * Make starting windowed an option, and
  21.199 -     * handle the resize events properly with
  21.200 -     * glViewport.
  21.201 -     */
  21.202 -    flags = SDL_OPENGL | SDL_FULLSCREEN;
  21.203 -
  21.204 -    /*
  21.205 -     * Set the video mode
  21.206 -     */
  21.207 -    if( SDL_SetVideoMode( width, height, bpp, flags ) == 0 ) {
  21.208 -        /* 
  21.209 -         * This could happen for a variety of reasons,
  21.210 -         * including DISPLAY not being set, the specified
  21.211 -         * resolution not being available, etc.
  21.212 -         */
  21.213 -        fprintf( stderr, "Video mode set failed: %s\n",
  21.214 -             SDL_GetError( ) );
  21.215 -        quit_tutorial( 1 );
  21.216 +    screen = SDL_SetVideoMode(640, 480, 8, SDL_SWSURFACE);
  21.217 +    if ( screen == NULL ) {
  21.218 +        fprintf(stderr, "Couldn't set 640x480x8 video mode: %s\n",
  21.219 +                        SDL_GetError());
  21.220 +        exit(1);
  21.221      }</PRE
  21.222 -></P
  21.223 +></DIV
  21.224  ></DIV
  21.225  ><DIV
  21.226  CLASS="SECT2"
  21.227  ><H2
  21.228  CLASS="SECT2"
  21.229  ><A
  21.230 -NAME="AEN77"
  21.231 ->Drawing</A
  21.232 +NAME="AEN74"
  21.233 +>Initializing the Best Video Mode</A
  21.234  ></H2
  21.235  ><P
  21.236 ->Apart from initialisation, using OpenGL within SDL is the same as using. However if you have request a double buffered display (using <A
  21.237 -HREF="sdlglsetattribute.html"
  21.238 -><TT
  21.239 -CLASS="FUNCTION"
  21.240 ->SDL_GL_SetAttribute</TT
  21.241 -></A
  21.242 ->) and one (which can be checked by using <A
  21.243 -HREF="sdlglgetattribute.html"
  21.244 -><TT
  21.245 -CLASS="FUNCTION"
  21.246 ->SDL_GL_GetAttribute</TT
  21.247 -></A
  21.248 ->), then you must use <A
  21.249 -HREF="sdlglswapbuffers.html"
  21.250 -><TT
  21.251 -CLASS="FUNCTION"
  21.252 ->SDL_GL_SwapBuffers()</TT
  21.253 -></A
  21.254 -> to swap the buffers and update the display.</P
  21.255 -><P
  21.256 ->A full example code listing is now presented below.</P
  21.257 +>If you have a preference for a certain pixel depth but will accept any
  21.258 +other, use SDL_SetVideoMode with SDL_ANYFORMAT as below. You can also
  21.259 +use SDL_VideoModeOK() to find the native video mode that is closest to
  21.260 +the mode you request.</P
  21.261  ><DIV
  21.262  CLASS="EXAMPLE"
  21.263  ><A
  21.264 -NAME="AEN87"
  21.265 +NAME="AEN77"
  21.266  ></A
  21.267  ><P
  21.268  ><B
  21.269 ->Example 2-1. gl.c - SDL OpenGL Example</B
  21.270 +>Example 2-2. Initializing the Best Video Mode</B
  21.271 +></P
  21.272 +><PRE
  21.273 +CLASS="PROGRAMLISTING"
  21.274 +>    /* Have a preference for 8-bit, but accept any depth */
  21.275 +    screen = SDL_SetVideoMode(640, 480, 8, SDL_SWSURFACE|SDL_ANYFORMAT);
  21.276 +    if ( screen == NULL ) {
  21.277 +        fprintf(stderr, "Couldn't set 640x480x8 video mode: %s\n",
  21.278 +                        SDL_GetError());
  21.279 +        exit(1);
  21.280 +    }
  21.281 +    printf("Set 640x480 at %d bits-per-pixel mode\n",
  21.282 +           screen-&#62;format-&#62;BitsPerPixel);</PRE
  21.283 +></DIV
  21.284 +></DIV
  21.285 +><DIV
  21.286 +CLASS="SECT2"
  21.287 +><H2
  21.288 +CLASS="SECT2"
  21.289 +><A
  21.290 +NAME="AEN80"
  21.291 +>Loading and Displaying a BMP File</A
  21.292 +></H2
  21.293 +><P
  21.294 +>The following function loads and displays a BMP file given as
  21.295 +argument, once SDL is initialised and a video mode has been set.</P
  21.296 +><DIV
  21.297 +CLASS="EXAMPLE"
  21.298 +><A
  21.299 +NAME="AEN83"
  21.300 +></A
  21.301 +><P
  21.302 +><B
  21.303 +>Example 2-3. Loading and Displaying a BMP File</B
  21.304 +></P
  21.305 +><PRE
  21.306 +CLASS="PROGRAMLISTING"
  21.307 +>void display_bmp(char *file_name)
  21.308 +{
  21.309 +    SDL_Surface *image;
  21.310 +
  21.311 +    /* Load the BMP file into a surface */
  21.312 +    image = SDL_LoadBMP(file_name);
  21.313 +    if (image == NULL) {
  21.314 +        fprintf(stderr, "Couldn't load %s: %s\n", file_name, SDL_GetError());
  21.315 +        return;
  21.316 +    }
  21.317 +
  21.318 +    /*
  21.319 +     * Palettized screen modes will have a default palette (a standard
  21.320 +     * 8*8*4 colour cube), but if the image is palettized as well we can
  21.321 +     * use that palette for a nicer colour matching
  21.322 +     */
  21.323 +    if (image-&#62;format-&#62;palette &#38;&#38; screen-&#62;format-&#62;palette) {
  21.324 +    SDL_SetColors(screen, image-&#62;format-&#62;palette-&#62;colors, 0,
  21.325 +                  image-&#62;format-&#62;palette-&#62;ncolors);
  21.326 +    }
  21.327 +
  21.328 +    /* Blit onto the screen surface */
  21.329 +    if(SDL_BlitSurface(image, NULL, screen, NULL) &#60; 0)
  21.330 +        fprintf(stderr, "BlitSurface error: %s\n", SDL_GetError());
  21.331 +
  21.332 +    SDL_UpdateRect(screen, 0, 0, image-&#62;w, image-&#62;h);
  21.333 +
  21.334 +    /* Free the allocated BMP surface */
  21.335 +    SDL_FreeSurface(image);
  21.336 +}</PRE
  21.337 +></DIV
  21.338 +></DIV
  21.339 +><DIV
  21.340 +CLASS="SECT2"
  21.341 +><H2
  21.342 +CLASS="SECT2"
  21.343 +><A
  21.344 +NAME="AEN86"
  21.345 +>Drawing Directly to the Display</A
  21.346 +></H2
  21.347 +><P
  21.348 +>The following two functions can be used to get and set single
  21.349 +pixels of a surface. They are carefully written to work with any depth
  21.350 +currently supported by SDL. Remember to lock the surface before
  21.351 +calling them, and to unlock it before calling any other SDL
  21.352 +functions.</P
  21.353 +><P
  21.354 +>To convert between pixel values and their red, green, blue
  21.355 +components, use SDL_GetRGB() and SDL_MapRGB().</P
  21.356 +><DIV
  21.357 +CLASS="EXAMPLE"
  21.358 +><A
  21.359 +NAME="AEN90"
  21.360 +></A
  21.361 +><P
  21.362 +><B
  21.363 +>Example 2-4. getpixel()</B
  21.364  ></P
  21.365  ><PRE
  21.366  CLASS="PROGRAMLISTING"
  21.367  >/*
  21.368 - * SDL OpenGL Tutorial.
  21.369 - * (c) Michael Vance, 2000
  21.370 - * briareos@lokigames.com
  21.371 - *
  21.372 - * Distributed under terms of the LGPL. 
  21.373 + * Return the pixel value at (x, y)
  21.374 + * NOTE: The surface must be locked before calling this!
  21.375   */
  21.376 +Uint32 getpixel(SDL_Surface *surface, int x, int y)
  21.377 +{
  21.378 +    int bpp = surface-&#62;format-&#62;BytesPerPixel;
  21.379 +    /* Here p is the address to the pixel we want to retrieve */
  21.380 +    Uint8 *p = (Uint8 *)surface-&#62;pixels + y * surface-&#62;pitch + x * bpp;
  21.381  
  21.382 -#include &#60;SDL/SDL.h&#62;
  21.383 -#include &#60;GL/gl.h&#62;
  21.384 -#include &#60;GL/glu.h&#62;
  21.385 +    switch(bpp) {
  21.386 +    case 1:
  21.387 +        return *p;
  21.388  
  21.389 -#include &#60;stdio.h&#62;
  21.390 -#include &#60;stdlib.h&#62;
  21.391 +    case 2:
  21.392 +        return *(Uint16 *)p;
  21.393  
  21.394 -static GLboolean should_rotate = GL_TRUE;
  21.395 +    case 3:
  21.396 +        if(SDL_BYTEORDER == SDL_BIG_ENDIAN)
  21.397 +            return p[0] &#60;&#60; 16 | p[1] &#60;&#60; 8 | p[2];
  21.398 +        else
  21.399 +            return p[0] | p[1] &#60;&#60; 8 | p[2] &#60;&#60; 16;
  21.400  
  21.401 -static void quit_tutorial( int code )
  21.402 +    case 4:
  21.403 +        return *(Uint32 *)p;
  21.404 +
  21.405 +    default:
  21.406 +        return 0;       /* shouldn't happen, but avoids warnings */
  21.407 +    }
  21.408 +}</PRE
  21.409 +></DIV
  21.410 +><DIV
  21.411 +CLASS="EXAMPLE"
  21.412 +><A
  21.413 +NAME="AEN93"
  21.414 +></A
  21.415 +><P
  21.416 +><B
  21.417 +>Example 2-5. putpixel()</B
  21.418 +></P
  21.419 +><PRE
  21.420 +CLASS="PROGRAMLISTING"
  21.421 +>/*
  21.422 + * Set the pixel at (x, y) to the given value
  21.423 + * NOTE: The surface must be locked before calling this!
  21.424 + */
  21.425 +void putpixel(SDL_Surface *surface, int x, int y, Uint32 pixel)
  21.426  {
  21.427 -    /*
  21.428 -     * Quit SDL so we can release the fullscreen
  21.429 -     * mode and restore the previous video settings,
  21.430 -     * etc.
  21.431 -     */
  21.432 -    SDL_Quit( );
  21.433 +    int bpp = surface-&#62;format-&#62;BytesPerPixel;
  21.434 +    /* Here p is the address to the pixel we want to set */
  21.435 +    Uint8 *p = (Uint8 *)surface-&#62;pixels + y * surface-&#62;pitch + x * bpp;
  21.436  
  21.437 -    /* Exit program. */
  21.438 -    exit( code );
  21.439 -}
  21.440 +    switch(bpp) {
  21.441 +    case 1:
  21.442 +        *p = pixel;
  21.443 +        break;
  21.444  
  21.445 -static void handle_key_down( SDL_keysym* keysym )
  21.446 -{
  21.447 +    case 2:
  21.448 +        *(Uint16 *)p = pixel;
  21.449 +        break;
  21.450  
  21.451 -    /* 
  21.452 -     * We're only interested if 'Esc' has
  21.453 -     * been presssed.
  21.454 -     *
  21.455 -     * EXERCISE: 
  21.456 -     * Handle the arrow keys and have that change the
  21.457 -     * viewing position/angle.
  21.458 -     */
  21.459 -    switch( keysym-&#62;sym ) {
  21.460 -    case SDLK_ESCAPE:
  21.461 -        quit_tutorial( 0 );
  21.462 +    case 3:
  21.463 +        if(SDL_BYTEORDER == SDL_BIG_ENDIAN) {
  21.464 +            p[0] = (pixel &#62;&#62; 16) &#38; 0xff;
  21.465 +            p[1] = (pixel &#62;&#62; 8) &#38; 0xff;
  21.466 +            p[2] = pixel &#38; 0xff;
  21.467 +        } else {
  21.468 +            p[0] = pixel &#38; 0xff;
  21.469 +            p[1] = (pixel &#62;&#62; 8) &#38; 0xff;
  21.470 +            p[2] = (pixel &#62;&#62; 16) &#38; 0xff;
  21.471 +        }
  21.472          break;
  21.473 -    case SDLK_SPACE:
  21.474 -        should_rotate = !should_rotate;
  21.475 -        break;
  21.476 -    default:
  21.477 +
  21.478 +    case 4:
  21.479 +        *(Uint32 *)p = pixel;
  21.480          break;
  21.481      }
  21.482 +}</PRE
  21.483 +></DIV
  21.484 +><P
  21.485 +>The following code uses the putpixel() function above to set a
  21.486 +yellow pixel in the middle of the screen.</P
  21.487 +><DIV
  21.488 +CLASS="EXAMPLE"
  21.489 +><A
  21.490 +NAME="AEN97"
  21.491 +></A
  21.492 +><P
  21.493 +><B
  21.494 +>Example 2-6. Using putpixel()</B
  21.495 +></P
  21.496 +><PRE
  21.497 +CLASS="PROGRAMLISTING"
  21.498 +>&#13;    /* Code to set a yellow pixel at the center of the screen */
  21.499  
  21.500 -}
  21.501 +    int x, y;
  21.502 +    Uint32 yellow;
  21.503  
  21.504 -static void process_events( void )
  21.505 -{
  21.506 -    /* Our SDL event placeholder. */
  21.507 -    SDL_Event event;
  21.508 +    /* Map the color yellow to this display (R=0xff, G=0xFF, B=0x00)
  21.509 +       Note:  If the display is palettized, you must set the palette first.
  21.510 +    */
  21.511 +    yellow = SDL_MapRGB(screen-&#62;format, 0xff, 0xff, 0x00);
  21.512  
  21.513 -    /* Grab all the events off the queue. */
  21.514 -    while( SDL_PollEvent( &#38;event ) ) {
  21.515 +    x = screen-&#62;w / 2;
  21.516 +    y = screen-&#62;h / 2;
  21.517  
  21.518 -        switch( event.type ) {
  21.519 -        case SDL_KEYDOWN:
  21.520 -            /* Handle key presses. */
  21.521 -            handle_key_down( &#38;event.key.keysym );
  21.522 -            break;
  21.523 -        case SDL_QUIT:
  21.524 -            /* Handle quit requests (like Ctrl-c). */
  21.525 -            quit_tutorial( 0 );
  21.526 -            break;
  21.527 +    /* Lock the screen for direct access to the pixels */
  21.528 +    if ( SDL_MUSTLOCK(screen) ) {
  21.529 +        if ( SDL_LockSurface(screen) &#60; 0 ) {
  21.530 +            fprintf(stderr, "Can't lock screen: %s\n", SDL_GetError());
  21.531 +            return;
  21.532          }
  21.533 -
  21.534      }
  21.535  
  21.536 -}
  21.537 +    putpixel(screen, x, y, yellow);
  21.538  
  21.539 -static void draw_screen( void )
  21.540 -{
  21.541 -    /* Our angle of rotation. */
  21.542 -    static float angle = 0.0f;
  21.543 +    if ( SDL_MUSTLOCK(screen) ) {
  21.544 +        SDL_UnlockSurface(screen);
  21.545 +    }
  21.546 +    /* Update just the part of the display that we've changed */
  21.547 +    SDL_UpdateRect(screen, x, y, 1, 1);
  21.548  
  21.549 -    /*
  21.550 -     * EXERCISE:
  21.551 -     * Replace this awful mess with vertex
  21.552 -     * arrays and a call to glDrawElements.
  21.553 -     *
  21.554 -     * EXERCISE:
  21.555 -     * After completing the above, change
  21.556 -     * it to use compiled vertex arrays.
  21.557 -     *
  21.558 -     * EXERCISE:
  21.559 -     * Verify my windings are correct here ;).
  21.560 -     */
  21.561 -    static GLfloat v0[] = { -1.0f, -1.0f,  1.0f };
  21.562 -    static GLfloat v1[] = {  1.0f, -1.0f,  1.0f };
  21.563 -    static GLfloat v2[] = {  1.0f,  1.0f,  1.0f };
  21.564 -    static GLfloat v3[] = { -1.0f,  1.0f,  1.0f };
  21.565 -    static GLfloat v4[] = { -1.0f, -1.0f, -1.0f };
  21.566 -    static GLfloat v5[] = {  1.0f, -1.0f, -1.0f };
  21.567 -    static GLfloat v6[] = {  1.0f,  1.0f, -1.0f };
  21.568 -    static GLfloat v7[] = { -1.0f,  1.0f, -1.0f };
  21.569 -    static GLubyte red[]    = { 255,   0,   0, 255 };
  21.570 -    static GLubyte green[]  = {   0, 255,   0, 255 };
  21.571 -    static GLubyte blue[]   = {   0,   0, 255, 255 };
  21.572 -    static GLubyte white[]  = { 255, 255, 255, 255 };
  21.573 -    static GLubyte yellow[] = {   0, 255, 255, 255 };
  21.574 -    static GLubyte black[]  = {   0,   0,   0, 255 };
  21.575 -    static GLubyte orange[] = { 255, 255,   0, 255 };
  21.576 -    static GLubyte purple[] = { 255,   0, 255,   0 };
  21.577 -
  21.578 -    /* Clear the color and depth buffers. */
  21.579 -    glClear( GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT );
  21.580 -
  21.581 -    /* We don't want to modify the projection matrix. */
  21.582 -    glMatrixMode( GL_MODELVIEW );
  21.583 -    glLoadIdentity( );
  21.584 -
  21.585 -    /* Move down the z-axis. */
  21.586 -    glTranslatef( 0.0, 0.0, -5.0 );
  21.587 -
  21.588 -    /* Rotate. */
  21.589 -    glRotatef( angle, 0.0, 1.0, 0.0 );
  21.590 -
  21.591 -    if( should_rotate ) {
  21.592 -
  21.593 -        if( ++angle &#62; 360.0f ) {
  21.594 -            angle = 0.0f;
  21.595 -        }
  21.596 -
  21.597 -    }
  21.598 -
  21.599 -    /* Send our triangle data to the pipeline. */
  21.600 -    glBegin( GL_TRIANGLES );
  21.601 -
  21.602 -    glColor4ubv( red );
  21.603 -    glVertex3fv( v0 );
  21.604 -    glColor4ubv( green );
  21.605 -    glVertex3fv( v1 );
  21.606 -    glColor4ubv( blue );
  21.607 -    glVertex3fv( v2 );
  21.608 -
  21.609 -    glColor4ubv( red );
  21.610 -    glVertex3fv( v0 );
  21.611 -    glColor4ubv( blue );
  21.612 -    glVertex3fv( v2 );
  21.613 -    glColor4ubv( white );
  21.614 -    glVertex3fv( v3 );
  21.615 -
  21.616 -    glColor4ubv( green );
  21.617 -    glVertex3fv( v1 );
  21.618 -    glColor4ubv( black );
  21.619 -    glVertex3fv( v5 );
  21.620 -    glColor4ubv( orange );
  21.621 -    glVertex3fv( v6 );
  21.622 -
  21.623 -    glColor4ubv( green );
  21.624 -    glVertex3fv( v1 );
  21.625 -    glColor4ubv( orange );
  21.626 -    glVertex3fv( v6 );
  21.627 -    glColor4ubv( blue );
  21.628 -    glVertex3fv( v2 );
  21.629 -
  21.630 -    glColor4ubv( black );
  21.631 -    glVertex3fv( v5 );
  21.632 -    glColor4ubv( yellow );
  21.633 -    glVertex3fv( v4 );
  21.634 -    glColor4ubv( purple );
  21.635 -    glVertex3fv( v7 );
  21.636 -
  21.637 -    glColor4ubv( black );
  21.638 -    glVertex3fv( v5 );
  21.639 -    glColor4ubv( purple );
  21.640 -    glVertex3fv( v7 );
  21.641 -    glColor4ubv( orange );
  21.642 -    glVertex3fv( v6 );
  21.643 -
  21.644 -    glColor4ubv( yellow );
  21.645 -    glVertex3fv( v4 );
  21.646 -    glColor4ubv( red );
  21.647 -    glVertex3fv( v0 );
  21.648 -    glColor4ubv( white );
  21.649 -    glVertex3fv( v3 );
  21.650 -
  21.651 -    glColor4ubv( yellow );
  21.652 -    glVertex3fv( v4 );
  21.653 -    glColor4ubv( white );
  21.654 -    glVertex3fv( v3 );
  21.655 -    glColor4ubv( purple );
  21.656 -    glVertex3fv( v7 );
  21.657 -
  21.658 -    glColor4ubv( white );
  21.659 -    glVertex3fv( v3 );
  21.660 -    glColor4ubv( blue );
  21.661 -    glVertex3fv( v2 );
  21.662 -    glColor4ubv( orange );
  21.663 -    glVertex3fv( v6 );
  21.664 -
  21.665 -    glColor4ubv( white );
  21.666 -    glVertex3fv( v3 );
  21.667 -    glColor4ubv( orange );
  21.668 -    glVertex3fv( v6 );
  21.669 -    glColor4ubv( purple );
  21.670 -    glVertex3fv( v7 );
  21.671 -
  21.672 -    glColor4ubv( green );
  21.673 -    glVertex3fv( v1 );
  21.674 -    glColor4ubv( red );
  21.675 -    glVertex3fv( v0 );
  21.676 -    glColor4ubv( yellow );
  21.677 -    glVertex3fv( v4 );
  21.678 -
  21.679 -    glColor4ubv( green );
  21.680 -    glVertex3fv( v1 );
  21.681 -    glColor4ubv( yellow );
  21.682 -    glVertex3fv( v4 );
  21.683 -    glColor4ubv( black );
  21.684 -    glVertex3fv( v5 );
  21.685 -
  21.686 -    glEnd( );
  21.687 -
  21.688 -    /*
  21.689 -     * EXERCISE:
  21.690 -     * Draw text telling the user that 'Spc'
  21.691 -     * pauses the rotation and 'Esc' quits.
  21.692 -     * Do it using vetors and textured quads.
  21.693 -     */
  21.694 -
  21.695 -    /*
  21.696 -     * Swap the buffers. This this tells the driver to
  21.697 -     * render the next frame from the contents of the
  21.698 -     * back-buffer, and to set all rendering operations
  21.699 -     * to occur on what was the front-buffer.
  21.700 -     *
  21.701 -     * Double buffering prevents nasty visual tearing
  21.702 -     * from the application drawing on areas of the
  21.703 -     * screen that are being updated at the same time.
  21.704 -     */
  21.705 -    SDL_GL_SwapBuffers( );
  21.706 -}
  21.707 -
  21.708 -static void setup_opengl( int width, int height )
  21.709 -{
  21.710 -    float ratio = (float) width / (float) height;
  21.711 -
  21.712 -    /* Our shading model--Gouraud (smooth). */
  21.713 -    glShadeModel( GL_SMOOTH );
  21.714 -
  21.715 -    /* Culling. */
  21.716 -    glCullFace( GL_BACK );
  21.717 -    glFrontFace( GL_CCW );
  21.718 -    glEnable( GL_CULL_FACE );
  21.719 -
  21.720 -    /* Set the clear color. */
  21.721 -    glClearColor( 0, 0, 0, 0 );
  21.722 -
  21.723 -    /* Setup our viewport. */
  21.724 -    glViewport( 0, 0, width, height );
  21.725 -
  21.726 -    /*
  21.727 -     * Change to the projection matrix and set
  21.728 -     * our viewing volume.
  21.729 -     */
  21.730 -    glMatrixMode( GL_PROJECTION );
  21.731 -    glLoadIdentity( );
  21.732 -    /*
  21.733 -     * EXERCISE:
  21.734 -     * Replace this with a call to glFrustum.
  21.735 -     */
  21.736 -    gluPerspective( 60.0, ratio, 1.0, 1024.0 );
  21.737 -}
  21.738 -
  21.739 -int main( int argc, char* argv[] )
  21.740 -{
  21.741 -    /* Information about the current video settings. */
  21.742 -    const SDL_VideoInfo* info = NULL;
  21.743 -    /* Dimensions of our window. */
  21.744 -    int width = 0;
  21.745 -    int height = 0;
  21.746 -    /* Color depth in bits of our window. */
  21.747 -    int bpp = 0;
  21.748 -    /* Flags we will pass into SDL_SetVideoMode. */
  21.749 -    int flags = 0;
  21.750 -
  21.751 -    /* First, initialize SDL's video subsystem. */
  21.752 -    if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0 ) {
  21.753 -        /* Failed, exit. */
  21.754 -        fprintf( stderr, "Video initialization failed: %s\n",
  21.755 -             SDL_GetError( ) );
  21.756 -        quit_tutorial( 1 );
  21.757 -    }
  21.758 -
  21.759 -    /* Let's get some video information. */
  21.760 -    info = SDL_GetVideoInfo( );
  21.761 -
  21.762 -    if( !info ) {
  21.763 -        /* This should probably never happen. */
  21.764 -        fprintf( stderr, "Video query failed: %s\n",
  21.765 -             SDL_GetError( ) );
  21.766 -        quit_tutorial( 1 );
  21.767 -    }
  21.768 -
  21.769 -    /*
  21.770 -     * Set our width/height to 640/480 (you would
  21.771 -     * of course let the user decide this in a normal
  21.772 -     * app). We get the bpp we will request from
  21.773 -     * the display. On X11, VidMode can't change
  21.774 -     * resolution, so this is probably being overly
  21.775 -     * safe. Under Win32, ChangeDisplaySettings
  21.776 -     * can change the bpp.
  21.777 -     */
  21.778 -    width = 640;
  21.779 -    height = 480;
  21.780 -    bpp = info-&#62;vfmt-&#62;BitsPerPixel;
  21.781 -
  21.782 -    /*
  21.783 -     * Now, we want to setup our requested
  21.784 -     * window attributes for our OpenGL window.
  21.785 -     * We want *at least* 5 bits of red, green
  21.786 -     * and blue. We also want at least a 16-bit
  21.787 -     * depth buffer.
  21.788 -     *
  21.789 -     * The last thing we do is request a double
  21.790 -     * buffered window. '1' turns on double
  21.791 -     * buffering, '0' turns it off.
  21.792 -     *
  21.793 -     * Note that we do not use SDL_DOUBLEBUF in
  21.794 -     * the flags to SDL_SetVideoMode. That does
  21.795 -     * not affect the GL attribute state, only
  21.796 -     * the standard 2D blitting setup.
  21.797 -     */
  21.798 -    SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
  21.799 -    SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
  21.800 -    SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
  21.801 -    SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
  21.802 -    SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
  21.803 -
  21.804 -    /*
  21.805 -     * We want to request that SDL provide us
  21.806 -     * with an OpenGL window, in a fullscreen
  21.807 -     * video mode.
  21.808 -     *
  21.809 -     * EXERCISE:
  21.810 -     * Make starting windowed an option, and
  21.811 -     * handle the resize events properly with
  21.812 -     * glViewport.
  21.813 -     */
  21.814 -    flags = SDL_OPENGL | SDL_FULLSCREEN;
  21.815 -
  21.816 -    /*
  21.817 -     * Set the video mode
  21.818 -     */
  21.819 -    if( SDL_SetVideoMode( width, height, bpp, flags ) == 0 ) {
  21.820 -        /* 
  21.821 -         * This could happen for a variety of reasons,
  21.822 -         * including DISPLAY not being set, the specified
  21.823 -         * resolution not being available, etc.
  21.824 -         */
  21.825 -        fprintf( stderr, "Video mode set failed: %s\n",
  21.826 -             SDL_GetError( ) );
  21.827 -        quit_tutorial( 1 );
  21.828 -    }
  21.829 -
  21.830 -    /*
  21.831 -     * At this point, we should have a properly setup
  21.832 -     * double-buffered window for use with OpenGL.
  21.833 -     */
  21.834 -    setup_opengl( width, height );
  21.835 -
  21.836 -    /*
  21.837 -     * Now we want to begin our normal app process--
  21.838 -     * an event loop with a lot of redrawing.
  21.839 -     */
  21.840 -    while( 1 ) {
  21.841 -        /* Process incoming events. */
  21.842 -        process_events( );
  21.843 -        /* Draw the screen. */
  21.844 -        draw_screen( );
  21.845 -    }
  21.846 -
  21.847 -    /*
  21.848 -     * EXERCISE:
  21.849 -     * Record timings using SDL_GetTicks() and
  21.850 -     * and print out frames per second at program
  21.851 -     * end.
  21.852 -     */
  21.853 -
  21.854 -    /* Never reached. */
  21.855 -    return 0;
  21.856 -}</PRE
  21.857 +    return;&#13;</PRE
  21.858  ></DIV
  21.859  ></DIV
  21.860  ></DIV
  21.861 @@ -674,7 +424,7 @@
  21.862  ALIGN="right"
  21.863  VALIGN="top"
  21.864  ><A
  21.865 -HREF="guideinput.html"
  21.866 +HREF="guidevideoopengl.html"
  21.867  >Next</A
  21.868  ></TD
  21.869  ></TR
  21.870 @@ -696,7 +446,7 @@
  21.871  WIDTH="33%"
  21.872  ALIGN="right"
  21.873  VALIGN="top"
  21.874 ->Input handling</TD
  21.875 +>Using OpenGL With SDL</TD
  21.876  ></TR
  21.877  ></TABLE
  21.878  ></DIV
    22.1 --- a/docs/html/guidevideoexamples.html	Sun Jun 10 18:39:47 2001 +0000
    22.2 +++ b/docs/html/guidevideoexamples.html	Sun Jun 10 19:31:57 2001 +0000
    22.3 @@ -4,7 +4,7 @@
    22.4  >Video Examples</TITLE
    22.5  ><META
    22.6  NAME="GENERATOR"
    22.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    22.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    22.9  "><LINK
   22.10  REL="HOME"
   22.11  TITLE="SDL Library Documentation"
   22.12 @@ -80,7 +80,7 @@
   22.13  ><H2
   22.14  CLASS="SECT2"
   22.15  ><A
   22.16 -NAME="AEN303"
   22.17 +NAME="AEN375"
   22.18  >Initializing the video display</A
   22.19  ></H2
   22.20  ><P
   22.21 @@ -112,7 +112,7 @@
   22.22  ><H2
   22.23  CLASS="SECT2"
   22.24  ><A
   22.25 -NAME="AEN307"
   22.26 +NAME="AEN379"
   22.27  >Initializing the best video mode</A
   22.28  ></H2
   22.29  ><P
   22.30 @@ -134,7 +134,7 @@
   22.31  ><H2
   22.32  CLASS="SECT2"
   22.33  ><A
   22.34 -NAME="AEN311"
   22.35 +NAME="AEN383"
   22.36  >Loading and displaying a BMP file</A
   22.37  ></H2
   22.38  ><P
   22.39 @@ -211,7 +211,7 @@
   22.40  ><H2
   22.41  CLASS="SECT2"
   22.42  ><A
   22.43 -NAME="AEN315"
   22.44 +NAME="AEN387"
   22.45  >Drawing directly to the display</A
   22.46  ></H2
   22.47  ><P
   22.48 @@ -276,7 +276,7 @@
   22.49  ><H2
   22.50  CLASS="SECT2"
   22.51  ><A
   22.52 -NAME="AEN319"
   22.53 +NAME="AEN391"
   22.54  >Fastest possible surface blit</A
   22.55  ></H2
   22.56  ><P
    23.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    23.2 +++ b/docs/html/guidevideoopengl.html	Sun Jun 10 19:31:57 2001 +0000
    23.3 @@ -0,0 +1,719 @@
    23.4 +<HTML
    23.5 +><HEAD
    23.6 +><TITLE
    23.7 +>Using OpenGL With SDL</TITLE
    23.8 +><META
    23.9 +NAME="GENERATOR"
   23.10 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   23.11 +"><LINK
   23.12 +REL="HOME"
   23.13 +TITLE="SDL Library Documentation"
   23.14 +HREF="index.html"><LINK
   23.15 +REL="UP"
   23.16 +TITLE="Graphics and Video"
   23.17 +HREF="guidevideo.html"><LINK
   23.18 +REL="PREVIOUS"
   23.19 +TITLE="Graphics and Video"
   23.20 +HREF="guidevideo.html"><LINK
   23.21 +REL="NEXT"
   23.22 +TITLE="Input handling"
   23.23 +HREF="guideinput.html"></HEAD
   23.24 +><BODY
   23.25 +CLASS="SECT1"
   23.26 +BGCOLOR="#FFF8DC"
   23.27 +TEXT="#000000"
   23.28 +LINK="#0000ee"
   23.29 +VLINK="#551a8b"
   23.30 +ALINK="#ff0000"
   23.31 +><DIV
   23.32 +CLASS="NAVHEADER"
   23.33 +><TABLE
   23.34 +WIDTH="100%"
   23.35 +BORDER="0"
   23.36 +CELLPADDING="0"
   23.37 +CELLSPACING="0"
   23.38 +><TR
   23.39 +><TH
   23.40 +COLSPAN="3"
   23.41 +ALIGN="center"
   23.42 +>SDL Library Documentation</TH
   23.43 +></TR
   23.44 +><TR
   23.45 +><TD
   23.46 +WIDTH="10%"
   23.47 +ALIGN="left"
   23.48 +VALIGN="bottom"
   23.49 +><A
   23.50 +HREF="guidevideo.html"
   23.51 +>Prev</A
   23.52 +></TD
   23.53 +><TD
   23.54 +WIDTH="80%"
   23.55 +ALIGN="center"
   23.56 +VALIGN="bottom"
   23.57 +>Chapter 2. Graphics and Video</TD
   23.58 +><TD
   23.59 +WIDTH="10%"
   23.60 +ALIGN="right"
   23.61 +VALIGN="bottom"
   23.62 +><A
   23.63 +HREF="guideinput.html"
   23.64 +>Next</A
   23.65 +></TD
   23.66 +></TR
   23.67 +></TABLE
   23.68 +><HR
   23.69 +ALIGN="LEFT"
   23.70 +WIDTH="100%"></DIV
   23.71 +><DIV
   23.72 +CLASS="SECT1"
   23.73 +><H1
   23.74 +CLASS="SECT1"
   23.75 +><A
   23.76 +NAME="GUIDEVIDEOOPENGL"
   23.77 +>Using OpenGL With SDL</A
   23.78 +></H1
   23.79 +><P
   23.80 +>SDL has the ability to create and use OpenGL contexts on several platforms(Linux/X11, Win32, BeOS, MacOS Classic/Toolbox, MacOS X, FreeBSD/X11 and Solaris/X11). This allows you to use SDL's audio, event handling, threads and times in your OpenGL applications (a function often performed by GLUT).</P
   23.81 +><DIV
   23.82 +CLASS="SECT2"
   23.83 +><H2
   23.84 +CLASS="SECT2"
   23.85 +><A
   23.86 +NAME="AEN103"
   23.87 +>Initialisation</A
   23.88 +></H2
   23.89 +><P
   23.90 +>Initialising SDL to use OpenGL is not very different to initialising SDL normally. There are three differences; you must pass <TT
   23.91 +CLASS="LITERAL"
   23.92 +>SDL_OPENGL</TT
   23.93 +> to <A
   23.94 +HREF="sdlsetvideomode.html"
   23.95 +><TT
   23.96 +CLASS="FUNCTION"
   23.97 +>SDL_SetVideoMode</TT
   23.98 +></A
   23.99 +>, you must specify several GL attributes (depth buffer size, framebuffer sizes) using <A
  23.100 +HREF="sdlglsetattribute.html"
  23.101 +><TT
  23.102 +CLASS="FUNCTION"
  23.103 +>SDL_GL_SetAttribute</TT
  23.104 +></A
  23.105 +> and finally, if you wish to use double buffering you must specify it as a GL attribute, <I
  23.106 +CLASS="EMPHASIS"
  23.107 +>not</I
  23.108 +> by passing the <TT
  23.109 +CLASS="LITERAL"
  23.110 +>SDL_DOUBLEBUF</TT
  23.111 +> flag to <TT
  23.112 +CLASS="FUNCTION"
  23.113 +>SDL_SetVideoMode</TT
  23.114 +>.</P
  23.115 +><DIV
  23.116 +CLASS="EXAMPLE"
  23.117 +><A
  23.118 +NAME="AEN114"
  23.119 +></A
  23.120 +><P
  23.121 +><B
  23.122 +>Example 2-7. Initializing SDL with OpenGL</B
  23.123 +></P
  23.124 +><PRE
  23.125 +CLASS="PROGRAMLISTING"
  23.126 +>    /* Information about the current video settings. */
  23.127 +    const SDL_VideoInfo* info = NULL;
  23.128 +    /* Dimensions of our window. */
  23.129 +    int width = 0;
  23.130 +    int height = 0;
  23.131 +    /* Color depth in bits of our window. */
  23.132 +    int bpp = 0;
  23.133 +    /* Flags we will pass into SDL_SetVideoMode. */
  23.134 +    int flags = 0;
  23.135 +
  23.136 +    /* First, initialize SDL's video subsystem. */
  23.137 +    if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0 ) {
  23.138 +        /* Failed, exit. */
  23.139 +        fprintf( stderr, "Video initialization failed: %s\n",
  23.140 +             SDL_GetError( ) );
  23.141 +        quit_tutorial( 1 );
  23.142 +    }
  23.143 +
  23.144 +    /* Let's get some video information. */
  23.145 +    info = SDL_GetVideoInfo( );
  23.146 +
  23.147 +    if( !info ) {
  23.148 +        /* This should probably never happen. */
  23.149 +        fprintf( stderr, "Video query failed: %s\n",
  23.150 +             SDL_GetError( ) );
  23.151 +        quit_tutorial( 1 );
  23.152 +    }
  23.153 +
  23.154 +    /*
  23.155 +     * Set our width/height to 640/480 (you would
  23.156 +     * of course let the user decide this in a normal
  23.157 +     * app). We get the bpp we will request from
  23.158 +     * the display. On X11, VidMode can't change
  23.159 +     * resolution, so this is probably being overly
  23.160 +     * safe. Under Win32, ChangeDisplaySettings
  23.161 +     * can change the bpp.
  23.162 +     */
  23.163 +    width = 640;
  23.164 +    height = 480;
  23.165 +    bpp = info-&#62;vfmt-&#62;BitsPerPixel;
  23.166 +
  23.167 +    /*
  23.168 +     * Now, we want to setup our requested
  23.169 +     * window attributes for our OpenGL window.
  23.170 +     * We want *at least* 5 bits of red, green
  23.171 +     * and blue. We also want at least a 16-bit
  23.172 +     * depth buffer.
  23.173 +     *
  23.174 +     * The last thing we do is request a double
  23.175 +     * buffered window. '1' turns on double
  23.176 +     * buffering, '0' turns it off.
  23.177 +     *
  23.178 +     * Note that we do not use SDL_DOUBLEBUF in
  23.179 +     * the flags to SDL_SetVideoMode. That does
  23.180 +     * not affect the GL attribute state, only
  23.181 +     * the standard 2D blitting setup.
  23.182 +     */
  23.183 +    SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
  23.184 +    SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
  23.185 +    SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
  23.186 +    SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
  23.187 +    SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
  23.188 +
  23.189 +    /*
  23.190 +     * We want to request that SDL provide us
  23.191 +     * with an OpenGL window, in a fullscreen
  23.192 +     * video mode.
  23.193 +     *
  23.194 +     * EXERCISE:
  23.195 +     * Make starting windowed an option, and
  23.196 +     * handle the resize events properly with
  23.197 +     * glViewport.
  23.198 +     */
  23.199 +    flags = SDL_OPENGL | SDL_FULLSCREEN;
  23.200 +
  23.201 +    /*
  23.202 +     * Set the video mode
  23.203 +     */
  23.204 +    if( SDL_SetVideoMode( width, height, bpp, flags ) == 0 ) {
  23.205 +        /* 
  23.206 +         * This could happen for a variety of reasons,
  23.207 +         * including DISPLAY not being set, the specified
  23.208 +         * resolution not being available, etc.
  23.209 +         */
  23.210 +        fprintf( stderr, "Video mode set failed: %s\n",
  23.211 +             SDL_GetError( ) );
  23.212 +        quit_tutorial( 1 );
  23.213 +    }</PRE
  23.214 +></DIV
  23.215 +></DIV
  23.216 +><DIV
  23.217 +CLASS="SECT2"
  23.218 +><H2
  23.219 +CLASS="SECT2"
  23.220 +><A
  23.221 +NAME="AEN117"
  23.222 +>Drawing</A
  23.223 +></H2
  23.224 +><P
  23.225 +>Apart from initialisation, using OpenGL within SDL is the same as using OpenGL
  23.226 +with any other API, e.g. GLUT. You still use all the same function calls and
  23.227 +data types. However if you are using a double-buffered display, then you must
  23.228 +use
  23.229 +<A
  23.230 +HREF="sdlglswapbuffers.html"
  23.231 +><TT
  23.232 +CLASS="FUNCTION"
  23.233 +>SDL_GL_SwapBuffers()</TT
  23.234 +></A
  23.235 +>
  23.236 +to swap the buffers and update the display. To request double-buffering
  23.237 +with OpenGL, use
  23.238 +<A
  23.239 +HREF="sdlglsetattribute.html"
  23.240 +><TT
  23.241 +CLASS="FUNCTION"
  23.242 +>SDL_GL_SetAttribute</TT
  23.243 +></A
  23.244 +>
  23.245 +with <TT
  23.246 +CLASS="LITERAL"
  23.247 +>SDL_GL_DOUBLEBUFFER</TT
  23.248 +>, and use
  23.249 +<A
  23.250 +HREF="sdlglgetattribute.html"
  23.251 +><TT
  23.252 +CLASS="FUNCTION"
  23.253 +>SDL_GL_GetAttribute</TT
  23.254 +></A
  23.255 +>
  23.256 +to see if you actually got it.</P
  23.257 +><P
  23.258 +>A full example code listing is now presented below.</P
  23.259 +><DIV
  23.260 +CLASS="EXAMPLE"
  23.261 +><A
  23.262 +NAME="AEN128"
  23.263 +></A
  23.264 +><P
  23.265 +><B
  23.266 +>Example 2-8. SDL and OpenGL</B
  23.267 +></P
  23.268 +><PRE
  23.269 +CLASS="PROGRAMLISTING"
  23.270 +>/*
  23.271 + * SDL OpenGL Tutorial.
  23.272 + * (c) Michael Vance, 2000
  23.273 + * briareos@lokigames.com
  23.274 + *
  23.275 + * Distributed under terms of the LGPL. 
  23.276 + */
  23.277 +
  23.278 +#include &#60;SDL/SDL.h&#62;
  23.279 +#include &#60;GL/gl.h&#62;
  23.280 +#include &#60;GL/glu.h&#62;
  23.281 +
  23.282 +#include &#60;stdio.h&#62;
  23.283 +#include &#60;stdlib.h&#62;
  23.284 +
  23.285 +static GLboolean should_rotate = GL_TRUE;
  23.286 +
  23.287 +static void quit_tutorial( int code )
  23.288 +{
  23.289 +    /*
  23.290 +     * Quit SDL so we can release the fullscreen
  23.291 +     * mode and restore the previous video settings,
  23.292 +     * etc.
  23.293 +     */
  23.294 +    SDL_Quit( );
  23.295 +
  23.296 +    /* Exit program. */
  23.297 +    exit( code );
  23.298 +}
  23.299 +
  23.300 +static void handle_key_down( SDL_keysym* keysym )
  23.301 +{
  23.302 +
  23.303 +    /* 
  23.304 +     * We're only interested if 'Esc' has
  23.305 +     * been presssed.
  23.306 +     *
  23.307 +     * EXERCISE: 
  23.308 +     * Handle the arrow keys and have that change the
  23.309 +     * viewing position/angle.
  23.310 +     */
  23.311 +    switch( keysym-&#62;sym ) {
  23.312 +    case SDLK_ESCAPE:
  23.313 +        quit_tutorial( 0 );
  23.314 +        break;
  23.315 +    case SDLK_SPACE:
  23.316 +        should_rotate = !should_rotate;
  23.317 +        break;
  23.318 +    default:
  23.319 +        break;
  23.320 +    }
  23.321 +
  23.322 +}
  23.323 +
  23.324 +static void process_events( void )
  23.325 +{
  23.326 +    /* Our SDL event placeholder. */
  23.327 +    SDL_Event event;
  23.328 +
  23.329 +    /* Grab all the events off the queue. */
  23.330 +    while( SDL_PollEvent( &#38;event ) ) {
  23.331 +
  23.332 +        switch( event.type ) {
  23.333 +        case SDL_KEYDOWN:
  23.334 +            /* Handle key presses. */
  23.335 +            handle_key_down( &#38;event.key.keysym );
  23.336 +            break;
  23.337 +        case SDL_QUIT:
  23.338 +            /* Handle quit requests (like Ctrl-c). */
  23.339 +            quit_tutorial( 0 );
  23.340 +            break;
  23.341 +        }
  23.342 +
  23.343 +    }
  23.344 +
  23.345 +}
  23.346 +
  23.347 +static void draw_screen( void )
  23.348 +{
  23.349 +    /* Our angle of rotation. */
  23.350 +    static float angle = 0.0f;
  23.351 +
  23.352 +    /*
  23.353 +     * EXERCISE:
  23.354 +     * Replace this awful mess with vertex
  23.355 +     * arrays and a call to glDrawElements.
  23.356 +     *
  23.357 +     * EXERCISE:
  23.358 +     * After completing the above, change
  23.359 +     * it to use compiled vertex arrays.
  23.360 +     *
  23.361 +     * EXERCISE:
  23.362 +     * Verify my windings are correct here ;).
  23.363 +     */
  23.364 +    static GLfloat v0[] = { -1.0f, -1.0f,  1.0f };
  23.365 +    static GLfloat v1[] = {  1.0f, -1.0f,  1.0f };
  23.366 +    static GLfloat v2[] = {  1.0f,  1.0f,  1.0f };
  23.367 +    static GLfloat v3[] = { -1.0f,  1.0f,  1.0f };
  23.368 +    static GLfloat v4[] = { -1.0f, -1.0f, -1.0f };
  23.369 +    static GLfloat v5[] = {  1.0f, -1.0f, -1.0f };
  23.370 +    static GLfloat v6[] = {  1.0f,  1.0f, -1.0f };
  23.371 +    static GLfloat v7[] = { -1.0f,  1.0f, -1.0f };
  23.372 +    static GLubyte red[]    = { 255,   0,   0, 255 };
  23.373 +    static GLubyte green[]  = {   0, 255,   0, 255 };
  23.374 +    static GLubyte blue[]   = {   0,   0, 255, 255 };
  23.375 +    static GLubyte white[]  = { 255, 255, 255, 255 };
  23.376 +    static GLubyte yellow[] = {   0, 255, 255, 255 };
  23.377 +    static GLubyte black[]  = {   0,   0,   0, 255 };
  23.378 +    static GLubyte orange[] = { 255, 255,   0, 255 };
  23.379 +    static GLubyte purple[] = { 255,   0, 255,   0 };
  23.380 +
  23.381 +    /* Clear the color and depth buffers. */
  23.382 +    glClear( GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT );
  23.383 +
  23.384 +    /* We don't want to modify the projection matrix. */
  23.385 +    glMatrixMode( GL_MODELVIEW );
  23.386 +    glLoadIdentity( );
  23.387 +
  23.388 +    /* Move down the z-axis. */
  23.389 +    glTranslatef( 0.0, 0.0, -5.0 );
  23.390 +
  23.391 +    /* Rotate. */
  23.392 +    glRotatef( angle, 0.0, 1.0, 0.0 );
  23.393 +
  23.394 +    if( should_rotate ) {
  23.395 +
  23.396 +        if( ++angle &#62; 360.0f ) {
  23.397 +            angle = 0.0f;
  23.398 +        }
  23.399 +
  23.400 +    }
  23.401 +
  23.402 +    /* Send our triangle data to the pipeline. */
  23.403 +    glBegin( GL_TRIANGLES );
  23.404 +
  23.405 +    glColor4ubv( red );
  23.406 +    glVertex3fv( v0 );
  23.407 +    glColor4ubv( green );
  23.408 +    glVertex3fv( v1 );
  23.409 +    glColor4ubv( blue );
  23.410 +    glVertex3fv( v2 );
  23.411 +
  23.412 +    glColor4ubv( red );
  23.413 +    glVertex3fv( v0 );
  23.414 +    glColor4ubv( blue );
  23.415 +    glVertex3fv( v2 );
  23.416 +    glColor4ubv( white );
  23.417 +    glVertex3fv( v3 );
  23.418 +
  23.419 +    glColor4ubv( green );
  23.420 +    glVertex3fv( v1 );
  23.421 +    glColor4ubv( black );
  23.422 +    glVertex3fv( v5 );
  23.423 +    glColor4ubv( orange );
  23.424 +    glVertex3fv( v6 );
  23.425 +
  23.426 +    glColor4ubv( green );
  23.427 +    glVertex3fv( v1 );
  23.428 +    glColor4ubv( orange );
  23.429 +    glVertex3fv( v6 );
  23.430 +    glColor4ubv( blue );
  23.431 +    glVertex3fv( v2 );
  23.432 +
  23.433 +    glColor4ubv( black );
  23.434 +    glVertex3fv( v5 );
  23.435 +    glColor4ubv( yellow );
  23.436 +    glVertex3fv( v4 );
  23.437 +    glColor4ubv( purple );
  23.438 +    glVertex3fv( v7 );
  23.439 +
  23.440 +    glColor4ubv( black );
  23.441 +    glVertex3fv( v5 );
  23.442 +    glColor4ubv( purple );
  23.443 +    glVertex3fv( v7 );
  23.444 +    glColor4ubv( orange );
  23.445 +    glVertex3fv( v6 );
  23.446 +
  23.447 +    glColor4ubv( yellow );
  23.448 +    glVertex3fv( v4 );
  23.449 +    glColor4ubv( red );
  23.450 +    glVertex3fv( v0 );
  23.451 +    glColor4ubv( white );
  23.452 +    glVertex3fv( v3 );
  23.453 +
  23.454 +    glColor4ubv( yellow );
  23.455 +    glVertex3fv( v4 );
  23.456 +    glColor4ubv( white );
  23.457 +    glVertex3fv( v3 );
  23.458 +    glColor4ubv( purple );
  23.459 +    glVertex3fv( v7 );
  23.460 +
  23.461 +    glColor4ubv( white );
  23.462 +    glVertex3fv( v3 );
  23.463 +    glColor4ubv( blue );
  23.464 +    glVertex3fv( v2 );
  23.465 +    glColor4ubv( orange );
  23.466 +    glVertex3fv( v6 );
  23.467 +
  23.468 +    glColor4ubv( white );
  23.469 +    glVertex3fv( v3 );
  23.470 +    glColor4ubv( orange );
  23.471 +    glVertex3fv( v6 );
  23.472 +    glColor4ubv( purple );
  23.473 +    glVertex3fv( v7 );
  23.474 +
  23.475 +    glColor4ubv( green );
  23.476 +    glVertex3fv( v1 );
  23.477 +    glColor4ubv( red );
  23.478 +    glVertex3fv( v0 );
  23.479 +    glColor4ubv( yellow );
  23.480 +    glVertex3fv( v4 );
  23.481 +
  23.482 +    glColor4ubv( green );
  23.483 +    glVertex3fv( v1 );
  23.484 +    glColor4ubv( yellow );
  23.485 +    glVertex3fv( v4 );
  23.486 +    glColor4ubv( black );
  23.487 +    glVertex3fv( v5 );
  23.488 +
  23.489 +    glEnd( );
  23.490 +
  23.491 +    /*
  23.492 +     * EXERCISE:
  23.493 +     * Draw text telling the user that 'Spc'
  23.494 +     * pauses the rotation and 'Esc' quits.
  23.495 +     * Do it using vetors and textured quads.
  23.496 +     */
  23.497 +
  23.498 +    /*
  23.499 +     * Swap the buffers. This this tells the driver to
  23.500 +     * render the next frame from the contents of the
  23.501 +     * back-buffer, and to set all rendering operations
  23.502 +     * to occur on what was the front-buffer.
  23.503 +     *
  23.504 +     * Double buffering prevents nasty visual tearing
  23.505 +     * from the application drawing on areas of the
  23.506 +     * screen that are being updated at the same time.
  23.507 +     */
  23.508 +    SDL_GL_SwapBuffers( );
  23.509 +}
  23.510 +
  23.511 +static void setup_opengl( int width, int height )
  23.512 +{
  23.513 +    float ratio = (float) width / (float) height;
  23.514 +
  23.515 +    /* Our shading model--Gouraud (smooth). */
  23.516 +    glShadeModel( GL_SMOOTH );
  23.517 +
  23.518 +    /* Culling. */
  23.519 +    glCullFace( GL_BACK );
  23.520 +    glFrontFace( GL_CCW );
  23.521 +    glEnable( GL_CULL_FACE );
  23.522 +
  23.523 +    /* Set the clear color. */
  23.524 +    glClearColor( 0, 0, 0, 0 );
  23.525 +
  23.526 +    /* Setup our viewport. */
  23.527 +    glViewport( 0, 0, width, height );
  23.528 +
  23.529 +    /*
  23.530 +     * Change to the projection matrix and set
  23.531 +     * our viewing volume.
  23.532 +     */
  23.533 +    glMatrixMode( GL_PROJECTION );
  23.534 +    glLoadIdentity( );
  23.535 +    /*
  23.536 +     * EXERCISE:
  23.537 +     * Replace this with a call to glFrustum.
  23.538 +     */
  23.539 +    gluPerspective( 60.0, ratio, 1.0, 1024.0 );
  23.540 +}
  23.541 +
  23.542 +int main( int argc, char* argv[] )
  23.543 +{
  23.544 +    /* Information about the current video settings. */
  23.545 +    const SDL_VideoInfo* info = NULL;
  23.546 +    /* Dimensions of our window. */
  23.547 +    int width = 0;
  23.548 +    int height = 0;
  23.549 +    /* Color depth in bits of our window. */
  23.550 +    int bpp = 0;
  23.551 +    /* Flags we will pass into SDL_SetVideoMode. */
  23.552 +    int flags = 0;
  23.553 +
  23.554 +    /* First, initialize SDL's video subsystem. */
  23.555 +    if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0 ) {
  23.556 +        /* Failed, exit. */
  23.557 +        fprintf( stderr, "Video initialization failed: %s\n",
  23.558 +             SDL_GetError( ) );
  23.559 +        quit_tutorial( 1 );
  23.560 +    }
  23.561 +
  23.562 +    /* Let's get some video information. */
  23.563 +    info = SDL_GetVideoInfo( );
  23.564 +
  23.565 +    if( !info ) {
  23.566 +        /* This should probably never happen. */
  23.567 +        fprintf( stderr, "Video query failed: %s\n",
  23.568 +             SDL_GetError( ) );
  23.569 +        quit_tutorial( 1 );
  23.570 +    }
  23.571 +
  23.572 +    /*
  23.573 +     * Set our width/height to 640/480 (you would
  23.574 +     * of course let the user decide this in a normal
  23.575 +     * app). We get the bpp we will request from
  23.576 +     * the display. On X11, VidMode can't change
  23.577 +     * resolution, so this is probably being overly
  23.578 +     * safe. Under Win32, ChangeDisplaySettings
  23.579 +     * can change the bpp.
  23.580 +     */
  23.581 +    width = 640;
  23.582 +    height = 480;
  23.583 +    bpp = info-&#62;vfmt-&#62;BitsPerPixel;
  23.584 +
  23.585 +    /*
  23.586 +     * Now, we want to setup our requested
  23.587 +     * window attributes for our OpenGL window.
  23.588 +     * We want *at least* 5 bits of red, green
  23.589 +     * and blue. We also want at least a 16-bit
  23.590 +     * depth buffer.
  23.591 +     *
  23.592 +     * The last thing we do is request a double
  23.593 +     * buffered window. '1' turns on double
  23.594 +     * buffering, '0' turns it off.
  23.595 +     *
  23.596 +     * Note that we do not use SDL_DOUBLEBUF in
  23.597 +     * the flags to SDL_SetVideoMode. That does
  23.598 +     * not affect the GL attribute state, only
  23.599 +     * the standard 2D blitting setup.
  23.600 +     */
  23.601 +    SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
  23.602 +    SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
  23.603 +    SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
  23.604 +    SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
  23.605 +    SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
  23.606 +
  23.607 +    /*
  23.608 +     * We want to request that SDL provide us
  23.609 +     * with an OpenGL window, in a fullscreen
  23.610 +     * video mode.
  23.611 +     *
  23.612 +     * EXERCISE:
  23.613 +     * Make starting windowed an option, and
  23.614 +     * handle the resize events properly with
  23.615 +     * glViewport.
  23.616 +     */
  23.617 +    flags = SDL_OPENGL | SDL_FULLSCREEN;
  23.618 +
  23.619 +    /*
  23.620 +     * Set the video mode
  23.621 +     */
  23.622 +    if( SDL_SetVideoMode( width, height, bpp, flags ) == 0 ) {
  23.623 +        /* 
  23.624 +         * This could happen for a variety of reasons,
  23.625 +         * including DISPLAY not being set, the specified
  23.626 +         * resolution not being available, etc.
  23.627 +         */
  23.628 +        fprintf( stderr, "Video mode set failed: %s\n",
  23.629 +             SDL_GetError( ) );
  23.630 +        quit_tutorial( 1 );
  23.631 +    }
  23.632 +
  23.633 +    /*
  23.634 +     * At this point, we should have a properly setup
  23.635 +     * double-buffered window for use with OpenGL.
  23.636 +     */
  23.637 +    setup_opengl( width, height );
  23.638 +
  23.639 +    /*
  23.640 +     * Now we want to begin our normal app process--
  23.641 +     * an event loop with a lot of redrawing.
  23.642 +     */
  23.643 +    while( 1 ) {
  23.644 +        /* Process incoming events. */
  23.645 +        process_events( );
  23.646 +        /* Draw the screen. */
  23.647 +        draw_screen( );
  23.648 +    }
  23.649 +
  23.650 +    /*
  23.651 +     * EXERCISE:
  23.652 +     * Record timings using SDL_GetTicks() and
  23.653 +     * and print out frames per second at program
  23.654 +     * end.
  23.655 +     */
  23.656 +
  23.657 +    /* Never reached. */
  23.658 +    return 0;
  23.659 +}</PRE
  23.660 +></DIV
  23.661 +></DIV
  23.662 +></DIV
  23.663 +><DIV
  23.664 +CLASS="NAVFOOTER"
  23.665 +><HR
  23.666 +ALIGN="LEFT"
  23.667 +WIDTH="100%"><TABLE
  23.668 +WIDTH="100%"
  23.669 +BORDER="0"
  23.670 +CELLPADDING="0"
  23.671 +CELLSPACING="0"
  23.672 +><TR
  23.673 +><TD
  23.674 +WIDTH="33%"
  23.675 +ALIGN="left"
  23.676 +VALIGN="top"
  23.677 +><A
  23.678 +HREF="guidevideo.html"
  23.679 +>Prev</A
  23.680 +></TD
  23.681 +><TD
  23.682 +WIDTH="34%"
  23.683 +ALIGN="center"
  23.684 +VALIGN="top"
  23.685 +><A
  23.686 +HREF="index.html"
  23.687 +>Home</A
  23.688 +></TD
  23.689 +><TD
  23.690 +WIDTH="33%"
  23.691 +ALIGN="right"
  23.692 +VALIGN="top"
  23.693 +><A
  23.694 +HREF="guideinput.html"
  23.695 +>Next</A
  23.696 +></TD
  23.697 +></TR
  23.698 +><TR
  23.699 +><TD
  23.700 +WIDTH="33%"
  23.701 +ALIGN="left"
  23.702 +VALIGN="top"
  23.703 +>Graphics and Video</TD
  23.704 +><TD
  23.705 +WIDTH="34%"
  23.706 +ALIGN="center"
  23.707 +VALIGN="top"
  23.708 +><A
  23.709 +HREF="guidevideo.html"
  23.710 +>Up</A
  23.711 +></TD
  23.712 +><TD
  23.713 +WIDTH="33%"
  23.714 +ALIGN="right"
  23.715 +VALIGN="top"
  23.716 +>Input handling</TD
  23.717 +></TR
  23.718 +></TABLE
  23.719 +></DIV
  23.720 +></BODY
  23.721 +></HTML
  23.722 +>
  23.723 \ No newline at end of file
    24.1 --- a/docs/html/index.html	Sun Jun 10 18:39:47 2001 +0000
    24.2 +++ b/docs/html/index.html	Sun Jun 10 19:31:57 2001 +0000
    24.3 @@ -4,7 +4,7 @@
    24.4  ></TITLE
    24.5  ><META
    24.6  NAME="GENERATOR"
    24.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    24.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    24.9  "><LINK
   24.10  REL="NEXT"
   24.11  TITLE="SDL Guide"
   24.12 @@ -87,7 +87,12 @@
   24.13  ><DL
   24.14  ><DT
   24.15  ><A
   24.16 -HREF="guidevideo.html#GUIDEVIDEOOPENGL"
   24.17 +HREF="guidevideo.html#GUIDEVIDEOINTRO"
   24.18 +>Introduction to SDL Video</A
   24.19 +></DT
   24.20 +><DT
   24.21 +><A
   24.22 +HREF="guidevideoopengl.html"
   24.23  >Using OpenGL With SDL</A
   24.24  ></DT
   24.25  ></DL
   24.26 @@ -120,16 +125,11 @@
   24.27  ><DL
   24.28  ><DT
   24.29  ><A
   24.30 -HREF="guideexamples.html#AEN297"
   24.31 +HREF="guideexamples.html#AEN369"
   24.32  >Introduction</A
   24.33  ></DT
   24.34  ><DT
   24.35  ><A
   24.36 -HREF="guidevideoexamples.html"
   24.37 ->Video Examples</A
   24.38 -></DT
   24.39 -><DT
   24.40 -><A
   24.41  HREF="guideeventexamples.html"
   24.42  >Event Examples</A
   24.43  ></DT
   24.44 @@ -305,7 +305,7 @@
   24.45  ><A
   24.46  HREF="sdlfreesurface.html"
   24.47  >SDL_FreeSurface</A
   24.48 -> &#8212; Frees (deletes) and SDL_Surface</DT
   24.49 +> &#8212; Frees (deletes) a SDL_Surface</DT
   24.50  ><DT
   24.51  ><A
   24.52  HREF="sdllocksurface.html"
   24.53 @@ -542,7 +542,7 @@
   24.54  ><DL
   24.55  ><DT
   24.56  ><A
   24.57 -HREF="event.html#AEN3194"
   24.58 +HREF="event.html#AEN3269"
   24.59  >Introduction</A
   24.60  ></DT
   24.61  ><DT
   24.62 @@ -965,7 +965,7 @@
   24.63  ></DT
   24.64  ><DT
   24.65  >8-1. <A
   24.66 -HREF="sdlkey.html#AEN4177"
   24.67 +HREF="sdlkey.html#AEN4252"
   24.68  >SDL Keysym definitions</A
   24.69  ></DT
   24.70  ><DT
   24.71 @@ -984,14 +984,109 @@
   24.72  >List of Examples</B
   24.73  ></DT
   24.74  ><DT
   24.75 +>1-1. <A
   24.76 +HREF="guidebasicsinit.html#AEN60"
   24.77 +>Initializing SDL</A
   24.78 +></DT
   24.79 +><DT
   24.80  >2-1. <A
   24.81 -HREF="guidevideo.html#AEN87"
   24.82 ->gl.c - SDL OpenGL Example</A
   24.83 +HREF="guidevideo.html#AEN71"
   24.84 +>Initializing the Video Display</A
   24.85 +></DT
   24.86 +><DT
   24.87 +>2-2. <A
   24.88 +HREF="guidevideo.html#AEN77"
   24.89 +>Initializing the Best Video Mode</A
   24.90 +></DT
   24.91 +><DT
   24.92 +>2-3. <A
   24.93 +HREF="guidevideo.html#AEN83"
   24.94 +>Loading and Displaying a BMP File</A
   24.95 +></DT
   24.96 +><DT
   24.97 +>2-4. <A
   24.98 +HREF="guidevideo.html#AEN90"
   24.99 +>getpixel()</A
  24.100 +></DT
  24.101 +><DT
  24.102 +>2-5. <A
  24.103 +HREF="guidevideo.html#AEN93"
  24.104 +>putpixel()</A
  24.105 +></DT
  24.106 +><DT
  24.107 +>2-6. <A
  24.108 +HREF="guidevideo.html#AEN97"
  24.109 +>Using putpixel()</A
  24.110 +></DT
  24.111 +><DT
  24.112 +>2-7. <A
  24.113 +HREF="guidevideoopengl.html#AEN114"
  24.114 +>Initializing SDL with OpenGL</A
  24.115 +></DT
  24.116 +><DT
  24.117 +>2-8. <A
  24.118 +HREF="guidevideoopengl.html#AEN128"
  24.119 +>SDL and OpenGL</A
  24.120  ></DT
  24.121  ><DT
  24.122  >3-1. <A
  24.123 -HREF="guideinputkeyboard.html#AEN282"
  24.124 ->keys.c - Key event information</A
  24.125 +HREF="guideinput.html#AEN141"
  24.126 +>Initializing SDL with Joystick Support</A
  24.127 +></DT
  24.128 +><DT
  24.129 +>3-2. <A
  24.130 +HREF="guideinput.html#AEN154"
  24.131 +>Querying the Number of Available Joysticks</A
  24.132 +></DT
  24.133 +><DT
  24.134 +>3-3. <A
  24.135 +HREF="guideinput.html#AEN183"
  24.136 +>Opening a Joystick</A
  24.137 +></DT
  24.138 +><DT
  24.139 +>3-4. <A
  24.140 +HREF="guideinput.html#AEN191"
  24.141 +>Joystick Axis Events</A
  24.142 +></DT
  24.143 +><DT
  24.144 +>3-5. <A
  24.145 +HREF="guideinput.html#AEN195"
  24.146 +>More Joystick Axis Events</A
  24.147 +></DT
  24.148 +><DT
  24.149 +>3-6. <A
  24.150 +HREF="guideinput.html#AEN203"
  24.151 +>Joystick Button Events</A
  24.152 +></DT
  24.153 +><DT
  24.154 +>3-7. <A
  24.155 +HREF="guideinput.html#AEN217"
  24.156 +>Joystick Ball Events</A
  24.157 +></DT
  24.158 +><DT
  24.159 +>3-8. <A
  24.160 +HREF="guideinput.html#AEN244"
  24.161 +>Joystick Hat Events</A
  24.162 +></DT
  24.163 +><DT
  24.164 +>3-9. <A
  24.165 +HREF="guideinput.html#AEN265"
  24.166 +>Querying Joystick Characteristics</A
  24.167 +></DT
  24.168 +><DT
  24.169 +>3-10. <A
  24.170 +HREF="guideinputkeyboard.html#AEN334"
  24.171 +>Reading Keyboard Events</A
  24.172 +></DT
  24.173 +><DT
  24.174 +>3-11. <A
  24.175 +HREF="guideinputkeyboard.html#AEN351"
  24.176 +>Interpreting Key Event Information</A
  24.177 +></DT
  24.178 +><DT
  24.179 +>3-12. <A
  24.180 +HREF="guideinputkeyboard.html#AEN363"
  24.181 +>Proper Game Movement</A
  24.182  ></DT
  24.183  ></DL
  24.184  ></DIV
    25.1 --- a/docs/html/joystick.html	Sun Jun 10 18:39:47 2001 +0000
    25.2 +++ b/docs/html/joystick.html	Sun Jun 10 19:31:57 2001 +0000
    25.3 @@ -4,7 +4,7 @@
    25.4  >Joystick</TITLE
    25.5  ><META
    25.6  NAME="GENERATOR"
    25.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    25.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    25.9  "><LINK
   25.10  REL="HOME"
   25.11  TITLE="SDL Library Documentation"
    26.1 --- a/docs/html/reference.html	Sun Jun 10 18:39:47 2001 +0000
    26.2 +++ b/docs/html/reference.html	Sun Jun 10 19:31:57 2001 +0000
    26.3 @@ -4,7 +4,7 @@
    26.4  >SDL Reference</TITLE
    26.5  ><META
    26.6  NAME="GENERATOR"
    26.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    26.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    26.9  "><LINK
   26.10  REL="HOME"
   26.11  TITLE="SDL Library Documentation"
    27.1 --- a/docs/html/sdlactiveevent.html	Sun Jun 10 18:39:47 2001 +0000
    27.2 +++ b/docs/html/sdlactiveevent.html	Sun Jun 10 19:31:57 2001 +0000
    27.3 @@ -4,7 +4,7 @@
    27.4  >SDL_ActiveEvent</TITLE
    27.5  ><META
    27.6  NAME="GENERATOR"
    27.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    27.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    27.9  "><LINK
   27.10  REL="HOME"
   27.11  TITLE="SDL Library Documentation"
   27.12 @@ -73,7 +73,7 @@
   27.13  ><DIV
   27.14  CLASS="REFNAMEDIV"
   27.15  ><A
   27.16 -NAME="AEN3447"
   27.17 +NAME="AEN3522"
   27.18  ></A
   27.19  ><H2
   27.20  >Name</H2
   27.21 @@ -81,7 +81,7 @@
   27.22  ><DIV
   27.23  CLASS="REFSECT1"
   27.24  ><A
   27.25 -NAME="AEN3450"
   27.26 +NAME="AEN3525"
   27.27  ></A
   27.28  ><H2
   27.29  >Structure Definition</H2
   27.30 @@ -96,14 +96,14 @@
   27.31  ><DIV
   27.32  CLASS="REFSECT1"
   27.33  ><A
   27.34 -NAME="AEN3453"
   27.35 +NAME="AEN3528"
   27.36  ></A
   27.37  ><H2
   27.38  >Structure Data</H2
   27.39  ><DIV
   27.40  CLASS="INFORMALTABLE"
   27.41  ><A
   27.42 -NAME="AEN3455"
   27.43 +NAME="AEN3530"
   27.44  ></A
   27.45  ><P
   27.46  ></P
   27.47 @@ -187,7 +187,7 @@
   27.48  ><DIV
   27.49  CLASS="REFSECT1"
   27.50  ><A
   27.51 -NAME="AEN3476"
   27.52 +NAME="AEN3551"
   27.53  ></A
   27.54  ><H2
   27.55  >Description</H2
   27.56 @@ -245,7 +245,7 @@
   27.57  ><DIV
   27.58  CLASS="REFSECT1"
   27.59  ><A
   27.60 -NAME="AEN3492"
   27.61 +NAME="AEN3567"
   27.62  ></A
   27.63  ><H2
   27.64  >See Also</H2
    28.1 --- a/docs/html/sdladdtimer.html	Sun Jun 10 18:39:47 2001 +0000
    28.2 +++ b/docs/html/sdladdtimer.html	Sun Jun 10 19:31:57 2001 +0000
    28.3 @@ -4,7 +4,7 @@
    28.4  >SDL_AddTimer</TITLE
    28.5  ><META
    28.6  NAME="GENERATOR"
    28.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    28.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    28.9  "><LINK
   28.10  REL="HOME"
   28.11  TITLE="SDL Library Documentation"
   28.12 @@ -73,7 +73,7 @@
   28.13  ><DIV
   28.14  CLASS="REFNAMEDIV"
   28.15  ><A
   28.16 -NAME="AEN7854"
   28.17 +NAME="AEN7933"
   28.18  ></A
   28.19  ><H2
   28.20  >Name</H2
   28.21 @@ -82,14 +82,14 @@
   28.22  ><DIV
   28.23  CLASS="REFSYNOPSISDIV"
   28.24  ><A
   28.25 -NAME="AEN7857"
   28.26 +NAME="AEN7936"
   28.27  ></A
   28.28  ><H2
   28.29  >Synopsis</H2
   28.30  ><DIV
   28.31  CLASS="FUNCSYNOPSIS"
   28.32  ><A
   28.33 -NAME="AEN7858"
   28.34 +NAME="AEN7937"
   28.35  ></A
   28.36  ><P
   28.37  ></P
   28.38 @@ -125,7 +125,7 @@
   28.39  ><DIV
   28.40  CLASS="REFSECT1"
   28.41  ><A
   28.42 -NAME="AEN7867"
   28.43 +NAME="AEN7946"
   28.44  ></A
   28.45  ><H2
   28.46  >Description</H2
   28.47 @@ -153,9 +153,15 @@
   28.48  >.</P
   28.49  ><P
   28.50  >The timer callback function may run in a different thread than your
   28.51 -main program, and so shouldn't call any functions from within itself.</P
   28.52 +main program, and so shouldn't call any functions from within itself.
   28.53 +You may always call <A
   28.54 +HREF="sdlpushevent.html"
   28.55 +>SDL_PushEvent</A
   28.56 +>, however.</P
   28.57  ><P
   28.58 ->The maximum resolution of this timer is 10 ms, which means that if
   28.59 +>The granularity of the timer is platform-dependent, but you should count
   28.60 +on it being at least 10 ms as this is the most common number.
   28.61 +This means that if
   28.62  you request a 16 ms timer, your callback will run approximately 20 ms
   28.63  later on an unloaded system.  If you wanted to set a flag signaling
   28.64  a frame update at 30 frames per second (every 33 ms), you might set a
   28.65 @@ -173,7 +179,7 @@
   28.66  ><DIV
   28.67  CLASS="REFSECT1"
   28.68  ><A
   28.69 -NAME="AEN7878"
   28.70 +NAME="AEN7958"
   28.71  ></A
   28.72  ><H2
   28.73  >Return Value</H2
   28.74 @@ -187,7 +193,7 @@
   28.75  ><DIV
   28.76  CLASS="REFSECT1"
   28.77  ><A
   28.78 -NAME="AEN7882"
   28.79 +NAME="AEN7962"
   28.80  ></A
   28.81  ><H2
   28.82  >Examples</H2
   28.83 @@ -200,7 +206,7 @@
   28.84  ><DIV
   28.85  CLASS="REFSECT1"
   28.86  ><A
   28.87 -NAME="AEN7886"
   28.88 +NAME="AEN7966"
   28.89  ></A
   28.90  ><H2
   28.91  >See Also</H2
   28.92 @@ -211,6 +217,13 @@
   28.93  CLASS="FUNCTION"
   28.94  >SDL_RemoveTimer</TT
   28.95  ></A
   28.96 +>,
   28.97 +<A
   28.98 +HREF="sdlpushevent.html"
   28.99 +><TT
  28.100 +CLASS="FUNCTION"
  28.101 +>SDL_PushEvent</TT
  28.102 +></A
  28.103  ></P
  28.104  ></DIV
  28.105  ><DIV
    29.1 --- a/docs/html/sdlaudiocvt.html	Sun Jun 10 18:39:47 2001 +0000
    29.2 +++ b/docs/html/sdlaudiocvt.html	Sun Jun 10 19:31:57 2001 +0000
    29.3 @@ -4,7 +4,7 @@
    29.4  >SDL_AudioCVT</TITLE
    29.5  ><META
    29.6  NAME="GENERATOR"
    29.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    29.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    29.9  "><LINK
   29.10  REL="HOME"
   29.11  TITLE="SDL Library Documentation"
   29.12 @@ -73,7 +73,7 @@
   29.13  ><DIV
   29.14  CLASS="REFNAMEDIV"
   29.15  ><A
   29.16 -NAME="AEN6262"
   29.17 +NAME="AEN6337"
   29.18  ></A
   29.19  ><H2
   29.20  >Name</H2
   29.21 @@ -81,7 +81,7 @@
   29.22  ><DIV
   29.23  CLASS="REFSECT1"
   29.24  ><A
   29.25 -NAME="AEN6265"
   29.26 +NAME="AEN6340"
   29.27  ></A
   29.28  ><H2
   29.29  >Structure Definition</H2
   29.30 @@ -104,14 +104,14 @@
   29.31  ><DIV
   29.32  CLASS="REFSECT1"
   29.33  ><A
   29.34 -NAME="AEN6268"
   29.35 +NAME="AEN6343"
   29.36  ></A
   29.37  ><H2
   29.38  >Structure Data</H2
   29.39  ><DIV
   29.40  CLASS="INFORMALTABLE"
   29.41  ><A
   29.42 -NAME="AEN6270"
   29.43 +NAME="AEN6345"
   29.44  ></A
   29.45  ><P
   29.46  ></P
   29.47 @@ -318,7 +318,7 @@
   29.48  ><DIV
   29.49  CLASS="REFSECT1"
   29.50  ><A
   29.51 -NAME="AEN6322"
   29.52 +NAME="AEN6397"
   29.53  ></A
   29.54  ><H2
   29.55  >Description</H2
   29.56 @@ -459,7 +459,7 @@
   29.57  ><DIV
   29.58  CLASS="REFSECT1"
   29.59  ><A
   29.60 -NAME="AEN6367"
   29.61 +NAME="AEN6442"
   29.62  ></A
   29.63  ><H2
   29.64  >See Also</H2
    30.1 --- a/docs/html/sdlaudiospec.html	Sun Jun 10 18:39:47 2001 +0000
    30.2 +++ b/docs/html/sdlaudiospec.html	Sun Jun 10 19:31:57 2001 +0000
    30.3 @@ -4,7 +4,7 @@
    30.4  >SDL_AudioSpec</TITLE
    30.5  ><META
    30.6  NAME="GENERATOR"
    30.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    30.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    30.9  "><LINK
   30.10  REL="HOME"
   30.11  TITLE="SDL Library Documentation"
   30.12 @@ -73,7 +73,7 @@
   30.13  ><DIV
   30.14  CLASS="REFNAMEDIV"
   30.15  ><A
   30.16 -NAME="AEN5885"
   30.17 +NAME="AEN5960"
   30.18  ></A
   30.19  ><H2
   30.20  >Name</H2
   30.21 @@ -81,7 +81,7 @@
   30.22  ><DIV
   30.23  CLASS="REFSECT1"
   30.24  ><A
   30.25 -NAME="AEN5888"
   30.26 +NAME="AEN5963"
   30.27  ></A
   30.28  ><H2
   30.29  >Structure Definition</H2
   30.30 @@ -101,14 +101,14 @@
   30.31  ><DIV
   30.32  CLASS="REFSECT1"
   30.33  ><A
   30.34 -NAME="AEN5891"
   30.35 +NAME="AEN5966"
   30.36  ></A
   30.37  ><H2
   30.38  >Structure Data</H2
   30.39  ><DIV
   30.40  CLASS="INFORMALTABLE"
   30.41  ><A
   30.42 -NAME="AEN5893"
   30.43 +NAME="AEN5968"
   30.44  ></A
   30.45  ><P
   30.46  ></P
   30.47 @@ -245,7 +245,7 @@
   30.48  ><DIV
   30.49  CLASS="REFSECT1"
   30.50  ><A
   30.51 -NAME="AEN5928"
   30.52 +NAME="AEN6003"
   30.53  ></A
   30.54  ><H2
   30.55  >Description</H2
   30.56 @@ -295,7 +295,7 @@
   30.57  ><DIV
   30.58  CLASS="INFORMALTABLE"
   30.59  ><A
   30.60 -NAME="AEN5942"
   30.61 +NAME="AEN6017"
   30.62  ></A
   30.63  ><P
   30.64  ></P
   30.65 @@ -499,7 +499,7 @@
   30.66  ><DIV
   30.67  CLASS="REFSECT1"
   30.68  ><A
   30.69 -NAME="AEN6017"
   30.70 +NAME="AEN6092"
   30.71  ></A
   30.72  ><H2
   30.73  >See Also</H2
    31.1 --- a/docs/html/sdlblitsurface.html	Sun Jun 10 18:39:47 2001 +0000
    31.2 +++ b/docs/html/sdlblitsurface.html	Sun Jun 10 19:31:57 2001 +0000
    31.3 @@ -4,7 +4,7 @@
    31.4  >SDL_BlitSurface</TITLE
    31.5  ><META
    31.6  NAME="GENERATOR"
    31.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    31.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    31.9  "><LINK
   31.10  REL="HOME"
   31.11  TITLE="SDL Library Documentation"
   31.12 @@ -73,7 +73,7 @@
   31.13  ><DIV
   31.14  CLASS="REFNAMEDIV"
   31.15  ><A
   31.16 -NAME="AEN1806"
   31.17 +NAME="AEN1883"
   31.18  ></A
   31.19  ><H2
   31.20  >Name</H2
   31.21 @@ -81,14 +81,14 @@
   31.22  ><DIV
   31.23  CLASS="REFSYNOPSISDIV"
   31.24  ><A
   31.25 -NAME="AEN1809"
   31.26 +NAME="AEN1886"
   31.27  ></A
   31.28  ><H2
   31.29  >Synopsis</H2
   31.30  ><DIV
   31.31  CLASS="FUNCSYNOPSIS"
   31.32  ><A
   31.33 -NAME="AEN1810"
   31.34 +NAME="AEN1887"
   31.35  ></A
   31.36  ><P
   31.37  ></P
   31.38 @@ -112,7 +112,7 @@
   31.39  ><DIV
   31.40  CLASS="REFSECT1"
   31.41  ><A
   31.42 -NAME="AEN1816"
   31.43 +NAME="AEN1893"
   31.44  ></A
   31.45  ><H2
   31.46  >Description</H2
   31.47 @@ -170,27 +170,37 @@
   31.48  > is not modified).</P
   31.49  ><P
   31.50  >The blit function should not be called on a locked surface.</P
   31.51 -><DIV
   31.52 -CLASS="NOTE"
   31.53 -><BLOCKQUOTE
   31.54 -CLASS="NOTE"
   31.55  ><P
   31.56 -><B
   31.57 ->Note: </B
   31.58  >The results of blitting operations vary greatly depending on whether <TT
   31.59  CLASS="LITERAL"
   31.60  >SDL_SRCAPLHA</TT
   31.61  > is set or not. See <A
   31.62  HREF="sdlsetalpha.html"
   31.63  >SDL_SetAlpha</A
   31.64 ->.</P
   31.65 -></BLOCKQUOTE
   31.66 -></DIV
   31.67 +> 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.
   31.68 +<PRE
   31.69 +CLASS="PROGRAMLISTING"
   31.70 +>if (source surface has SDL_SRCALPHA set) {
   31.71 +    if (source surface has alpha channel (that is, format-&#62;Amask != 0))
   31.72 +        blit using per-pixel alpha, ignoring any colour key
   31.73 +    else {
   31.74 +        if (source surface has SDL_SRCCOLORKEY set)
   31.75 +            blit using the colour key AND the per-surface alpha value
   31.76 +        else
   31.77 +            blit using the per-surface alpha value
   31.78 +    }
   31.79 +} else {
   31.80 +    if (source surface has SDL_SRCCOLORKEY set)
   31.81 +        blit using the colour key
   31.82 +    else
   31.83 +        ordinary opaque rectangular blit
   31.84 +}</PRE
   31.85 +></P
   31.86  ></DIV
   31.87  ><DIV
   31.88  CLASS="REFSECT1"
   31.89  ><A
   31.90 -NAME="AEN1835"
   31.91 +NAME="AEN1912"
   31.92  ></A
   31.93  ><H2
   31.94  >Return Value</H2
   31.95 @@ -226,7 +236,7 @@
   31.96  ><DIV
   31.97  CLASS="REFSECT1"
   31.98  ><A
   31.99 -NAME="AEN1843"
  31.100 +NAME="AEN1920"
  31.101  ></A
  31.102  ><H2
  31.103  >See Also</H2
    32.1 --- a/docs/html/sdlbuildaudiocvt.html	Sun Jun 10 18:39:47 2001 +0000
    32.2 +++ b/docs/html/sdlbuildaudiocvt.html	Sun Jun 10 19:31:57 2001 +0000
    32.3 @@ -4,7 +4,7 @@
    32.4  >SDL_BuildAudioCVT</TITLE
    32.5  ><META
    32.6  NAME="GENERATOR"
    32.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    32.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    32.9  "><LINK
   32.10  REL="HOME"
   32.11  TITLE="SDL Library Documentation"
   32.12 @@ -73,7 +73,7 @@
   32.13  ><DIV
   32.14  CLASS="REFNAMEDIV"
   32.15  ><A
   32.16 -NAME="AEN6380"
   32.17 +NAME="AEN6455"
   32.18  ></A
   32.19  ><H2
   32.20  >Name</H2
   32.21 @@ -81,14 +81,14 @@
   32.22  ><DIV
   32.23  CLASS="REFSYNOPSISDIV"
   32.24  ><A
   32.25 -NAME="AEN6383"
   32.26 +NAME="AEN6458"
   32.27  ></A
   32.28  ><H2
   32.29  >Synopsis</H2
   32.30  ><DIV
   32.31  CLASS="FUNCSYNOPSIS"
   32.32  ><A
   32.33 -NAME="AEN6384"
   32.34 +NAME="AEN6459"
   32.35  ></A
   32.36  ><P
   32.37  ></P
   32.38 @@ -112,7 +112,7 @@
   32.39  ><DIV
   32.40  CLASS="REFSECT1"
   32.41  ><A
   32.42 -NAME="AEN6390"
   32.43 +NAME="AEN6465"
   32.44  ></A
   32.45  ><H2
   32.46  >Description</H2
   32.47 @@ -172,7 +172,7 @@
   32.48  ><DIV
   32.49  CLASS="REFSECT1"
   32.50  ><A
   32.51 -NAME="AEN6406"
   32.52 +NAME="AEN6481"
   32.53  ></A
   32.54  ><H2
   32.55  >Return Values</H2
   32.56 @@ -185,7 +185,7 @@
   32.57  ><DIV
   32.58  CLASS="REFSECT1"
   32.59  ><A
   32.60 -NAME="AEN6410"
   32.61 +NAME="AEN6485"
   32.62  ></A
   32.63  ><H2
   32.64  >Examples</H2
   32.65 @@ -201,7 +201,7 @@
   32.66  ><DIV
   32.67  CLASS="REFSECT1"
   32.68  ><A
   32.69 -NAME="AEN6415"
   32.70 +NAME="AEN6490"
   32.71  ></A
   32.72  ><H2
   32.73  >See Also</H2
    33.1 --- a/docs/html/sdlcd.html	Sun Jun 10 18:39:47 2001 +0000
    33.2 +++ b/docs/html/sdlcd.html	Sun Jun 10 19:31:57 2001 +0000
    33.3 @@ -4,7 +4,7 @@
    33.4  >SDL_CD</TITLE
    33.5  ><META
    33.6  NAME="GENERATOR"
    33.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    33.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    33.9  "><LINK
   33.10  REL="HOME"
   33.11  TITLE="SDL Library Documentation"
   33.12 @@ -73,7 +73,7 @@
   33.13  ><DIV
   33.14  CLASS="REFNAMEDIV"
   33.15  ><A
   33.16 -NAME="AEN6941"
   33.17 +NAME="AEN7017"
   33.18  ></A
   33.19  ><H2
   33.20  >Name</H2
   33.21 @@ -81,7 +81,7 @@
   33.22  ><DIV
   33.23  CLASS="REFSECT1"
   33.24  ><A
   33.25 -NAME="AEN6944"
   33.26 +NAME="AEN7020"
   33.27  ></A
   33.28  ><H2
   33.29  >Structure Definition</H2
   33.30 @@ -99,14 +99,14 @@
   33.31  ><DIV
   33.32  CLASS="REFSECT1"
   33.33  ><A
   33.34 -NAME="AEN6947"
   33.35 +NAME="AEN7023"
   33.36  ></A
   33.37  ><H2
   33.38  >Structure Data</H2
   33.39  ><DIV
   33.40  CLASS="INFORMALTABLE"
   33.41  ><A
   33.42 -NAME="AEN6949"
   33.43 +NAME="AEN7025"
   33.44  ></A
   33.45  ><P
   33.46  ></P
   33.47 @@ -222,7 +222,7 @@
   33.48  ><DIV
   33.49  CLASS="REFSECT1"
   33.50  ><A
   33.51 -NAME="AEN6979"
   33.52 +NAME="AEN7055"
   33.53  ></A
   33.54  ><H2
   33.55  >Description</H2
   33.56 @@ -252,7 +252,7 @@
   33.57  ><DIV
   33.58  CLASS="REFSECT1"
   33.59  ><A
   33.60 -NAME="AEN6989"
   33.61 +NAME="AEN7065"
   33.62  ></A
   33.63  ><H2
   33.64  >Examples</H2
   33.65 @@ -269,7 +269,7 @@
   33.66  ><DIV
   33.67  CLASS="REFSECT1"
   33.68  ><A
   33.69 -NAME="AEN6992"
   33.70 +NAME="AEN7068"
   33.71  ></A
   33.72  ><H2
   33.73  >See Also</H2
    34.1 --- a/docs/html/sdlcdclose.html	Sun Jun 10 18:39:47 2001 +0000
    34.2 +++ b/docs/html/sdlcdclose.html	Sun Jun 10 19:31:57 2001 +0000
    34.3 @@ -4,7 +4,7 @@
    34.4  >SDL_CDClose</TITLE
    34.5  ><META
    34.6  NAME="GENERATOR"
    34.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    34.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    34.9  "><LINK
   34.10  REL="HOME"
   34.11  TITLE="SDL Library Documentation"
   34.12 @@ -73,7 +73,7 @@
   34.13  ><DIV
   34.14  CLASS="REFNAMEDIV"
   34.15  ><A
   34.16 -NAME="AEN6916"
   34.17 +NAME="AEN6992"
   34.18  ></A
   34.19  ><H2
   34.20  >Name</H2
   34.21 @@ -81,14 +81,14 @@
   34.22  ><DIV
   34.23  CLASS="REFSYNOPSISDIV"
   34.24  ><A
   34.25 -NAME="AEN6919"
   34.26 +NAME="AEN6995"
   34.27  ></A
   34.28  ><H2
   34.29  >Synopsis</H2
   34.30  ><DIV
   34.31  CLASS="FUNCSYNOPSIS"
   34.32  ><A
   34.33 -NAME="AEN6920"
   34.34 +NAME="AEN6996"
   34.35  ></A
   34.36  ><P
   34.37  ></P
   34.38 @@ -112,7 +112,7 @@
   34.39  ><DIV
   34.40  CLASS="REFSECT1"
   34.41  ><A
   34.42 -NAME="AEN6926"
   34.43 +NAME="AEN7002"
   34.44  ></A
   34.45  ><H2
   34.46  >Description</H2
   34.47 @@ -127,7 +127,7 @@
   34.48  ><DIV
   34.49  CLASS="REFSECT1"
   34.50  ><A
   34.51 -NAME="AEN6930"
   34.52 +NAME="AEN7006"
   34.53  ></A
   34.54  ><H2
   34.55  >See Also</H2
    35.1 --- a/docs/html/sdlcdeject.html	Sun Jun 10 18:39:47 2001 +0000
    35.2 +++ b/docs/html/sdlcdeject.html	Sun Jun 10 19:31:57 2001 +0000
    35.3 @@ -4,7 +4,7 @@
    35.4  >SDL_CDEject</TITLE
    35.5  ><META
    35.6  NAME="GENERATOR"
    35.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    35.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    35.9  "><LINK
   35.10  REL="HOME"
   35.11  TITLE="SDL Library Documentation"
   35.12 @@ -73,7 +73,7 @@
   35.13  ><DIV
   35.14  CLASS="REFNAMEDIV"
   35.15  ><A
   35.16 -NAME="AEN6888"
   35.17 +NAME="AEN6964"
   35.18  ></A
   35.19  ><H2
   35.20  >Name</H2
   35.21 @@ -81,14 +81,14 @@
   35.22  ><DIV
   35.23  CLASS="REFSYNOPSISDIV"
   35.24  ><A
   35.25 -NAME="AEN6891"
   35.26 +NAME="AEN6967"
   35.27  ></A
   35.28  ><H2
   35.29  >Synopsis</H2
   35.30  ><DIV
   35.31  CLASS="FUNCSYNOPSIS"
   35.32  ><A
   35.33 -NAME="AEN6892"
   35.34 +NAME="AEN6968"
   35.35  ></A
   35.36  ><P
   35.37  ></P
   35.38 @@ -112,7 +112,7 @@
   35.39  ><DIV
   35.40  CLASS="REFSECT1"
   35.41  ><A
   35.42 -NAME="AEN6898"
   35.43 +NAME="AEN6974"
   35.44  ></A
   35.45  ><H2
   35.46  >Description</H2
   35.47 @@ -127,7 +127,7 @@
   35.48  ><DIV
   35.49  CLASS="REFSECT1"
   35.50  ><A
   35.51 -NAME="AEN6902"
   35.52 +NAME="AEN6978"
   35.53  ></A
   35.54  ><H2
   35.55  >Return Value</H2
   35.56 @@ -143,7 +143,7 @@
   35.57  ><DIV
   35.58  CLASS="REFSECT1"
   35.59  ><A
   35.60 -NAME="AEN6907"
   35.61 +NAME="AEN6983"
   35.62  ></A
   35.63  ><H2
   35.64  >See Also</H2
    36.1 --- a/docs/html/sdlcdname.html	Sun Jun 10 18:39:47 2001 +0000
    36.2 +++ b/docs/html/sdlcdname.html	Sun Jun 10 19:31:57 2001 +0000
    36.3 @@ -4,7 +4,7 @@
    36.4  >SDL_CDName</TITLE
    36.5  ><META
    36.6  NAME="GENERATOR"
    36.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    36.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    36.9  "><LINK
   36.10  REL="HOME"
   36.11  TITLE="SDL Library Documentation"
   36.12 @@ -73,7 +73,7 @@
   36.13  ><DIV
   36.14  CLASS="REFNAMEDIV"
   36.15  ><A
   36.16 -NAME="AEN6615"
   36.17 +NAME="AEN6691"
   36.18  ></A
   36.19  ><H2
   36.20  >Name</H2
   36.21 @@ -81,14 +81,14 @@
   36.22  ><DIV
   36.23  CLASS="REFSYNOPSISDIV"
   36.24  ><A
   36.25 -NAME="AEN6618"
   36.26 +NAME="AEN6694"
   36.27  ></A
   36.28  ><H2
   36.29  >Synopsis</H2
   36.30  ><DIV
   36.31  CLASS="FUNCSYNOPSIS"
   36.32  ><A
   36.33 -NAME="AEN6619"
   36.34 +NAME="AEN6695"
   36.35  ></A
   36.36  ><P
   36.37  ></P
   36.38 @@ -112,7 +112,7 @@
   36.39  ><DIV
   36.40  CLASS="REFSECT1"
   36.41  ><A
   36.42 -NAME="AEN6625"
   36.43 +NAME="AEN6701"
   36.44  ></A
   36.45  ><H2
   36.46  >Description</H2
   36.47 @@ -130,7 +130,7 @@
   36.48  ><DIV
   36.49  CLASS="REFSECT1"
   36.50  ><A
   36.51 -NAME="AEN6630"
   36.52 +NAME="AEN6706"
   36.53  ></A
   36.54  ><H2
   36.55  >Examples</H2
   36.56 @@ -156,7 +156,7 @@
   36.57  ><DIV
   36.58  CLASS="REFSECT1"
   36.59  ><A
   36.60 -NAME="AEN6640"
   36.61 +NAME="AEN6716"
   36.62  ></A
   36.63  ><H2
   36.64  >See Also</H2
    37.1 --- a/docs/html/sdlcdnumdrives.html	Sun Jun 10 18:39:47 2001 +0000
    37.2 +++ b/docs/html/sdlcdnumdrives.html	Sun Jun 10 19:31:57 2001 +0000
    37.3 @@ -4,7 +4,7 @@
    37.4  >SDL_CDNumDrives</TITLE
    37.5  ><META
    37.6  NAME="GENERATOR"
    37.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    37.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    37.9  "><LINK
   37.10  REL="HOME"
   37.11  TITLE="SDL Library Documentation"
   37.12 @@ -73,7 +73,7 @@
   37.13  ><DIV
   37.14  CLASS="REFNAMEDIV"
   37.15  ><A
   37.16 -NAME="AEN6593"
   37.17 +NAME="AEN6669"
   37.18  ></A
   37.19  ><H2
   37.20  >Name</H2
   37.21 @@ -81,14 +81,14 @@
   37.22  ><DIV
   37.23  CLASS="REFSYNOPSISDIV"
   37.24  ><A
   37.25 -NAME="AEN6596"
   37.26 +NAME="AEN6672"
   37.27  ></A
   37.28  ><H2
   37.29  >Synopsis</H2
   37.30  ><DIV
   37.31  CLASS="FUNCSYNOPSIS"
   37.32  ><A
   37.33 -NAME="AEN6597"
   37.34 +NAME="AEN6673"
   37.35  ></A
   37.36  ><P
   37.37  ></P
   37.38 @@ -112,7 +112,7 @@
   37.39  ><DIV
   37.40  CLASS="REFSECT1"
   37.41  ><A
   37.42 -NAME="AEN6603"
   37.43 +NAME="AEN6679"
   37.44  ></A
   37.45  ><H2
   37.46  >Description</H2
   37.47 @@ -122,7 +122,7 @@
   37.48  ><DIV
   37.49  CLASS="REFSECT1"
   37.50  ><A
   37.51 -NAME="AEN6606"
   37.52 +NAME="AEN6682"
   37.53  ></A
   37.54  ><H2
   37.55  >See Also</H2
    38.1 --- a/docs/html/sdlcdopen.html	Sun Jun 10 18:39:47 2001 +0000
    38.2 +++ b/docs/html/sdlcdopen.html	Sun Jun 10 19:31:57 2001 +0000
    38.3 @@ -4,7 +4,7 @@
    38.4  >SDL_CDOpen</TITLE
    38.5  ><META
    38.6  NAME="GENERATOR"
    38.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    38.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    38.9  "><LINK
   38.10  REL="HOME"
   38.11  TITLE="SDL Library Documentation"
   38.12 @@ -73,7 +73,7 @@
   38.13  ><DIV
   38.14  CLASS="REFNAMEDIV"
   38.15  ><A
   38.16 -NAME="AEN6649"
   38.17 +NAME="AEN6725"
   38.18  ></A
   38.19  ><H2
   38.20  >Name</H2
   38.21 @@ -81,14 +81,14 @@
   38.22  ><DIV
   38.23  CLASS="REFSYNOPSISDIV"
   38.24  ><A
   38.25 -NAME="AEN6652"
   38.26 +NAME="AEN6728"
   38.27  ></A
   38.28  ><H2
   38.29  >Synopsis</H2
   38.30  ><DIV
   38.31  CLASS="FUNCSYNOPSIS"
   38.32  ><A
   38.33 -NAME="AEN6653"
   38.34 +NAME="AEN6729"
   38.35  ></A
   38.36  ><P
   38.37  ></P
   38.38 @@ -112,7 +112,7 @@
   38.39  ><DIV
   38.40  CLASS="REFSECT1"
   38.41  ><A
   38.42 -NAME="AEN6659"
   38.43 +NAME="AEN6735"
   38.44  ></A
   38.45  ><H2
   38.46  >Description</H2
   38.47 @@ -137,7 +137,7 @@
   38.48  ><DIV
   38.49  CLASS="REFSECT1"
   38.50  ><A
   38.51 -NAME="AEN6667"
   38.52 +NAME="AEN6743"
   38.53  ></A
   38.54  ><H2
   38.55  >Examples</H2
   38.56 @@ -178,7 +178,7 @@
   38.57  ><DIV
   38.58  CLASS="REFSECT1"
   38.59  ><A
   38.60 -NAME="AEN6670"
   38.61 +NAME="AEN6746"
   38.62  ></A
   38.63  ><H2
   38.64  >See Also</H2
    39.1 --- a/docs/html/sdlcdpause.html	Sun Jun 10 18:39:47 2001 +0000
    39.2 +++ b/docs/html/sdlcdpause.html	Sun Jun 10 19:31:57 2001 +0000
    39.3 @@ -4,7 +4,7 @@
    39.4  >SDL_CDPause</TITLE
    39.5  ><META
    39.6  NAME="GENERATOR"
    39.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    39.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    39.9  "><LINK
   39.10  REL="HOME"
   39.11  TITLE="SDL Library Documentation"
   39.12 @@ -73,7 +73,7 @@
   39.13  ><DIV
   39.14  CLASS="REFNAMEDIV"
   39.15  ><A
   39.16 -NAME="AEN6800"
   39.17 +NAME="AEN6876"
   39.18  ></A
   39.19  ><H2
   39.20  >Name</H2
   39.21 @@ -81,14 +81,14 @@
   39.22  ><DIV
   39.23  CLASS="REFSYNOPSISDIV"
   39.24  ><A
   39.25 -NAME="AEN6803"
   39.26 +NAME="AEN6879"
   39.27  ></A
   39.28  ><H2
   39.29  >Synopsis</H2
   39.30  ><DIV
   39.31  CLASS="FUNCSYNOPSIS"
   39.32  ><A
   39.33 -NAME="AEN6804"
   39.34 +NAME="AEN6880"
   39.35  ></A
   39.36  ><P
   39.37  ></P
   39.38 @@ -112,7 +112,7 @@
   39.39  ><DIV
   39.40  CLASS="REFSECT1"
   39.41  ><A
   39.42 -NAME="AEN6810"
   39.43 +NAME="AEN6886"
   39.44  ></A
   39.45  ><H2
   39.46  >Description</H2
   39.47 @@ -127,7 +127,7 @@
   39.48  ><DIV
   39.49  CLASS="REFSECT1"
   39.50  ><A
   39.51 -NAME="AEN6814"
   39.52 +NAME="AEN6890"
   39.53  ></A
   39.54  ><H2
   39.55  >Return Value</H2
   39.56 @@ -143,7 +143,7 @@
   39.57  ><DIV
   39.58  CLASS="REFSECT1"
   39.59  ><A
   39.60 -NAME="AEN6819"
   39.61 +NAME="AEN6895"
   39.62  ></A
   39.63  ><H2
   39.64  >See Also</H2
    40.1 --- a/docs/html/sdlcdplay.html	Sun Jun 10 18:39:47 2001 +0000
    40.2 +++ b/docs/html/sdlcdplay.html	Sun Jun 10 19:31:57 2001 +0000
    40.3 @@ -4,7 +4,7 @@
    40.4  >SDL_CDPlay</TITLE
    40.5  ><META
    40.6  NAME="GENERATOR"
    40.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    40.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    40.9  "><LINK
   40.10  REL="HOME"
   40.11  TITLE="SDL Library Documentation"
   40.12 @@ -73,7 +73,7 @@
   40.13  ><DIV
   40.14  CLASS="REFNAMEDIV"
   40.15  ><A
   40.16 -NAME="AEN6718"
   40.17 +NAME="AEN6794"
   40.18  ></A
   40.19  ><H2
   40.20  >Name</H2
   40.21 @@ -81,14 +81,14 @@
   40.22  ><DIV
   40.23  CLASS="REFSYNOPSISDIV"
   40.24  ><A
   40.25 -NAME="AEN6721"
   40.26 +NAME="AEN6797"
   40.27  ></A
   40.28  ><H2
   40.29  >Synopsis</H2
   40.30  ><DIV
   40.31  CLASS="FUNCSYNOPSIS"
   40.32  ><A
   40.33 -NAME="AEN6722"
   40.34 +NAME="AEN6798"
   40.35  ></A
   40.36  ><P
   40.37  ></P
   40.38 @@ -112,7 +112,7 @@
   40.39  ><DIV
   40.40  CLASS="REFSECT1"
   40.41  ><A
   40.42 -NAME="AEN6728"
   40.43 +NAME="AEN6804"
   40.44  ></A
   40.45  ><H2
   40.46  >Description</H2
   40.47 @@ -137,7 +137,7 @@
   40.48  ><DIV
   40.49  CLASS="REFSECT1"
   40.50  ><A
   40.51 -NAME="AEN6734"
   40.52 +NAME="AEN6810"
   40.53  ></A
   40.54  ><H2
   40.55  >Return Values</H2
   40.56 @@ -153,7 +153,7 @@
   40.57  ><DIV
   40.58  CLASS="REFSECT1"
   40.59  ><A
   40.60 -NAME="AEN6739"
   40.61 +NAME="AEN6815"
   40.62  ></A
   40.63  ><H2
   40.64  >See Also</H2
    41.1 --- a/docs/html/sdlcdplaytracks.html	Sun Jun 10 18:39:47 2001 +0000
    41.2 +++ b/docs/html/sdlcdplaytracks.html	Sun Jun 10 19:31:57 2001 +0000
    41.3 @@ -4,7 +4,7 @@
    41.4  >SDL_CDPlayTracks</TITLE
    41.5  ><META
    41.6  NAME="GENERATOR"
    41.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    41.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    41.9  "><LINK
   41.10  REL="HOME"
   41.11  TITLE="SDL Library Documentation"
   41.12 @@ -73,7 +73,7 @@
   41.13  ><DIV
   41.14  CLASS="REFNAMEDIV"
   41.15  ><A
   41.16 -NAME="AEN6750"
   41.17 +NAME="AEN6826"
   41.18  ></A
   41.19  ><H2
   41.20  >Name</H2
   41.21 @@ -81,14 +81,14 @@
   41.22  ><DIV
   41.23  CLASS="REFSYNOPSISDIV"
   41.24  ><A
   41.25 -NAME="AEN6753"
   41.26 +NAME="AEN6829"
   41.27  ></A
   41.28  ><H2
   41.29  >Synopsis</H2
   41.30  ><DIV
   41.31  CLASS="FUNCSYNOPSIS"
   41.32  ><A
   41.33 -NAME="AEN6754"
   41.34 +NAME="AEN6830"
   41.35  ></A
   41.36  ><P
   41.37  ></P
   41.38 @@ -112,7 +112,7 @@
   41.39  ><DIV
   41.40  CLASS="REFSECT1"
   41.41  ><A
   41.42 -NAME="AEN6760"
   41.43 +NAME="AEN6836"
   41.44  ></A
   41.45  ><H2
   41.46  >Description</H2
   41.47 @@ -186,7 +186,7 @@
   41.48  ><DIV
   41.49  CLASS="REFSECT1"
   41.50  ><A
   41.51 -NAME="AEN6778"
   41.52 +NAME="AEN6854"
   41.53  ></A
   41.54  ><H2
   41.55  >Return Value</H2
   41.56 @@ -203,7 +203,7 @@
   41.57  ><DIV
   41.58  CLASS="REFSECT1"
   41.59  ><A
   41.60 -NAME="AEN6783"
   41.61 +NAME="AEN6859"
   41.62  ></A
   41.63  ><H2
   41.64  >Examples</H2
   41.65 @@ -228,7 +228,7 @@
   41.66  ><DIV
   41.67  CLASS="REFSECT1"
   41.68  ><A
   41.69 -NAME="AEN6787"
   41.70 +NAME="AEN6863"
   41.71  ></A
   41.72  ><H2
   41.73  >See Also</H2
    42.1 --- a/docs/html/sdlcdresume.html	Sun Jun 10 18:39:47 2001 +0000
    42.2 +++ b/docs/html/sdlcdresume.html	Sun Jun 10 19:31:57 2001 +0000
    42.3 @@ -4,7 +4,7 @@
    42.4  >SDL_CDResume</TITLE
    42.5  ><META
    42.6  NAME="GENERATOR"
    42.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    42.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    42.9  "><LINK
   42.10  REL="HOME"
   42.11  TITLE="SDL Library Documentation"
   42.12 @@ -73,7 +73,7 @@
   42.13  ><DIV
   42.14  CLASS="REFNAMEDIV"
   42.15  ><A
   42.16 -NAME="AEN6830"
   42.17 +NAME="AEN6906"
   42.18  ></A
   42.19  ><H2
   42.20  >Name</H2
   42.21 @@ -81,14 +81,14 @@
   42.22  ><DIV
   42.23  CLASS="REFSYNOPSISDIV"
   42.24  ><A
   42.25 -NAME="AEN6833"
   42.26 +NAME="AEN6909"
   42.27  ></A
   42.28  ><H2
   42.29  >Synopsis</H2
   42.30  ><DIV
   42.31  CLASS="FUNCSYNOPSIS"
   42.32  ><A
   42.33 -NAME="AEN6834"
   42.34 +NAME="AEN6910"
   42.35  ></A
   42.36  ><P
   42.37  ></P
   42.38 @@ -112,7 +112,7 @@
   42.39  ><DIV
   42.40  CLASS="REFSECT1"
   42.41  ><A
   42.42 -NAME="AEN6840"
   42.43 +NAME="AEN6916"
   42.44  ></A
   42.45  ><H2
   42.46  >Description</H2
   42.47 @@ -127,7 +127,7 @@
   42.48  ><DIV
   42.49  CLASS="REFSECT1"
   42.50  ><A
   42.51 -NAME="AEN6844"
   42.52 +NAME="AEN6920"
   42.53  ></A
   42.54  ><H2
   42.55  >Return Value</H2
   42.56 @@ -143,7 +143,7 @@
   42.57  ><DIV
   42.58  CLASS="REFSECT1"
   42.59  ><A
   42.60 -NAME="AEN6849"
   42.61 +NAME="AEN6925"
   42.62  ></A
   42.63  ><H2
   42.64  >See Also</H2
    43.1 --- a/docs/html/sdlcdstatus.html	Sun Jun 10 18:39:47 2001 +0000
    43.2 +++ b/docs/html/sdlcdstatus.html	Sun Jun 10 19:31:57 2001 +0000
    43.3 @@ -4,7 +4,7 @@
    43.4  >SDL_CDStatus</TITLE
    43.5  ><META
    43.6  NAME="GENERATOR"
    43.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    43.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    43.9  "><LINK
   43.10  REL="HOME"
   43.11  TITLE="SDL Library Documentation"
   43.12 @@ -73,7 +73,7 @@
   43.13  ><DIV
   43.14  CLASS="REFNAMEDIV"
   43.15  ><A
   43.16 -NAME="AEN6683"
   43.17 +NAME="AEN6759"
   43.18  ></A
   43.19  ><H2
   43.20  >Name</H2
   43.21 @@ -81,14 +81,14 @@
   43.22  ><DIV
   43.23  CLASS="REFSYNOPSISDIV"
   43.24  ><A
   43.25 -NAME="AEN6686"
   43.26 +NAME="AEN6762"
   43.27  ></A
   43.28  ><H2
   43.29  >Synopsis</H2
   43.30  ><DIV
   43.31  CLASS="FUNCSYNOPSIS"
   43.32  ><A
   43.33 -NAME="AEN6687"
   43.34 +NAME="AEN6763"
   43.35  ></A
   43.36  ><P
   43.37  ></P
   43.38 @@ -116,7 +116,7 @@
   43.39  ><DIV
   43.40  CLASS="REFSECT1"
   43.41  ><A
   43.42 -NAME="AEN6694"
   43.43 +NAME="AEN6770"
   43.44  ></A
   43.45  ><H2
   43.46  >Description</H2
   43.47 @@ -164,7 +164,7 @@
   43.48  ><DIV
   43.49  CLASS="REFSECT1"
   43.50  ><A
   43.51 -NAME="AEN6706"
   43.52 +NAME="AEN6782"
   43.53  ></A
   43.54  ><H2
   43.55  >Example</H2
   43.56 @@ -190,7 +190,7 @@
   43.57  ><DIV
   43.58  CLASS="REFSECT1"
   43.59  ><A
   43.60 -NAME="AEN6709"
   43.61 +NAME="AEN6785"
   43.62  ></A
   43.63  ><H2
   43.64  >See Also</H2
    44.1 --- a/docs/html/sdlcdstop.html	Sun Jun 10 18:39:47 2001 +0000
    44.2 +++ b/docs/html/sdlcdstop.html	Sun Jun 10 19:31:57 2001 +0000
    44.3 @@ -4,7 +4,7 @@
    44.4  >SDL_CDStop</TITLE
    44.5  ><META
    44.6  NAME="GENERATOR"
    44.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    44.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    44.9  "><LINK
   44.10  REL="HOME"
   44.11  TITLE="SDL Library Documentation"
   44.12 @@ -73,7 +73,7 @@
   44.13  ><DIV
   44.14  CLASS="REFNAMEDIV"
   44.15  ><A
   44.16 -NAME="AEN6860"
   44.17 +NAME="AEN6936"
   44.18  ></A
   44.19  ><H2
   44.20  >Name</H2
   44.21 @@ -81,14 +81,14 @@
   44.22  ><DIV
   44.23  CLASS="REFSYNOPSISDIV"
   44.24  ><A
   44.25 -NAME="AEN6863"
   44.26 +NAME="AEN6939"
   44.27  ></A
   44.28  ><H2
   44.29  >Synopsis</H2
   44.30  ><DIV
   44.31  CLASS="FUNCSYNOPSIS"
   44.32  ><A
   44.33 -NAME="AEN6864"
   44.34 +NAME="AEN6940"
   44.35  ></A
   44.36  ><P
   44.37  ></P
   44.38 @@ -112,7 +112,7 @@
   44.39  ><DIV
   44.40  CLASS="REFSECT1"
   44.41  ><A
   44.42 -NAME="AEN6870"
   44.43 +NAME="AEN6946"
   44.44  ></A
   44.45  ><H2
   44.46  >Description</H2
   44.47 @@ -127,7 +127,7 @@
   44.48  ><DIV
   44.49  CLASS="REFSECT1"
   44.50  ><A
   44.51 -NAME="AEN6874"
   44.52 +NAME="AEN6950"
   44.53  ></A
   44.54  ><H2
   44.55  >Return Value</H2
   44.56 @@ -143,7 +143,7 @@
   44.57  ><DIV
   44.58  CLASS="REFSECT1"
   44.59  ><A
   44.60 -NAME="AEN6879"
   44.61 +NAME="AEN6955"
   44.62  ></A
   44.63  ><H2
   44.64  >See Also</H2
    45.1 --- a/docs/html/sdlcdtrack.html	Sun Jun 10 18:39:47 2001 +0000
    45.2 +++ b/docs/html/sdlcdtrack.html	Sun Jun 10 19:31:57 2001 +0000
    45.3 @@ -4,7 +4,7 @@
    45.4  >SDL_CDtrack</TITLE
    45.5  ><META
    45.6  NAME="GENERATOR"
    45.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    45.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    45.9  "><LINK
   45.10  REL="HOME"
   45.11  TITLE="SDL Library Documentation"
   45.12 @@ -73,7 +73,7 @@
   45.13  ><DIV
   45.14  CLASS="REFNAMEDIV"
   45.15  ><A
   45.16 -NAME="AEN7003"
   45.17 +NAME="AEN7079"
   45.18  ></A
   45.19  ><H2
   45.20  >Name</H2
   45.21 @@ -81,7 +81,7 @@
   45.22  ><DIV
   45.23  CLASS="REFSECT1"
   45.24  ><A
   45.25 -NAME="AEN7006"
   45.26 +NAME="AEN7082"
   45.27  ></A
   45.28  ><H2
   45.29  >Structure Definition</H2
   45.30 @@ -97,14 +97,14 @@
   45.31  ><DIV
   45.32  CLASS="REFSECT1"
   45.33  ><A
   45.34 -NAME="AEN7009"
   45.35 +NAME="AEN7085"
   45.36  ></A
   45.37  ><H2
   45.38  >Structure Data</H2
   45.39  ><DIV
   45.40  CLASS="INFORMALTABLE"
   45.41  ><A
   45.42 -NAME="AEN7011"
   45.43 +NAME="AEN7087"
   45.44  ></A
   45.45  ><P
   45.46  ></P
   45.47 @@ -187,7 +187,7 @@
   45.48  ><DIV
   45.49  CLASS="REFSECT1"
   45.50  ><A
   45.51 -NAME="AEN7032"
   45.52 +NAME="AEN7108"
   45.53  ></A
   45.54  ><H2
   45.55  >Description</H2
   45.56 @@ -230,7 +230,7 @@
   45.57  ><DIV
   45.58  CLASS="REFSECT1"
   45.59  ><A
   45.60 -NAME="AEN7044"
   45.61 +NAME="AEN7120"
   45.62  ></A
   45.63  ><H2
   45.64  >See Also</H2
    46.1 --- a/docs/html/sdlcloseaudio.html	Sun Jun 10 18:39:47 2001 +0000
    46.2 +++ b/docs/html/sdlcloseaudio.html	Sun Jun 10 19:31:57 2001 +0000
    46.3 @@ -4,7 +4,7 @@
    46.4  >SDL_CloseAudio</TITLE
    46.5  ><META
    46.6  NAME="GENERATOR"
    46.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    46.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    46.9  "><LINK
   46.10  REL="HOME"
   46.11  TITLE="SDL Library Documentation"
   46.12 @@ -73,7 +73,7 @@
   46.13  ><DIV
   46.14  CLASS="REFNAMEDIV"
   46.15  ><A
   46.16 -NAME="AEN6555"
   46.17 +NAME="AEN6631"
   46.18  ></A
   46.19  ><H2
   46.20  >Name</H2
   46.21 @@ -81,14 +81,14 @@
   46.22  ><DIV
   46.23  CLASS="REFSYNOPSISDIV"
   46.24  ><A
   46.25 -NAME="AEN6558"
   46.26 +NAME="AEN6634"
   46.27  ></A
   46.28  ><H2
   46.29  >Synopsis</H2
   46.30  ><DIV
   46.31  CLASS="FUNCSYNOPSIS"
   46.32  ><A
   46.33 -NAME="AEN6559"
   46.34 +NAME="AEN6635"
   46.35  ></A
   46.36  ><P
   46.37  ></P
   46.38 @@ -112,7 +112,7 @@
   46.39  ><DIV
   46.40  CLASS="REFSECT1"
   46.41  ><A
   46.42 -NAME="AEN6565"
   46.43 +NAME="AEN6641"
   46.44  ></A
   46.45  ><H2
   46.46  >Description</H2
   46.47 @@ -122,7 +122,7 @@
   46.48  ><DIV
   46.49  CLASS="REFSECT1"
   46.50  ><A
   46.51 -NAME="AEN6568"
   46.52 +NAME="AEN6644"
   46.53  ></A
   46.54  ><H2
   46.55  >See Also</H2
    47.1 --- a/docs/html/sdlcolor.html	Sun Jun 10 18:39:47 2001 +0000
    47.2 +++ b/docs/html/sdlcolor.html	Sun Jun 10 19:31:57 2001 +0000
    47.3 @@ -4,7 +4,7 @@
    47.4  >SDL_Color</TITLE
    47.5  ><META
    47.6  NAME="GENERATOR"
    47.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    47.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    47.9  "><LINK
   47.10  REL="HOME"
   47.11  TITLE="SDL Library Documentation"
   47.12 @@ -73,7 +73,7 @@
   47.13  ><DIV
   47.14  CLASS="REFNAMEDIV"
   47.15  ><A
   47.16 -NAME="AEN2581"
   47.17 +NAME="AEN2660"
   47.18  ></A
   47.19  ><H2
   47.20  >Name</H2
   47.21 @@ -81,7 +81,7 @@
   47.22  ><DIV
   47.23  CLASS="REFSECT1"
   47.24  ><A
   47.25 -NAME="AEN2584"
   47.26 +NAME="AEN2663"
   47.27  ></A
   47.28  ><H2
   47.29  >Structure Definition</H2
   47.30 @@ -97,14 +97,14 @@
   47.31  ><DIV
   47.32  CLASS="REFSECT1"
   47.33  ><A
   47.34 -NAME="AEN2587"
   47.35 +NAME="AEN2666"
   47.36  ></A
   47.37  ><H2
   47.38  >Structure Data</H2
   47.39  ><DIV
   47.40  CLASS="INFORMALTABLE"
   47.41  ><A
   47.42 -NAME="AEN2589"
   47.43 +NAME="AEN2668"
   47.44  ></A
   47.45  ><P
   47.46  ></P
   47.47 @@ -181,7 +181,7 @@
   47.48  ><DIV
   47.49  CLASS="REFSECT1"
   47.50  ><A
   47.51 -NAME="AEN2608"
   47.52 +NAME="AEN2687"
   47.53  ></A
   47.54  ><H2
   47.55  >Description</H2
   47.56 @@ -203,7 +203,7 @@
   47.57  ><DIV
   47.58  CLASS="REFSECT1"
   47.59  ><A
   47.60 -NAME="AEN2615"
   47.61 +NAME="AEN2694"
   47.62  ></A
   47.63  ><H2
   47.64  >See Also</H2
    48.1 --- a/docs/html/sdlcondbroadcast.html	Sun Jun 10 18:39:47 2001 +0000
    48.2 +++ b/docs/html/sdlcondbroadcast.html	Sun Jun 10 19:31:57 2001 +0000
    48.3 @@ -4,7 +4,7 @@
    48.4  >SDL_CondBroadcast</TITLE
    48.5  ><META
    48.6  NAME="GENERATOR"
    48.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    48.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    48.9  "><LINK
   48.10  REL="HOME"
   48.11  TITLE="SDL Library Documentation"
   48.12 @@ -73,7 +73,7 @@
   48.13  ><DIV
   48.14  CLASS="REFNAMEDIV"
   48.15  ><A
   48.16 -NAME="AEN7712"
   48.17 +NAME="AEN7788"
   48.18  ></A
   48.19  ><H2
   48.20  >Name</H2
   48.21 @@ -81,14 +81,14 @@
   48.22  ><DIV
   48.23  CLASS="REFSYNOPSISDIV"
   48.24  ><A
   48.25 -NAME="AEN7715"
   48.26 +NAME="AEN7791"
   48.27  ></A
   48.28  ><H2
   48.29  >Synopsis</H2
   48.30  ><DIV
   48.31  CLASS="FUNCSYNOPSIS"
   48.32  ><A
   48.33 -NAME="AEN7716"
   48.34 +NAME="AEN7792"
   48.35  ></A
   48.36  ><P
   48.37  ></P
   48.38 @@ -113,7 +113,7 @@
   48.39  ><DIV
   48.40  CLASS="REFSECT1"
   48.41  ><A
   48.42 -NAME="AEN7722"
   48.43 +NAME="AEN7798"
   48.44  ></A
   48.45  ><H2
   48.46  >Description</H2
   48.47 @@ -134,7 +134,7 @@
   48.48  ><DIV
   48.49  CLASS="REFSECT1"
   48.50  ><A
   48.51 -NAME="AEN7728"
   48.52 +NAME="AEN7804"
   48.53  ></A
   48.54  ><H2
   48.55  >See Also</H2
    49.1 --- a/docs/html/sdlcondsignal.html	Sun Jun 10 18:39:47 2001 +0000
    49.2 +++ b/docs/html/sdlcondsignal.html	Sun Jun 10 19:31:57 2001 +0000
    49.3 @@ -4,7 +4,7 @@
    49.4  >SDL_CondSignal</TITLE
    49.5  ><META
    49.6  NAME="GENERATOR"
    49.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    49.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    49.9  "><LINK
   49.10  REL="HOME"
   49.11  TITLE="SDL Library Documentation"
   49.12 @@ -73,7 +73,7 @@
   49.13  ><DIV
   49.14  CLASS="REFNAMEDIV"
   49.15  ><A
   49.16 -NAME="AEN7685"
   49.17 +NAME="AEN7761"
   49.18  ></A
   49.19  ><H2
   49.20  >Name</H2
   49.21 @@ -81,14 +81,14 @@
   49.22  ><DIV
   49.23  CLASS="REFSYNOPSISDIV"
   49.24  ><A
   49.25 -NAME="AEN7688"
   49.26 +NAME="AEN7764"
   49.27  ></A
   49.28  ><H2
   49.29  >Synopsis</H2
   49.30  ><DIV
   49.31  CLASS="FUNCSYNOPSIS"
   49.32  ><A
   49.33 -NAME="AEN7689"
   49.34 +NAME="AEN7765"
   49.35  ></A
   49.36  ><P
   49.37  ></P
   49.38 @@ -113,7 +113,7 @@
   49.39  ><DIV
   49.40  CLASS="REFSECT1"
   49.41  ><A
   49.42 -NAME="AEN7695"
   49.43 +NAME="AEN7771"
   49.44  ></A
   49.45  ><H2
   49.46  >Description</H2
   49.47 @@ -134,7 +134,7 @@
   49.48  ><DIV
   49.49  CLASS="REFSECT1"
   49.50  ><A
   49.51 -NAME="AEN7701"
   49.52 +NAME="AEN7777"
   49.53  ></A
   49.54  ><H2
   49.55  >See Also</H2
    50.1 --- a/docs/html/sdlcondwait.html	Sun Jun 10 18:39:47 2001 +0000
    50.2 +++ b/docs/html/sdlcondwait.html	Sun Jun 10 19:31:57 2001 +0000
    50.3 @@ -4,7 +4,7 @@
    50.4  >SDL_CondWait</TITLE
    50.5  ><META
    50.6  NAME="GENERATOR"
    50.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    50.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    50.9  "><LINK
   50.10  REL="HOME"
   50.11  TITLE="SDL Library Documentation"
   50.12 @@ -73,7 +73,7 @@
   50.13  ><DIV
   50.14  CLASS="REFNAMEDIV"
   50.15  ><A
   50.16 -NAME="AEN7739"
   50.17 +NAME="AEN7815"
   50.18  ></A
   50.19  ><H2
   50.20  >Name</H2
   50.21 @@ -81,14 +81,14 @@
   50.22  ><DIV
   50.23  CLASS="REFSYNOPSISDIV"
   50.24  ><A
   50.25 -NAME="AEN7742"
   50.26 +NAME="AEN7818"
   50.27  ></A
   50.28  ><H2
   50.29  >Synopsis</H2
   50.30  ><DIV
   50.31  CLASS="FUNCSYNOPSIS"
   50.32  ><A
   50.33 -NAME="AEN7743"
   50.34 +NAME="AEN7819"
   50.35  ></A
   50.36  ><P
   50.37  ></P
   50.38 @@ -113,7 +113,7 @@
   50.39  ><DIV
   50.40  CLASS="REFSECT1"
   50.41  ><A
   50.42 -NAME="AEN7749"
   50.43 +NAME="AEN7825"
   50.44  ></A
   50.45  ><H2
   50.46  >Description</H2
   50.47 @@ -134,7 +134,7 @@
   50.48  ><DIV
   50.49  CLASS="REFSECT1"
   50.50  ><A
   50.51 -NAME="AEN7755"
   50.52 +NAME="AEN7831"
   50.53  ></A
   50.54  ><H2
   50.55  >See Also</H2
    51.1 --- a/docs/html/sdlcondwaittimeout.html	Sun Jun 10 18:39:47 2001 +0000
    51.2 +++ b/docs/html/sdlcondwaittimeout.html	Sun Jun 10 19:31:57 2001 +0000
    51.3 @@ -4,7 +4,7 @@
    51.4  >SDL_CondWaitTimeout</TITLE
    51.5  ><META
    51.6  NAME="GENERATOR"
    51.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    51.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    51.9  "><LINK
   51.10  REL="HOME"
   51.11  TITLE="SDL Library Documentation"
   51.12 @@ -73,7 +73,7 @@
   51.13  ><DIV
   51.14  CLASS="REFNAMEDIV"
   51.15  ><A
   51.16 -NAME="AEN7768"
   51.17 +NAME="AEN7844"
   51.18  ></A
   51.19  ><H2
   51.20  >Name</H2
   51.21 @@ -81,14 +81,14 @@
   51.22  ><DIV
   51.23  CLASS="REFSYNOPSISDIV"
   51.24  ><A
   51.25 -NAME="AEN7771"
   51.26 +NAME="AEN7847"
   51.27  ></A
   51.28  ><H2
   51.29  >Synopsis</H2
   51.30  ><DIV
   51.31  CLASS="FUNCSYNOPSIS"
   51.32  ><A
   51.33 -NAME="AEN7772"
   51.34 +NAME="AEN7848"
   51.35  ></A
   51.36  ><P
   51.37  ></P
   51.38 @@ -113,7 +113,7 @@
   51.39  ><DIV
   51.40  CLASS="REFSECT1"
   51.41  ><A
   51.42 -NAME="AEN7778"
   51.43 +NAME="AEN7854"
   51.44  ></A
   51.45  ><H2
   51.46  >Description</H2
   51.47 @@ -147,7 +147,7 @@
   51.48  ><DIV
   51.49  CLASS="REFSECT1"
   51.50  ><A
   51.51 -NAME="AEN7787"
   51.52 +NAME="AEN7863"
   51.53  ></A
   51.54  ><H2
   51.55  >See Also</H2
    52.1 --- a/docs/html/sdlconvertaudio.html	Sun Jun 10 18:39:47 2001 +0000
    52.2 +++ b/docs/html/sdlconvertaudio.html	Sun Jun 10 19:31:57 2001 +0000
    52.3 @@ -4,7 +4,7 @@
    52.4  >SDL_ConvertAudio</TITLE
    52.5  ><META
    52.6  NAME="GENERATOR"
    52.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    52.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    52.9  "><LINK
   52.10  REL="HOME"
   52.11  TITLE="SDL Library Documentation"
   52.12 @@ -73,7 +73,7 @@
   52.13  ><DIV
   52.14  CLASS="REFNAMEDIV"
   52.15  ><A
   52.16 -NAME="AEN6426"
   52.17 +NAME="AEN6501"
   52.18  ></A
   52.19  ><H2
   52.20  >Name</H2
   52.21 @@ -81,14 +81,14 @@
   52.22  ><DIV
   52.23  CLASS="REFSYNOPSISDIV"
   52.24  ><A
   52.25 -NAME="AEN6429"
   52.26 +NAME="AEN6504"
   52.27  ></A
   52.28  ><H2
   52.29  >Synopsis</H2
   52.30  ><DIV
   52.31  CLASS="FUNCSYNOPSIS"
   52.32  ><A
   52.33 -NAME="AEN6430"
   52.34 +NAME="AEN6505"
   52.35  ></A
   52.36  ><P
   52.37  ></P
   52.38 @@ -112,7 +112,7 @@
   52.39  ><DIV
   52.40  CLASS="REFSECT1"
   52.41  ><A
   52.42 -NAME="AEN6436"
   52.43 +NAME="AEN6511"
   52.44  ></A
   52.45  ><H2
   52.46  >Description</H2
   52.47 @@ -240,7 +240,7 @@
   52.48  ><DIV
   52.49  CLASS="REFSECT1"
   52.50  ><A
   52.51 -NAME="AEN6471"
   52.52 +NAME="AEN6546"
   52.53  ></A
   52.54  ><H2
   52.55  >Examples</H2
   52.56 @@ -317,7 +317,7 @@
   52.57  ><DIV
   52.58  CLASS="REFSECT1"
   52.59  ><A
   52.60 -NAME="AEN6474"
   52.61 +NAME="AEN6549"
   52.62  ></A
   52.63  ><H2
   52.64  >See Also</H2
    53.1 --- a/docs/html/sdlconvertsurface.html	Sun Jun 10 18:39:47 2001 +0000
    53.2 +++ b/docs/html/sdlconvertsurface.html	Sun Jun 10 19:31:57 2001 +0000
    53.3 @@ -4,7 +4,7 @@
    53.4  >SDL_ConvertSurface</TITLE
    53.5  ><META
    53.6  NAME="GENERATOR"
    53.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    53.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    53.9  "><LINK
   53.10  REL="HOME"
   53.11  TITLE="SDL Library Documentation"
   53.12 @@ -73,7 +73,7 @@
   53.13  ><DIV
   53.14  CLASS="REFNAMEDIV"
   53.15  ><A
   53.16 -NAME="AEN1766"
   53.17 +NAME="AEN1843"
   53.18  ></A
   53.19  ><H2
   53.20  >Name</H2
   53.21 @@ -81,14 +81,14 @@
   53.22  ><DIV
   53.23  CLASS="REFSYNOPSISDIV"
   53.24  ><A
   53.25 -NAME="AEN1769"
   53.26 +NAME="AEN1846"
   53.27  ></A
   53.28  ><H2
   53.29  >Synopsis</H2
   53.30  ><DIV
   53.31  CLASS="FUNCSYNOPSIS"
   53.32  ><A
   53.33 -NAME="AEN1770"
   53.34 +NAME="AEN1847"
   53.35  ></A
   53.36  ><P
   53.37  ></P
   53.38 @@ -112,7 +112,7 @@
   53.39  ><DIV
   53.40  CLASS="REFSECT1"
   53.41  ><A
   53.42 -NAME="AEN1776"
   53.43 +NAME="AEN1853"
   53.44  ></A
   53.45  ><H2
   53.46  >Description</H2
   53.47 @@ -151,7 +151,7 @@
   53.48  ><DIV
   53.49  CLASS="REFSECT1"
   53.50  ><A
   53.51 -NAME="AEN1787"
   53.52 +NAME="AEN1864"
   53.53  ></A
   53.54  ><H2
   53.55  >Return Value</H2
   53.56 @@ -165,7 +165,7 @@
   53.57  ><DIV
   53.58  CLASS="REFSECT1"
   53.59  ><A
   53.60 -NAME="AEN1791"
   53.61 +NAME="AEN1868"
   53.62  ></A
   53.63  ><H2
   53.64  >See Also</H2
    54.1 --- a/docs/html/sdlcreatecond.html	Sun Jun 10 18:39:47 2001 +0000
    54.2 +++ b/docs/html/sdlcreatecond.html	Sun Jun 10 19:31:57 2001 +0000
    54.3 @@ -4,7 +4,7 @@
    54.4  >SDL_CreateCond</TITLE
    54.5  ><META
    54.6  NAME="GENERATOR"
    54.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    54.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    54.9  "><LINK
   54.10  REL="HOME"
   54.11  TITLE="SDL Library Documentation"
   54.12 @@ -73,7 +73,7 @@
   54.13  ><DIV
   54.14  CLASS="REFNAMEDIV"
   54.15  ><A
   54.16 -NAME="AEN7634"
   54.17 +NAME="AEN7710"
   54.18  ></A
   54.19  ><H2
   54.20  >Name</H2
   54.21 @@ -81,14 +81,14 @@
   54.22  ><DIV
   54.23  CLASS="REFSYNOPSISDIV"
   54.24  ><A
   54.25 -NAME="AEN7637"
   54.26 +NAME="AEN7713"
   54.27  ></A
   54.28  ><H2
   54.29  >Synopsis</H2
   54.30  ><DIV
   54.31  CLASS="FUNCSYNOPSIS"
   54.32  ><A
   54.33 -NAME="AEN7638"
   54.34 +NAME="AEN7714"
   54.35  ></A
   54.36  ><P
   54.37  ></P
   54.38 @@ -113,7 +113,7 @@
   54.39  ><DIV
   54.40  CLASS="REFSECT1"
   54.41  ><A
   54.42 -NAME="AEN7644"
   54.43 +NAME="AEN7720"
   54.44  ></A
   54.45  ><H2
   54.46  >Description</H2
   54.47 @@ -123,7 +123,7 @@
   54.48  ><DIV
   54.49  CLASS="REFSECT1"
   54.50  ><A
   54.51 -NAME="AEN7647"
   54.52 +NAME="AEN7723"
   54.53  ></A
   54.54  ><H2
   54.55  >Examples</H2
   54.56 @@ -143,7 +143,7 @@
   54.57  ><DIV
   54.58  CLASS="REFSECT1"
   54.59  ><A
   54.60 -NAME="AEN7650"
   54.61 +NAME="AEN7726"
   54.62  ></A
   54.63  ><H2
   54.64  >See Also</H2
    55.1 --- a/docs/html/sdlcreatecursor.html	Sun Jun 10 18:39:47 2001 +0000
    55.2 +++ b/docs/html/sdlcreatecursor.html	Sun Jun 10 19:31:57 2001 +0000
    55.3 @@ -4,7 +4,7 @@
    55.4  >SDL_CreateCursor</TITLE
    55.5  ><META
    55.6  NAME="GENERATOR"
    55.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    55.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    55.9  "><LINK
   55.10  REL="HOME"
   55.11  TITLE="SDL Library Documentation"
   55.12 @@ -73,7 +73,7 @@
   55.13  ><DIV
   55.14  CLASS="REFNAMEDIV"
   55.15  ><A
   55.16 -NAME="AEN1989"
   55.17 +NAME="AEN2068"
   55.18  ></A
   55.19  ><H2
   55.20  >Name</H2
   55.21 @@ -81,14 +81,14 @@
   55.22  ><DIV
   55.23  CLASS="REFSYNOPSISDIV"
   55.24  ><A
   55.25 -NAME="AEN1992"
   55.26 +NAME="AEN2071"
   55.27  ></A
   55.28  ><H2
   55.29  >Synopsis</H2
   55.30  ><DIV
   55.31  CLASS="FUNCSYNOPSIS"
   55.32  ><A
   55.33 -NAME="AEN1993"
   55.34 +NAME="AEN2072"
   55.35  ></A
   55.36  ><P
   55.37  ></P
   55.38 @@ -112,7 +112,7 @@
   55.39  ><DIV
   55.40  CLASS="REFSECT1"
   55.41  ><A
   55.42 -NAME="AEN1999"
   55.43 +NAME="AEN2078"
   55.44  ></A
   55.45  ><H2
   55.46  >Description</H2
   55.47 @@ -134,7 +134,7 @@
   55.48  <DIV
   55.49  CLASS="INFORMALTABLE"
   55.50  ><A
   55.51 -NAME="AEN2005"
   55.52 +NAME="AEN2084"
   55.53  ></A
   55.54  ><P
   55.55  ></P
   55.56 @@ -210,7 +210,7 @@
   55.57  ><DIV
   55.58  CLASS="REFSECT1"
   55.59  ><A
   55.60 -NAME="AEN2026"
   55.61 +NAME="AEN2105"
   55.62  ></A
   55.63  ><H2
   55.64  >Example</H2
   55.65 @@ -301,7 +301,7 @@
   55.66  ><DIV
   55.67  CLASS="REFSECT1"
   55.68  ><A
   55.69 -NAME="AEN2029"
   55.70 +NAME="AEN2108"
   55.71  ></A
   55.72  ><H2
   55.73  >See Also</H2
    56.1 --- a/docs/html/sdlcreatemutex.html	Sun Jun 10 18:39:47 2001 +0000
    56.2 +++ b/docs/html/sdlcreatemutex.html	Sun Jun 10 19:31:57 2001 +0000
    56.3 @@ -4,7 +4,7 @@
    56.4  >SDL_CreateMutex</TITLE
    56.5  ><META
    56.6  NAME="GENERATOR"
    56.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    56.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    56.9  "><LINK
   56.10  REL="HOME"
   56.11  TITLE="SDL Library Documentation"
   56.12 @@ -73,7 +73,7 @@
   56.13  ><DIV
   56.14  CLASS="REFNAMEDIV"
   56.15  ><A
   56.16 -NAME="AEN7195"
   56.17 +NAME="AEN7271"
   56.18  ></A
   56.19  ><H2
   56.20  >Name</H2
   56.21 @@ -81,14 +81,14 @@
   56.22  ><DIV
   56.23  CLASS="REFSYNOPSISDIV"
   56.24  ><A
   56.25 -NAME="AEN7198"
   56.26 +NAME="AEN7274"
   56.27  ></A
   56.28  ><H2
   56.29  >Synopsis</H2
   56.30  ><DIV
   56.31  CLASS="FUNCSYNOPSIS"
   56.32  ><A
   56.33 -NAME="AEN7199"
   56.34 +NAME="AEN7275"
   56.35  ></A
   56.36  ><P
   56.37  ></P
   56.38 @@ -113,7 +113,7 @@
   56.39  ><DIV
   56.40  CLASS="REFSECT1"
   56.41  ><A
   56.42 -NAME="AEN7205"
   56.43 +NAME="AEN7281"
   56.44  ></A
   56.45  ><H2
   56.46  >Description</H2
   56.47 @@ -123,7 +123,7 @@
   56.48  ><DIV
   56.49  CLASS="REFSECT1"
   56.50  ><A
   56.51 -NAME="AEN7208"
   56.52 +NAME="AEN7284"
   56.53  ></A
   56.54  ><H2
   56.55  >Examples</H2
   56.56 @@ -152,7 +152,7 @@
   56.57  ><DIV
   56.58  CLASS="REFSECT1"
   56.59  ><A
   56.60 -NAME="AEN7211"
   56.61 +NAME="AEN7287"
   56.62  ></A
   56.63  ><H2
   56.64  >See Also</H2
    57.1 --- a/docs/html/sdlcreatergbsurface.html	Sun Jun 10 18:39:47 2001 +0000
    57.2 +++ b/docs/html/sdlcreatergbsurface.html	Sun Jun 10 19:31:57 2001 +0000
    57.3 @@ -4,7 +4,7 @@
    57.4  >SDL_CreateRGBSurface</TITLE
    57.5  ><META
    57.6  NAME="GENERATOR"
    57.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    57.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    57.9  "><LINK
   57.10  REL="HOME"
   57.11  TITLE="SDL Library Documentation"
   57.12 @@ -73,7 +73,7 @@
   57.13  ><DIV
   57.14  CLASS="REFNAMEDIV"
   57.15  ><A
   57.16 -NAME="AEN1316"
   57.17 +NAME="AEN1358"
   57.18  ></A
   57.19  ><H2
   57.20  >Name</H2
   57.21 @@ -81,14 +81,14 @@
   57.22  ><DIV
   57.23  CLASS="REFSYNOPSISDIV"
   57.24  ><A
   57.25 -NAME="AEN1319"
   57.26 +NAME="AEN1361"
   57.27  ></A
   57.28  ><H2
   57.29  >Synopsis</H2
   57.30  ><DIV
   57.31  CLASS="FUNCSYNOPSIS"
   57.32  ><A
   57.33 -NAME="AEN1320"
   57.34 +NAME="AEN1362"
   57.35  ></A
   57.36  ><P
   57.37  ></P
   57.38 @@ -112,7 +112,7 @@
   57.39  ><DIV
   57.40  CLASS="REFSECT1"
   57.41  ><A
   57.42 -NAME="AEN1326"
   57.43 +NAME="AEN1368"
   57.44  ></A
   57.45  ><H2
   57.46  >Description</H2
   57.47 @@ -153,7 +153,7 @@
   57.48  ><DIV
   57.49  CLASS="INFORMALTABLE"
   57.50  ><A
   57.51 -NAME="AEN1338"
   57.52 +NAME="AEN1380"
   57.53  ></A
   57.54  ><P
   57.55  ></P
   57.56 @@ -198,7 +198,21 @@
   57.57  ><TD
   57.58  ALIGN="LEFT"
   57.59  VALIGN="TOP"
   57.60 ->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
   57.61 +>This flag turns on colourkeying for blits from this surface. If
   57.62 +<TT
   57.63 +CLASS="LITERAL"
   57.64 +>SDL_HWSURFACE</TT
   57.65 +> is also specified and colourkeyed blits
   57.66 +are hardware-accelerated, then SDL will attempt to place the surface in
   57.67 +video memory.
   57.68 +Use <A
   57.69 +HREF="sdlsetcolorkey.html"
   57.70 +><TT
   57.71 +CLASS="FUNCTION"
   57.72 +>SDL_SetColorKey</TT
   57.73 +></A
   57.74 +>
   57.75 +to set or clear this flag after surface creation.</TD
   57.76  ></TR
   57.77  ><TR
   57.78  ><TD
   57.79 @@ -211,18 +225,108 @@
   57.80  ><TD
   57.81  ALIGN="LEFT"
   57.82  VALIGN="TOP"
   57.83 ->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
   57.84 +>This flag turns on alpha-blending for blits from this surface. If
   57.85 +<TT
   57.86 +CLASS="LITERAL"
   57.87 +>SDL_HWSURFACE</TT
   57.88 +> is also specified and alpha-blending blits
   57.89 +are hardware-accelerated, then the surface will be placed in video memory if
   57.90 +possible.
   57.91 +Use <A
   57.92 +HREF="sdlsetalpha.html"
   57.93 +><TT
   57.94 +CLASS="FUNCTION"
   57.95 +>SDL_SetAlpha</TT
   57.96 +></A
   57.97 +> to
   57.98 +set or clear this flag after surface creation.</TD
   57.99  ></TR
  57.100  ></TBODY
  57.101  ></TABLE
  57.102  ><P
  57.103  ></P
  57.104  ></DIV
  57.105 +><DIV
  57.106 +CLASS="NOTE"
  57.107 +><BLOCKQUOTE
  57.108 +CLASS="NOTE"
  57.109 +><P
  57.110 +><B
  57.111 +>Note: </B
  57.112 +>If an alpha-channel is specified (that is, if <TT
  57.113 +CLASS="PARAMETER"
  57.114 +><I
  57.115 +>Amask</I
  57.116 +></TT
  57.117 +> is
  57.118 +nonzero), then the <TT
  57.119 +CLASS="LITERAL"
  57.120 +>SDL_SRCALPHA</TT
  57.121 +> flag is automatically
  57.122 +set. You may remove this flag by calling 
  57.123 +<A
  57.124 +HREF="sdlsetalpha.html"
  57.125 +><TT
  57.126 +CLASS="FUNCTION"
  57.127 +>SDL_SetAlpha</TT
  57.128 +></A
  57.129 +>
  57.130 +after surface creation.</P
  57.131 +></BLOCKQUOTE
  57.132 +></DIV
  57.133  ></DIV
  57.134  ><DIV
  57.135  CLASS="REFSECT1"
  57.136  ><A
  57.137 -NAME="AEN1357"
  57.138 +NAME="AEN1411"
  57.139 +></A
  57.140 +><H2
  57.141 +>Return Value</H2
  57.142 +><P
  57.143 +>Returns the created surface, or <SPAN
  57.144 +CLASS="RETURNVALUE"
  57.145 +>NULL</SPAN
  57.146 +> upon error.</P
  57.147 +></DIV
  57.148 +><DIV
  57.149 +CLASS="REFSECT1"
  57.150 +><A
  57.151 +NAME="AEN1415"
  57.152 +></A
  57.153 +><H2
  57.154 +>Example</H2
  57.155 +><PRE
  57.156 +CLASS="PROGRAMLISTING"
  57.157 +>    /* Create a 32-bit surface with the bytes of each pixel in R,G,B,A order,
  57.158 +       as expected by OpenGL for textures */
  57.159 +    SDL_Surface *surface;
  57.160 +    Uint32 rmask, gmask, bmask, amask;
  57.161 +
  57.162 +    /* SDL interprets each pixel as a 32-bit number, so our masks must depend
  57.163 +       on the endianness (byte order) of the machine */
  57.164 +#if SDL_BYTEORDER == SDL_BIG_ENDIAN
  57.165 +    rmask = 0xff000000;
  57.166 +    gmask = 0x00ff0000;
  57.167 +    bmask = 0x0000ff00;
  57.168 +    amask = 0x000000ff;
  57.169 +#else
  57.170 +    rmask = 0x000000ff;
  57.171 +    gmask = 0x0000ff00;
  57.172 +    bmask = 0x00ff0000;
  57.173 +    amask = 0xff000000;
  57.174 +#endif
  57.175 +
  57.176 +    surface = SDL_CreateRGBSurface(SDL_SWSURFACE, width, height, 32,
  57.177 +                                   rmask, gmask, bmask, amask);
  57.178 +    if(surface == NULL) {
  57.179 +        fprintf(stderr, "CreateRGBSurface failed: %s\n", SDL_GetError());
  57.180 +        exit(1);
  57.181 +    }</PRE
  57.182 +></DIV
  57.183 +><DIV
  57.184 +CLASS="REFSECT1"
  57.185 +><A
  57.186 +NAME="AEN1418"
  57.187  ></A
  57.188  ><H2
  57.189  >See Also</H2
  57.190 @@ -268,6 +372,20 @@
  57.191  CLASS="STRUCTNAME"
  57.192  >SDL_Surface</SPAN
  57.193  ></A
  57.194 +>
  57.195 +<A
  57.196 +HREF="sdlsetalpha.html"
  57.197 +><TT
  57.198 +CLASS="FUNCTION"
  57.199 +>SDL_SetAlpha</TT
  57.200 +></A
  57.201 +>
  57.202 +<A
  57.203 +HREF="sdlsetcolorkey.html"
  57.204 +><TT
  57.205 +CLASS="FUNCTION"
  57.206 +>SDL_SetColorKey</TT
  57.207 +></A
  57.208  ></P
  57.209  ></DIV
  57.210  ><DIV
    58.1 --- a/docs/html/sdlcreatergbsurfacefrom.html	Sun Jun 10 18:39:47 2001 +0000
    58.2 +++ b/docs/html/sdlcreatergbsurfacefrom.html	Sun Jun 10 19:31:57 2001 +0000
    58.3 @@ -4,7 +4,7 @@
    58.4  >SDL_CreateRGBSurfaceFrom</TITLE
    58.5  ><META
    58.6  NAME="GENERATOR"
    58.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    58.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    58.9  "><LINK
   58.10  REL="HOME"
   58.11  TITLE="SDL Library Documentation"
   58.12 @@ -73,7 +73,7 @@
   58.13  ><DIV
   58.14  CLASS="REFNAMEDIV"
   58.15  ><A
   58.16 -NAME="AEN1376"
   58.17 +NAME="AEN1441"
   58.18  ></A
   58.19  ><H2
   58.20  >Name</H2
   58.21 @@ -81,14 +81,14 @@
   58.22  ><DIV
   58.23  CLASS="REFSYNOPSISDIV"
   58.24  ><A
   58.25 -NAME="AEN1379"
   58.26 +NAME="AEN1444"
   58.27  ></A
   58.28  ><H2
   58.29  >Synopsis</H2
   58.30  ><DIV
   58.31  CLASS="FUNCSYNOPSIS"
   58.32  ><A
   58.33 -NAME="AEN1380"
   58.34 +NAME="AEN1445"
   58.35  ></A
   58.36  ><P
   58.37  ></P
   58.38 @@ -112,7 +112,7 @@
   58.39  ><DIV
   58.40  CLASS="REFSECT1"
   58.41  ><A
   58.42 -NAME="AEN1386"
   58.43 +NAME="AEN1451"
   58.44  ></A
   58.45  ><H2
   58.46  >Description</H2
   58.47 @@ -132,7 +132,7 @@
   58.48  > specified in the parameter list. The pixel data is not copied into the <SPAN
   58.49  CLASS="STRUCTNAME"
   58.50  >SDL_Surface</SPAN
   58.51 -> structure so it should no be freed until the surface has been freed with a called to <A
   58.52 +> structure so it should not be freed until the surface has been freed with a called to <A
   58.53  HREF="sdlfreesurface.html"
   58.54  >SDL_FreeSurface</A
   58.55  >. <TT
   58.56 @@ -153,7 +153,20 @@
   58.57  ><DIV
   58.58  CLASS="REFSECT1"
   58.59  ><A
   58.60 -NAME="AEN1398"
   58.61 +NAME="AEN1463"
   58.62 +></A
   58.63 +><H2
   58.64 +>Return Value</H2
   58.65 +><P
   58.66 +>Returns the created surface, or <SPAN
   58.67 +CLASS="RETURNVALUE"
   58.68 +>NULL</SPAN
   58.69 +> upon error.</P
   58.70 +></DIV
   58.71 +><DIV
   58.72 +CLASS="REFSECT1"
   58.73 +><A
   58.74 +NAME="AEN1467"
   58.75  ></A
   58.76  ><H2
   58.77  >See Also</H2
    59.1 --- a/docs/html/sdlcreatesemaphore.html	Sun Jun 10 18:39:47 2001 +0000
    59.2 +++ b/docs/html/sdlcreatesemaphore.html	Sun Jun 10 19:31:57 2001 +0000
    59.3 @@ -4,7 +4,7 @@
    59.4  >SDL_CreateSemaphore</TITLE
    59.5  ><META
    59.6  NAME="GENERATOR"
    59.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    59.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    59.9  "><LINK
   59.10  REL="HOME"
   59.11  TITLE="SDL Library Documentation"
   59.12 @@ -73,7 +73,7 @@
   59.13  ><DIV
   59.14  CLASS="REFNAMEDIV"
   59.15  ><A
   59.16 -NAME="AEN7311"
   59.17 +NAME="AEN7387"
   59.18  ></A
   59.19  ><H2
   59.20  >Name</H2
   59.21 @@ -81,14 +81,14 @@
   59.22  ><DIV
   59.23  CLASS="REFSYNOPSISDIV"
   59.24  ><A
   59.25 -NAME="AEN7314"
   59.26 +NAME="AEN7390"
   59.27  ></A
   59.28  ><H2
   59.29  >Synopsis</H2
   59.30  ><DIV
   59.31  CLASS="FUNCSYNOPSIS"
   59.32  ><A
   59.33 -NAME="AEN7315"
   59.34 +NAME="AEN7391"
   59.35  ></A
   59.36  ><P
   59.37  ></P
   59.38 @@ -113,7 +113,7 @@
   59.39  ><DIV
   59.40  CLASS="REFSECT1"
   59.41  ><A
   59.42 -NAME="AEN7321"
   59.43 +NAME="AEN7397"
   59.44  ></A
   59.45  ><H2
   59.46  >Description</H2
   59.47 @@ -152,7 +152,7 @@
   59.48  ><DIV
   59.49  CLASS="REFSECT1"
   59.50  ><A
   59.51 -NAME="AEN7330"
   59.52 +NAME="AEN7406"
   59.53  ></A
   59.54  ><H2
   59.55  >Return Value</H2
   59.56 @@ -166,7 +166,7 @@
   59.57  ><DIV
   59.58  CLASS="REFSECT1"
   59.59  ><A
   59.60 -NAME="AEN7334"
   59.61 +NAME="AEN7410"
   59.62  ></A
   59.63  ><H2
   59.64  >Examples</H2
   59.65 @@ -185,7 +185,7 @@
   59.66  ><DIV
   59.67  CLASS="REFSECT1"
   59.68  ><A
   59.69 -NAME="AEN7338"
   59.70 +NAME="AEN7414"
   59.71  ></A
   59.72  ><H2
   59.73  >See Also</H2
    60.1 --- a/docs/html/sdlcreatethread.html	Sun Jun 10 18:39:47 2001 +0000
    60.2 +++ b/docs/html/sdlcreatethread.html	Sun Jun 10 19:31:57 2001 +0000
    60.3 @@ -4,7 +4,7 @@
    60.4  >SDL_CreateThread</TITLE
    60.5  ><META
    60.6  NAME="GENERATOR"
    60.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    60.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    60.9  "><LINK
   60.10  REL="HOME"
   60.11  TITLE="SDL Library Documentation"
   60.12 @@ -73,7 +73,7 @@
   60.13  ><DIV
   60.14  CLASS="REFNAMEDIV"
   60.15  ><A
   60.16 -NAME="AEN7076"
   60.17 +NAME="AEN7152"
   60.18  ></A
   60.19  ><H2
   60.20  >Name</H2
   60.21 @@ -81,14 +81,14 @@
   60.22  ><DIV
   60.23  CLASS="REFSYNOPSISDIV"
   60.24  ><A
   60.25 -NAME="AEN7079"
   60.26 +NAME="AEN7155"
   60.27  ></A
   60.28  ><H2
   60.29  >Synopsis</H2
   60.30  ><DIV
   60.31  CLASS="FUNCSYNOPSIS"
   60.32  ><A
   60.33 -NAME="AEN7080"
   60.34 +NAME="AEN7156"
   60.35  ></A
   60.36  ><P
   60.37  ></P
   60.38 @@ -113,7 +113,7 @@
   60.39  ><DIV
   60.40  CLASS="REFSECT1"
   60.41  ><A
   60.42 -NAME="AEN7086"
   60.43 +NAME="AEN7162"
   60.44  ></A
   60.45  ><H2
   60.46  >Description</H2
   60.47 @@ -140,7 +140,7 @@
   60.48  ><DIV
   60.49  CLASS="REFSECT1"
   60.50  ><A
   60.51 -NAME="AEN7092"
   60.52 +NAME="AEN7168"
   60.53  ></A
   60.54  ><H2
   60.55  >See Also</H2
    61.1 --- a/docs/html/sdlcreateyuvoverlay.html	Sun Jun 10 18:39:47 2001 +0000
    61.2 +++ b/docs/html/sdlcreateyuvoverlay.html	Sun Jun 10 19:31:57 2001 +0000
    61.3 @@ -4,7 +4,7 @@
    61.4  >SDL_CreateYUVOverlay</TITLE
    61.5  ><META
    61.6  NAME="GENERATOR"
    61.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    61.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    61.9  "><LINK
   61.10  REL="HOME"
   61.11  TITLE="SDL Library Documentation"
   61.12 @@ -73,7 +73,7 @@
   61.13  ><DIV
   61.14  CLASS="REFNAMEDIV"
   61.15  ><A
   61.16 -NAME="AEN2310"
   61.17 +NAME="AEN2389"
   61.18  ></A
   61.19  ><H2
   61.20  >Name</H2
   61.21 @@ -81,14 +81,14 @@
   61.22  ><DIV
   61.23  CLASS="REFSYNOPSISDIV"
   61.24  ><A
   61.25 -NAME="AEN2313"
   61.26 +NAME="AEN2392"
   61.27  ></A
   61.28  ><H2
   61.29  >Synopsis</H2
   61.30  ><DIV
   61.31  CLASS="FUNCSYNOPSIS"
   61.32  ><A
   61.33 -NAME="AEN2314"
   61.34 +NAME="AEN2393"
   61.35  ></A
   61.36  ><P
   61.37  ></P
   61.38 @@ -112,7 +112,7 @@
   61.39  ><DIV
   61.40  CLASS="REFSECT1"
   61.41  ><A
   61.42 -NAME="AEN2320"
   61.43 +NAME="AEN2399"
   61.44  ></A
   61.45  ><H2
   61.46  >Description</H2
   61.47 @@ -159,7 +159,7 @@
   61.48  ><DIV
   61.49  CLASS="REFSECT1"
   61.50  ><A
   61.51 -NAME="AEN2333"
   61.52 +NAME="AEN2412"
   61.53  ></A
   61.54  ><H2
   61.55  >See Also</H2
    62.1 --- a/docs/html/sdldelay.html	Sun Jun 10 18:39:47 2001 +0000
    62.2 +++ b/docs/html/sdldelay.html	Sun Jun 10 19:31:57 2001 +0000
    62.3 @@ -4,7 +4,7 @@
    62.4  >SDL_Delay</TITLE
    62.5  ><META
    62.6  NAME="GENERATOR"
    62.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    62.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    62.9  "><LINK
   62.10  REL="HOME"
   62.11  TITLE="SDL Library Documentation"
   62.12 @@ -73,7 +73,7 @@
   62.13  ><DIV
   62.14  CLASS="REFNAMEDIV"
   62.15  ><A
   62.16 -NAME="AEN7830"
   62.17 +NAME="AEN7906"
   62.18  ></A
   62.19  ><H2
   62.20  >Name</H2
   62.21 @@ -81,14 +81,14 @@
   62.22  ><DIV
   62.23  CLASS="REFSYNOPSISDIV"
   62.24  ><A
   62.25 -NAME="AEN7833"
   62.26 +NAME="AEN7909"
   62.27  ></A
   62.28  ><H2
   62.29  >Synopsis</H2
   62.30  ><DIV
   62.31  CLASS="FUNCSYNOPSIS"
   62.32  ><A
   62.33 -NAME="AEN7834"
   62.34 +NAME="AEN7910"
   62.35  ></A
   62.36  ><P
   62.37  ></P
   62.38 @@ -112,7 +112,7 @@
   62.39  ><DIV
   62.40  CLASS="REFSECT1"
   62.41  ><A
   62.42 -NAME="AEN7840"
   62.43 +NAME="AEN7916"
   62.44  ></A
   62.45  ><H2
   62.46  >Description</H2
   62.47 @@ -124,11 +124,25 @@
   62.48  CLASS="EMPHASIS"
   62.49  >least</I
   62.50  > the specified time, but possible longer due to OS scheduling.</P
   62.51 +><DIV
   62.52 +CLASS="NOTE"
   62.53 +><BLOCKQUOTE
   62.54 +CLASS="NOTE"
   62.55 +><P
   62.56 +><B
   62.57 +>Note: </B
   62.58 +>Count on a delay granularity of <I
   62.59 +CLASS="EMPHASIS"
   62.60 +>at least</I
   62.61 +> 10 ms.
   62.62 +Some platforms have shorter clock ticks but this is the most common.</P
   62.63 +></BLOCKQUOTE
   62.64 +></DIV
   62.65  ></DIV
   62.66  ><DIV
   62.67  CLASS="REFSECT1"
   62.68  ><A
   62.69 -NAME="AEN7845"
   62.70 +NAME="AEN7924"
   62.71  ></A
   62.72  ><H2
   62.73  >See Also</H2
    63.1 --- a/docs/html/sdldestroycond.html	Sun Jun 10 18:39:47 2001 +0000
    63.2 +++ b/docs/html/sdldestroycond.html	Sun Jun 10 19:31:57 2001 +0000
    63.3 @@ -4,7 +4,7 @@
    63.4  >SDL_DestroyCond</TITLE
    63.5  ><META
    63.6  NAME="GENERATOR"
    63.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    63.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    63.9  "><LINK
   63.10  REL="HOME"
   63.11  TITLE="SDL Library Documentation"
   63.12 @@ -73,7 +73,7 @@
   63.13  ><DIV
   63.14  CLASS="REFNAMEDIV"
   63.15  ><A
   63.16 -NAME="AEN7663"
   63.17 +NAME="AEN7739"
   63.18  ></A
   63.19  ><H2
   63.20  >Name</H2
   63.21 @@ -81,14 +81,14 @@
   63.22  ><DIV
   63.23  CLASS="REFSYNOPSISDIV"
   63.24  ><A
   63.25 -NAME="AEN7666"
   63.26 +NAME="AEN7742"
   63.27  ></A
   63.28  ><H2
   63.29  >Synopsis</H2
   63.30  ><DIV
   63.31  CLASS="FUNCSYNOPSIS"
   63.32  ><A
   63.33 -NAME="AEN7667"
   63.34 +NAME="AEN7743"
   63.35  ></A
   63.36  ><P
   63.37  ></P
   63.38 @@ -113,7 +113,7 @@
   63.39  ><DIV
   63.40  CLASS="REFSECT1"
   63.41  ><A
   63.42 -NAME="AEN7673"
   63.43 +NAME="AEN7749"
   63.44  ></A
   63.45  ><H2
   63.46  >Description</H2
   63.47 @@ -123,7 +123,7 @@
   63.48  ><DIV
   63.49  CLASS="REFSECT1"
   63.50  ><A
   63.51 -NAME="AEN7676"
   63.52 +NAME="AEN7752"
   63.53  ></A
   63.54  ><H2
   63.55  >See Also</H2
    64.1 --- a/docs/html/sdldestroymutex.html	Sun Jun 10 18:39:47 2001 +0000
    64.2 +++ b/docs/html/sdldestroymutex.html	Sun Jun 10 19:31:57 2001 +0000
    64.3 @@ -4,7 +4,7 @@
    64.4  >SDL_DestroyMutex</TITLE
    64.5  ><META
    64.6  NAME="GENERATOR"
    64.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    64.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    64.9  "><LINK
   64.10  REL="HOME"
   64.11  TITLE="SDL Library Documentation"
   64.12 @@ -73,7 +73,7 @@
   64.13  ><DIV
   64.14  CLASS="REFNAMEDIV"
   64.15  ><A
   64.16 -NAME="AEN7224"
   64.17 +NAME="AEN7300"
   64.18  ></A
   64.19  ><H2
   64.20  >Name</H2
   64.21 @@ -81,14 +81,14 @@
   64.22  ><DIV
   64.23  CLASS="REFSYNOPSISDIV"
   64.24  ><A
   64.25 -NAME="AEN7227"
   64.26 +NAME="AEN7303"
   64.27  ></A
   64.28  ><H2
   64.29  >Synopsis</H2
   64.30  ><DIV
   64.31  CLASS="FUNCSYNOPSIS"
   64.32  ><A
   64.33 -NAME="AEN7228"
   64.34 +NAME="AEN7304"
   64.35  ></A
   64.36  ><P
   64.37  ></P
   64.38 @@ -113,7 +113,7 @@
   64.39  ><DIV
   64.40  CLASS="REFSECT1"
   64.41  ><A
   64.42 -NAME="AEN7234"
   64.43 +NAME="AEN7310"
   64.44  ></A
   64.45  ><H2
   64.46  >Description</H2
   64.47 @@ -126,7 +126,7 @@
   64.48  ><DIV
   64.49  CLASS="REFSECT1"
   64.50  ><A
   64.51 -NAME="AEN7238"
   64.52 +NAME="AEN7314"
   64.53  ></A
   64.54  ><H2
   64.55  >See Also</H2
    65.1 --- a/docs/html/sdldestroysemaphore.html	Sun Jun 10 18:39:47 2001 +0000
    65.2 +++ b/docs/html/sdldestroysemaphore.html	Sun Jun 10 19:31:57 2001 +0000
    65.3 @@ -4,7 +4,7 @@
    65.4  >SDL_DestroySemaphore</TITLE
    65.5  ><META
    65.6  NAME="GENERATOR"
    65.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    65.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    65.9  "><LINK
   65.10  REL="HOME"
   65.11  TITLE="SDL Library Documentation"
   65.12 @@ -73,7 +73,7 @@
   65.13  ><DIV
   65.14  CLASS="REFNAMEDIV"
   65.15  ><A
   65.16 -NAME="AEN7357"
   65.17 +NAME="AEN7433"
   65.18  ></A
   65.19  ><H2
   65.20  >Name</H2
   65.21 @@ -84,14 +84,14 @@
   65.22  ><DIV
   65.23  CLASS="REFSYNOPSISDIV"
   65.24  ><A
   65.25 -NAME="AEN7361"
   65.26 +NAME="AEN7437"
   65.27  ></A
   65.28  ><H2
   65.29  >Synopsis</H2
   65.30  ><DIV
   65.31  CLASS="FUNCSYNOPSIS"
   65.32  ><A
   65.33 -NAME="AEN7362"
   65.34 +NAME="AEN7438"
   65.35  ></A
   65.36  ><P
   65.37  ></P
   65.38 @@ -116,7 +116,7 @@
   65.39  ><DIV
   65.40  CLASS="REFSECT1"
   65.41  ><A
   65.42 -NAME="AEN7368"
   65.43 +NAME="AEN7444"
   65.44  ></A
   65.45  ><H2
   65.46  >Description</H2
   65.47 @@ -144,7 +144,7 @@
   65.48  ><DIV
   65.49  CLASS="REFSECT1"
   65.50  ><A
   65.51 -NAME="AEN7375"
   65.52 +NAME="AEN7451"
   65.53  ></A
   65.54  ><H2
   65.55  >Examples</H2
   65.56 @@ -160,7 +160,7 @@
   65.57  ><DIV
   65.58  CLASS="REFSECT1"
   65.59  ><A
   65.60 -NAME="AEN7379"
   65.61 +NAME="AEN7455"
   65.62  ></A
   65.63  ><H2
   65.64  >See Also</H2
    66.1 --- a/docs/html/sdldisplayformat.html	Sun Jun 10 18:39:47 2001 +0000
    66.2 +++ b/docs/html/sdldisplayformat.html	Sun Jun 10 19:31:57 2001 +0000
    66.3 @@ -4,7 +4,7 @@
    66.4  >SDL_DisplayFormat</TITLE
    66.5  ><META
    66.6  NAME="GENERATOR"
    66.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    66.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    66.9  "><LINK
   66.10  REL="HOME"
   66.11  TITLE="SDL Library Documentation"
   66.12 @@ -73,7 +73,7 @@
   66.13  ><DIV
   66.14  CLASS="REFNAMEDIV"
   66.15  ><A
   66.16 -NAME="AEN1898"
   66.17 +NAME="AEN1975"
   66.18  ></A
   66.19  ><H2
   66.20  >Name</H2
   66.21 @@ -81,14 +81,14 @@
   66.22  ><DIV
   66.23  CLASS="REFSYNOPSISDIV"
   66.24  ><A
   66.25 -NAME="AEN1901"
   66.26 +NAME="AEN1978"
   66.27  ></A
   66.28  ><H2
   66.29  >Synopsis</H2
   66.30  ><DIV
   66.31  CLASS="FUNCSYNOPSIS"
   66.32  ><A
   66.33 -NAME="AEN1902"
   66.34 +NAME="AEN1979"
   66.35  ></A
   66.36  ><P
   66.37  ></P
   66.38 @@ -112,7 +112,7 @@
   66.39  ><DIV
   66.40  CLASS="REFSECT1"
   66.41  ><A
   66.42 -NAME="AEN1908"
   66.43 +NAME="AEN1985"
   66.44  ></A
   66.45  ><H2
   66.46  >Description</H2
   66.47 @@ -137,7 +137,7 @@
   66.48  ><DIV
   66.49  CLASS="REFSECT1"
   66.50  ><A
   66.51 -NAME="AEN1915"
   66.52 +NAME="AEN1992"
   66.53  ></A
   66.54  ><H2
   66.55  >Return Value</H2
   66.56 @@ -151,7 +151,7 @@
   66.57  ><DIV
   66.58  CLASS="REFSECT1"
   66.59  ><A
   66.60 -NAME="AEN1919"
   66.61 +NAME="AEN1996"
   66.62  ></A
   66.63  ><H2
   66.64  >See Also</H2
    67.1 --- a/docs/html/sdldisplayformatalpha.html	Sun Jun 10 18:39:47 2001 +0000
    67.2 +++ b/docs/html/sdldisplayformatalpha.html	Sun Jun 10 19:31:57 2001 +0000
    67.3 @@ -4,7 +4,7 @@
    67.4  >SDL_DisplayFormatAlpha</TITLE
    67.5  ><META
    67.6  NAME="GENERATOR"
    67.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    67.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    67.9  "><LINK
   67.10  REL="HOME"
   67.11  TITLE="SDL Library Documentation"
   67.12 @@ -73,7 +73,7 @@
   67.13  ><DIV
   67.14  CLASS="REFNAMEDIV"
   67.15  ><A
   67.16 -NAME="AEN1936"
   67.17 +NAME="AEN2013"
   67.18  ></A
   67.19  ><H2
   67.20  >Name</H2
   67.21 @@ -81,14 +81,14 @@
   67.22  ><DIV
   67.23  CLASS="REFSYNOPSISDIV"
   67.24  ><A
   67.25 -NAME="AEN1939"
   67.26 +NAME="AEN2016"
   67.27  ></A
   67.28  ><H2
   67.29  >Synopsis</H2
   67.30  ><DIV
   67.31  CLASS="FUNCSYNOPSIS"
   67.32  ><A
   67.33 -NAME="AEN1940"
   67.34 +NAME="AEN2017"
   67.35  ></A
   67.36  ><P
   67.37  ></P
   67.38 @@ -112,7 +112,7 @@
   67.39  ><DIV
   67.40  CLASS="REFSECT1"
   67.41  ><A
   67.42 -NAME="AEN1946"
   67.43 +NAME="AEN2023"
   67.44  ></A
   67.45  ><H2
   67.46  >Description</H2
   67.47 @@ -128,11 +128,19 @@
   67.48  >If you want to take advantage of hardware colorkey or alpha blit
   67.49  acceleration, you should set the colorkey and alpha value before
   67.50  calling this function.</P
   67.51 +><P
   67.52 +>This function can be used to convert a colourkey to an alpha channel,
   67.53 +if the <TT
   67.54 +CLASS="LITERAL"
   67.55 +>SDL_SRCCOLORKEY</TT
   67.56 +> flag is set on the surface.
   67.57 +The generated surface will then be transparent (alpha=0) where the
   67.58 +pixels match the colourkey, and opaque (alpha=255) elsewhere.</P
   67.59  ></DIV
   67.60  ><DIV
   67.61  CLASS="REFSECT1"
   67.62  ><A
   67.63 -NAME="AEN1951"
   67.64 +NAME="AEN2030"
   67.65  ></A
   67.66  ><H2
   67.67  >Return Value</H2
   67.68 @@ -146,7 +154,7 @@
   67.69  ><DIV
   67.70  CLASS="REFSECT1"
   67.71  ><A
   67.72 -NAME="AEN1955"
   67.73 +NAME="AEN2034"
   67.74  ></A
   67.75  ><H2
   67.76  >See Also</H2
    68.1 --- a/docs/html/sdldisplayyuvoverlay.html	Sun Jun 10 18:39:47 2001 +0000
    68.2 +++ b/docs/html/sdldisplayyuvoverlay.html	Sun Jun 10 19:31:57 2001 +0000
    68.3 @@ -4,7 +4,7 @@
    68.4  >SDL_DisplayYUVOverlay</TITLE
    68.5  ><META
    68.6  NAME="GENERATOR"
    68.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    68.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    68.9  "><LINK
   68.10  REL="HOME"
   68.11  TITLE="SDL Library Documentation"
   68.12 @@ -73,7 +73,7 @@
   68.13  ><DIV
   68.14  CLASS="REFNAMEDIV"
   68.15  ><A
   68.16 -NAME="AEN2410"
   68.17 +NAME="AEN2489"
   68.18  ></A
   68.19  ><H2
   68.20  >Name</H2
   68.21 @@ -81,14 +81,14 @@
   68.22  ><DIV
   68.23  CLASS="REFSYNOPSISDIV"
   68.24  ><A
   68.25 -NAME="AEN2413"
   68.26 +NAME="AEN2492"
   68.27  ></A
   68.28  ><H2
   68.29  >Synopsis</H2
   68.30  ><DIV
   68.31  CLASS="FUNCSYNOPSIS"
   68.32  ><A
   68.33 -NAME="AEN2414"
   68.34 +NAME="AEN2493"
   68.35  ></A
   68.36  ><P
   68.37  ></P
   68.38 @@ -112,7 +112,7 @@
   68.39  ><DIV
   68.40  CLASS="REFSECT1"
   68.41  ><A
   68.42 -NAME="AEN2420"
   68.43 +NAME="AEN2499"
   68.44  ></A
   68.45  ><H2
   68.46  >Description</H2
   68.47 @@ -146,7 +146,7 @@
   68.48  ><DIV
   68.49  CLASS="REFSECT1"
   68.50  ><A
   68.51 -NAME="AEN2429"
   68.52 +NAME="AEN2508"
   68.53  ></A
   68.54  ><H2
   68.55  >See Also</H2
    69.1 --- a/docs/html/sdlenablekeyrepeat.html	Sun Jun 10 18:39:47 2001 +0000
    69.2 +++ b/docs/html/sdlenablekeyrepeat.html	Sun Jun 10 19:31:57 2001 +0000
    69.3 @@ -4,7 +4,7 @@
    69.4  >SDL_EnableKeyRepeat</TITLE
    69.5  ><META
    69.6  NAME="GENERATOR"
    69.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    69.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    69.9  "><LINK
   69.10  REL="HOME"
   69.11  TITLE="SDL Library Documentation"
   69.12 @@ -73,7 +73,7 @@
   69.13  ><DIV
   69.14  CLASS="REFNAMEDIV"
   69.15  ><A
   69.16 -NAME="AEN5217"
   69.17 +NAME="AEN5292"
   69.18  ></A
   69.19  ><H2
   69.20  >Name</H2
   69.21 @@ -81,14 +81,14 @@
   69.22  ><DIV
   69.23  CLASS="REFSYNOPSISDIV"
   69.24  ><A
   69.25 -NAME="AEN5220"
   69.26 +NAME="AEN5295"
   69.27  ></A
   69.28  ><H2
   69.29  >Synopsis</H2
   69.30  ><DIV
   69.31  CLASS="FUNCSYNOPSIS"
   69.32  ><A
   69.33 -NAME="AEN5221"
   69.34 +NAME="AEN5296"
   69.35  ></A
   69.36  ><P
   69.37  ></P
   69.38 @@ -112,7 +112,7 @@
   69.39  ><DIV
   69.40  CLASS="REFSECT1"
   69.41  ><A
   69.42 -NAME="AEN5227"
   69.43 +NAME="AEN5302"
   69.44  ></A
   69.45  ><H2
   69.46  >Description</H2
   69.47 @@ -155,7 +155,7 @@
   69.48  ><DIV
   69.49  CLASS="REFSECT1"
   69.50  ><A
   69.51 -NAME="AEN5238"
   69.52 +NAME="AEN5313"
   69.53  ></A
   69.54  ><H2
   69.55  >Return Value</H2
    70.1 --- a/docs/html/sdlenableunicode.html	Sun Jun 10 18:39:47 2001 +0000
    70.2 +++ b/docs/html/sdlenableunicode.html	Sun Jun 10 19:31:57 2001 +0000
    70.3 @@ -4,7 +4,7 @@
    70.4  >SDL_EnableUNICODE</TITLE
    70.5  ><META
    70.6  NAME="GENERATOR"
    70.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    70.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    70.9  "><LINK
   70.10  REL="HOME"
   70.11  TITLE="SDL Library Documentation"
   70.12 @@ -73,7 +73,7 @@
   70.13  ><DIV
   70.14  CLASS="REFNAMEDIV"
   70.15  ><A
   70.16 -NAME="AEN5187"
   70.17 +NAME="AEN5262"
   70.18  ></A
   70.19  ><H2
   70.20  >Name</H2
   70.21 @@ -81,14 +81,14 @@
   70.22  ><DIV
   70.23  CLASS="REFSYNOPSISDIV"
   70.24  ><A
   70.25 -NAME="AEN5190"
   70.26 +NAME="AEN5265"
   70.27  ></A
   70.28  ><H2
   70.29  >Synopsis</H2
   70.30  ><DIV
   70.31  CLASS="FUNCSYNOPSIS"
   70.32  ><A
   70.33 -NAME="AEN5191"
   70.34 +NAME="AEN5266"
   70.35  ></A
   70.36  ><P
   70.37  ></P
   70.38 @@ -112,7 +112,7 @@
   70.39  ><DIV
   70.40  CLASS="REFSECT1"
   70.41  ><A
   70.42 -NAME="AEN5197"
   70.43 +NAME="AEN5272"
   70.44  ></A
   70.45  ><H2
   70.46  >Description</H2
   70.47 @@ -143,7 +143,7 @@
   70.48  ><DIV
   70.49  CLASS="REFSECT1"
   70.50  ><A
   70.51 -NAME="AEN5205"
   70.52 +NAME="AEN5280"
   70.53  ></A
   70.54  ><H2
   70.55  >Return Value</H2
   70.56 @@ -153,7 +153,7 @@
   70.57  ><DIV
   70.58  CLASS="REFSECT1"
   70.59  ><A
   70.60 -NAME="AEN5208"
   70.61 +NAME="AEN5283"
   70.62  ></A
   70.63  ><H2
   70.64  >See Also</H2
    71.1 --- a/docs/html/sdlevent.html	Sun Jun 10 18:39:47 2001 +0000
    71.2 +++ b/docs/html/sdlevent.html	Sun Jun 10 19:31:57 2001 +0000
    71.3 @@ -4,7 +4,7 @@
    71.4  >SDL_Event</TITLE
    71.5  ><META
    71.6  NAME="GENERATOR"
    71.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    71.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    71.9  "><LINK
   71.10  REL="HOME"
   71.11  TITLE="SDL Library Documentation"
   71.12 @@ -73,7 +73,7 @@
   71.13  ><DIV
   71.14  CLASS="REFNAMEDIV"
   71.15  ><A
   71.16 -NAME="AEN3214"
   71.17 +NAME="AEN3289"
   71.18  ></A
   71.19  ><H2
   71.20  >Name</H2
   71.21 @@ -81,7 +81,7 @@
   71.22  ><DIV
   71.23  CLASS="REFSECT1"
   71.24  ><A
   71.25 -NAME="AEN3217"
   71.26 +NAME="AEN3292"
   71.27  ></A
   71.28  ><H2
   71.29  >Structure Definition</H2
   71.30 @@ -106,14 +106,14 @@
   71.31  ><DIV
   71.32  CLASS="REFSECT1"
   71.33  ><A
   71.34 -NAME="AEN3220"
   71.35 +NAME="AEN3295"
   71.36  ></A
   71.37  ><H2
   71.38  >Structure Data</H2
   71.39  ><DIV
   71.40  CLASS="INFORMALTABLE"
   71.41  ><A
   71.42 -NAME="AEN3222"
   71.43 +NAME="AEN3297"
   71.44  ></A
   71.45  ><P
   71.46  ></P
   71.47 @@ -361,7 +361,7 @@
   71.48  ><DIV
   71.49  CLASS="REFSECT1"
   71.50  ><A
   71.51 -NAME="AEN3289"
   71.52 +NAME="AEN3364"
   71.53  ></A
   71.54  ><H2
   71.55  >Description</H2
   71.56 @@ -385,7 +385,7 @@
   71.57  ><DIV
   71.58  CLASS="INFORMALTABLE"
   71.59  ><A
   71.60 -NAME="AEN3297"
   71.61 +NAME="AEN3372"
   71.62  ></A
   71.63  ><P
   71.64  ></P
   71.65 @@ -648,7 +648,7 @@
   71.66  ><DIV
   71.67  CLASS="REFSECT1"
   71.68  ><A
   71.69 -NAME="AEN3377"
   71.70 +NAME="AEN3452"
   71.71  ></A
   71.72  ><H2
   71.73  >Use</H2
   71.74 @@ -853,7 +853,7 @@
   71.75  ><DIV
   71.76  CLASS="REFSECT1"
   71.77  ><A
   71.78 -NAME="AEN3434"
   71.79 +NAME="AEN3509"
   71.80  ></A
   71.81  ><H2
   71.82  >See Also</H2
    72.1 --- a/docs/html/sdleventstate.html	Sun Jun 10 18:39:47 2001 +0000
    72.2 +++ b/docs/html/sdleventstate.html	Sun Jun 10 19:31:57 2001 +0000
    72.3 @@ -4,7 +4,7 @@
    72.4  >SDL_EventState</TITLE
    72.5  ><META
    72.6  NAME="GENERATOR"
    72.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    72.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    72.9  "><LINK
   72.10  REL="HOME"
   72.11  TITLE="SDL Library Documentation"
   72.12 @@ -73,7 +73,7 @@
   72.13  ><DIV
   72.14  CLASS="REFNAMEDIV"
   72.15  ><A
   72.16 -NAME="AEN5028"
   72.17 +NAME="AEN5103"
   72.18  ></A
   72.19  ><H2
   72.20  >Name</H2
   72.21 @@ -81,14 +81,14 @@
   72.22  ><DIV
   72.23  CLASS="REFSYNOPSISDIV"
   72.24  ><A
   72.25 -NAME="AEN5031"
   72.26 +NAME="AEN5106"
   72.27  ></A
   72.28  ><H2
   72.29  >Synopsis</H2
   72.30  ><DIV
   72.31  CLASS="FUNCSYNOPSIS"
   72.32  ><A
   72.33 -NAME="AEN5032"
   72.34 +NAME="AEN5107"
   72.35  ></A
   72.36  ><P
   72.37  ></P
   72.38 @@ -112,7 +112,7 @@
   72.39  ><DIV
   72.40  CLASS="REFSECT1"
   72.41  ><A
   72.42 -NAME="AEN5038"
   72.43 +NAME="AEN5113"
   72.44  ></A
   72.45  ><H2
   72.46  >Description</H2
   72.47 @@ -193,7 +193,7 @@
   72.48  ><DIV
   72.49  CLASS="REFSECT1"
   72.50  ><A
   72.51 -NAME="AEN5059"
   72.52 +NAME="AEN5134"
   72.53  ></A
   72.54  ><H2
   72.55  >See Also</H2
    73.1 --- a/docs/html/sdlfillrect.html	Sun Jun 10 18:39:47 2001 +0000
    73.2 +++ b/docs/html/sdlfillrect.html	Sun Jun 10 19:31:57 2001 +0000
    73.3 @@ -4,7 +4,7 @@
    73.4  >SDL_FillRect</TITLE
    73.5  ><META
    73.6  NAME="GENERATOR"
    73.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    73.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    73.9  "><LINK
   73.10  REL="HOME"
   73.11  TITLE="SDL Library Documentation"
   73.12 @@ -73,7 +73,7 @@
   73.13  ><DIV
   73.14  CLASS="REFNAMEDIV"
   73.15  ><A
   73.16 -NAME="AEN1858"
   73.17 +NAME="AEN1935"
   73.18  ></A
   73.19  ><H2
   73.20  >Name</H2
   73.21 @@ -81,14 +81,14 @@
   73.22  ><DIV
   73.23  CLASS="REFSYNOPSISDIV"
   73.24  ><A
   73.25 -NAME="AEN1861"
   73.26 +NAME="AEN1938"
   73.27  ></A
   73.28  ><H2
   73.29  >Synopsis</H2
   73.30  ><DIV
   73.31  CLASS="FUNCSYNOPSIS"
   73.32  ><A
   73.33 -NAME="AEN1862"
   73.34 +NAME="AEN1939"
   73.35  ></A
   73.36  ><P
   73.37  ></P
   73.38 @@ -112,7 +112,7 @@
   73.39  ><DIV
   73.40  CLASS="REFSECT1"
   73.41  ><A
   73.42 -NAME="AEN1868"
   73.43 +NAME="AEN1945"
   73.44  ></A
   73.45  ><H2
   73.46  >Description</H2
   73.47 @@ -164,7 +164,7 @@
   73.48  ><DIV
   73.49  CLASS="REFSECT1"
   73.50  ><A
   73.51 -NAME="AEN1880"
   73.52 +NAME="AEN1957"
   73.53  ></A
   73.54  ><H2
   73.55  >Return Value</H2
   73.56 @@ -181,7 +181,7 @@
   73.57  ><DIV
   73.58  CLASS="REFSECT1"
   73.59  ><A
   73.60 -NAME="AEN1885"
   73.61 +NAME="AEN1962"
   73.62  ></A
   73.63  ><H2
   73.64  >See Also</H2
    74.1 --- a/docs/html/sdlflip.html	Sun Jun 10 18:39:47 2001 +0000
    74.2 +++ b/docs/html/sdlflip.html	Sun Jun 10 19:31:57 2001 +0000
    74.3 @@ -4,7 +4,7 @@
    74.4  >SDL_Flip</TITLE
    74.5  ><META
    74.6  NAME="GENERATOR"
    74.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    74.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    74.9  "><LINK
   74.10  REL="HOME"
   74.11  TITLE="SDL Library Documentation"
   74.12 @@ -73,7 +73,7 @@
   74.13  ><DIV
   74.14  CLASS="REFNAMEDIV"
   74.15  ><A
   74.16 -NAME="AEN969"
   74.17 +NAME="AEN1011"
   74.18  ></A
   74.19  ><H2
   74.20  >Name</H2
   74.21 @@ -81,14 +81,14 @@
   74.22  ><DIV
   74.23  CLASS="REFSYNOPSISDIV"
   74.24  ><A
   74.25 -NAME="AEN972"
   74.26 +NAME="AEN1014"
   74.27  ></A
   74.28  ><H2
   74.29  >Synopsis</H2
   74.30  ><DIV
   74.31  CLASS="FUNCSYNOPSIS"
   74.32  ><A
   74.33 -NAME="AEN973"
   74.34 +NAME="AEN1015"
   74.35  ></A
   74.36  ><P
   74.37  ></P
   74.38 @@ -112,7 +112,7 @@
   74.39  ><DIV
   74.40  CLASS="REFSECT1"
   74.41  ><A
   74.42 -NAME="AEN979"
   74.43 +NAME="AEN1021"
   74.44  ></A
   74.45  ><H2
   74.46  >Description</H2
   74.47 @@ -145,7 +145,7 @@
   74.48  ><DIV
   74.49  CLASS="REFSECT1"
   74.50  ><A
   74.51 -NAME="AEN987"
   74.52 +NAME="AEN1029"
   74.53  ></A
   74.54  ><H2
   74.55  >Return Value</H2
   74.56 @@ -162,7 +162,7 @@
   74.57  ><DIV
   74.58  CLASS="REFSECT1"
   74.59  ><A
   74.60 -NAME="AEN992"
   74.61 +NAME="AEN1034"
   74.62  ></A
   74.63  ><H2
   74.64  >See Also</H2
    75.1 --- a/docs/html/sdlfreecursor.html	Sun Jun 10 18:39:47 2001 +0000
    75.2 +++ b/docs/html/sdlfreecursor.html	Sun Jun 10 19:31:57 2001 +0000
    75.3 @@ -4,7 +4,7 @@
    75.4  >SDL_FreeCursor</TITLE
    75.5  ><META
    75.6  NAME="GENERATOR"
    75.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    75.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    75.9  "><LINK
   75.10  REL="HOME"
   75.11  TITLE="SDL Library Documentation"
   75.12 @@ -73,7 +73,7 @@
   75.13  ><DIV
   75.14  CLASS="REFNAMEDIV"
   75.15  ><A
   75.16 -NAME="AEN2042"
   75.17 +NAME="AEN2121"
   75.18  ></A
   75.19  ><H2
   75.20  >Name</H2
   75.21 @@ -81,14 +81,14 @@
   75.22  ><DIV
   75.23  CLASS="REFSYNOPSISDIV"
   75.24  ><A
   75.25 -NAME="AEN2045"
   75.26 +NAME="AEN2124"
   75.27  ></A
   75.28  ><H2
   75.29  >Synopsis</H2
   75.30  ><DIV
   75.31  CLASS="FUNCSYNOPSIS"
   75.32  ><A
   75.33 -NAME="AEN2046"
   75.34 +NAME="AEN2125"
   75.35  ></A
   75.36  ><P
   75.37  ></P
   75.38 @@ -112,7 +112,7 @@
   75.39  ><DIV
   75.40  CLASS="REFSECT1"
   75.41  ><A
   75.42 -NAME="AEN2052"
   75.43 +NAME="AEN2131"
   75.44  ></A
   75.45  ><H2
   75.46  >Description</H2
   75.47 @@ -129,7 +129,7 @@
   75.48  ><DIV
   75.49  CLASS="REFSECT1"
   75.50  ><A
   75.51 -NAME="AEN2057"
   75.52 +NAME="AEN2136"
   75.53  ></A
   75.54  ><H2
   75.55  >See Also</H2
    76.1 --- a/docs/html/sdlfreesurface.html	Sun Jun 10 18:39:47 2001 +0000
    76.2 +++ b/docs/html/sdlfreesurface.html	Sun Jun 10 19:31:57 2001 +0000
    76.3 @@ -4,7 +4,7 @@
    76.4  >SDL_FreeSurface</TITLE
    76.5  ><META
    76.6  NAME="GENERATOR"
    76.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    76.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    76.9  "><LINK
   76.10  REL="HOME"
   76.11  TITLE="SDL Library Documentation"
   76.12 @@ -73,22 +73,22 @@
   76.13  ><DIV
   76.14  CLASS="REFNAMEDIV"
   76.15  ><A
   76.16 -NAME="AEN1409"
   76.17 +NAME="AEN1478"
   76.18  ></A
   76.19  ><H2
   76.20  >Name</H2
   76.21 ->SDL_FreeSurface&nbsp;--&nbsp;Frees (deletes) and SDL_Surface</DIV
   76.22 +>SDL_FreeSurface&nbsp;--&nbsp;Frees (deletes) a SDL_Surface</DIV
   76.23  ><DIV
   76.24  CLASS="REFSYNOPSISDIV"
   76.25  ><A
   76.26 -NAME="AEN1412"
   76.27 +NAME="AEN1481"
   76.28  ></A
   76.29  ><H2
   76.30  >Synopsis</H2
   76.31  ><DIV
   76.32  CLASS="FUNCSYNOPSIS"
   76.33  ><A
   76.34 -NAME="AEN1413"
   76.35 +NAME="AEN1482"
   76.36  ></A
   76.37  ><P
   76.38  ></P
   76.39 @@ -112,7 +112,7 @@
   76.40  ><DIV
   76.41  CLASS="REFSECT1"
   76.42  ><A
   76.43 -NAME="AEN1419"
   76.44 +NAME="AEN1488"
   76.45  ></A
   76.46  ><H2
   76.47  >Description</H2
   76.48 @@ -129,7 +129,7 @@
   76.49  ><DIV
   76.50  CLASS="REFSECT1"
   76.51  ><A
   76.52 -NAME="AEN1424"
   76.53 +NAME="AEN1493"
   76.54  ></A
   76.55  ><H2
   76.56  >See Also</H2
    77.1 --- a/docs/html/sdlfreewav.html	Sun Jun 10 18:39:47 2001 +0000
    77.2 +++ b/docs/html/sdlfreewav.html	Sun Jun 10 19:31:57 2001 +0000
    77.3 @@ -4,7 +4,7 @@
    77.4  >SDL_FreeWAV</TITLE
    77.5  ><META
    77.6  NAME="GENERATOR"
    77.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    77.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    77.9  "><LINK
   77.10  REL="HOME"
   77.11  TITLE="SDL Library Documentation"
   77.12 @@ -73,7 +73,7 @@
   77.13  ><DIV
   77.14  CLASS="REFNAMEDIV"
   77.15  ><A
   77.16 -NAME="AEN6235"
   77.17 +NAME="AEN6310"
   77.18  ></A
   77.19  ><H2
   77.20  >Name</H2
   77.21 @@ -81,14 +81,14 @@
   77.22  ><DIV
   77.23  CLASS="REFSYNOPSISDIV"
   77.24  ><A
   77.25 -NAME="AEN6238"
   77.26 +NAME="AEN6313"
   77.27  ></A
   77.28  ><H2
   77.29  >Synopsis</H2
   77.30  ><DIV
   77.31  CLASS="FUNCSYNOPSIS"
   77.32  ><A
   77.33 -NAME="AEN6239"
   77.34 +NAME="AEN6314"
   77.35  ></A
   77.36  ><P
   77.37  ></P
   77.38 @@ -112,7 +112,7 @@
   77.39  ><DIV
   77.40  CLASS="REFSECT1"
   77.41  ><A
   77.42 -NAME="AEN6245"
   77.43 +NAME="AEN6320"
   77.44  ></A
   77.45  ><H2
   77.46  >Description</H2
   77.47 @@ -139,7 +139,7 @@
   77.48  ><DIV
   77.49  CLASS="REFSECT1"
   77.50  ><A
   77.51 -NAME="AEN6253"
   77.52 +NAME="AEN6328"
   77.53  ></A
   77.54  ><H2
   77.55  >See Also</H2
    78.1 --- a/docs/html/sdlfreeyuvoverlay.html	Sun Jun 10 18:39:47 2001 +0000
    78.2 +++ b/docs/html/sdlfreeyuvoverlay.html	Sun Jun 10 19:31:57 2001 +0000
    78.3 @@ -4,7 +4,7 @@
    78.4  >SDL_FreeYUVOverlay</TITLE
    78.5  ><META
    78.6  NAME="GENERATOR"
    78.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    78.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    78.9  "><LINK
   78.10  REL="HOME"
   78.11  TITLE="SDL Library Documentation"
   78.12 @@ -73,7 +73,7 @@
   78.13  ><DIV
   78.14  CLASS="REFNAMEDIV"
   78.15  ><A
   78.16 -NAME="AEN2440"
   78.17 +NAME="AEN2519"
   78.18  ></A
   78.19  ><H2
   78.20  >Name</H2
   78.21 @@ -81,14 +81,14 @@
   78.22  ><DIV
   78.23  CLASS="REFSYNOPSISDIV"
   78.24  ><A
   78.25 -NAME="AEN2443"
   78.26 +NAME="AEN2522"
   78.27  ></A
   78.28  ><H2
   78.29  >Synopsis</H2
   78.30  ><DIV
   78.31  CLASS="FUNCSYNOPSIS"
   78.32  ><A
   78.33 -NAME="AEN2444"
   78.34 +NAME="AEN2523"
   78.35  ></A
   78.36  ><P
   78.37  ></P
   78.38 @@ -112,7 +112,7 @@
   78.39  ><DIV
   78.40  CLASS="REFSECT1"
   78.41  ><A
   78.42 -NAME="AEN2450"
   78.43 +NAME="AEN2529"
   78.44  ></A
   78.45  ><H2
   78.46  >Description</H2
   78.47 @@ -136,7 +136,7 @@
   78.48  ><DIV
   78.49  CLASS="REFSECT1"
   78.50  ><A
   78.51 -NAME="AEN2457"
   78.52 +NAME="AEN2536"
   78.53  ></A
   78.54  ><H2
   78.55  >See Also</H2
    79.1 --- a/docs/html/sdlgetappstate.html	Sun Jun 10 18:39:47 2001 +0000
    79.2 +++ b/docs/html/sdlgetappstate.html	Sun Jun 10 19:31:57 2001 +0000
    79.3 @@ -4,7 +4,7 @@
    79.4  >SDL_GetAppState</TITLE
    79.5  ><META
    79.6  NAME="GENERATOR"
    79.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    79.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    79.9  "><LINK
   79.10  REL="HOME"
   79.11  TITLE="SDL Library Documentation"
   79.12 @@ -73,7 +73,7 @@
   79.13  ><DIV
   79.14  CLASS="REFNAMEDIV"
   79.15  ><A
   79.16 -NAME="AEN5309"
   79.17 +NAME="AEN5384"
   79.18  ></A
   79.19  ><H2
   79.20  >Name</H2
   79.21 @@ -84,14 +84,14 @@
   79.22  ><DIV
   79.23  CLASS="REFSYNOPSISDIV"
   79.24  ><A
   79.25 -NAME="AEN5313"
   79.26 +NAME="AEN5388"
   79.27  ></A
   79.28  ><H2
   79.29  >Synopsis</H2
   79.30  ><DIV
   79.31  CLASS="FUNCSYNOPSIS"
   79.32  ><A
   79.33 -NAME="AEN5314"
   79.34 +NAME="AEN5389"
   79.35  ></A
   79.36  ><P
   79.37  ></P
   79.38 @@ -115,7 +115,7 @@
   79.39  ><DIV
   79.40  CLASS="REFSECT1"
   79.41  ><A
   79.42 -NAME="AEN5320"
   79.43 +NAME="AEN5395"
   79.44  ></A
   79.45  ><H2
   79.46  >Description</H2
   79.47 @@ -124,7 +124,7 @@
   79.48  ><DIV
   79.49  CLASS="INFORMALTABLE"
   79.50  ><A
   79.51 -NAME="AEN5323"
   79.52 +NAME="AEN5398"
   79.53  ></A
   79.54  ><P
   79.55  ></P
   79.56 @@ -180,7 +180,7 @@
   79.57  ><DIV
   79.58  CLASS="REFSECT1"
   79.59  ><A
   79.60 -NAME="AEN5338"
   79.61 +NAME="AEN5413"
   79.62  ></A
   79.63  ><H2
   79.64  >See Also</H2
    80.1 --- a/docs/html/sdlgetaudiostatus.html	Sun Jun 10 18:39:47 2001 +0000
    80.2 +++ b/docs/html/sdlgetaudiostatus.html	Sun Jun 10 19:31:57 2001 +0000
    80.3 @@ -4,7 +4,7 @@
    80.4  >SDL_GetAudioStatus</TITLE
    80.5  ><META
    80.6  NAME="GENERATOR"
    80.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    80.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    80.9  "><LINK
   80.10  REL="HOME"
   80.11  TITLE="SDL Library Documentation"
   80.12 @@ -73,7 +73,7 @@
   80.13  ><DIV
   80.14  CLASS="REFNAMEDIV"
   80.15  ><A
   80.16 -NAME="AEN6168"
   80.17 +NAME="AEN6243"
   80.18  ></A
   80.19  ><H2
   80.20  >Name</H2
   80.21 @@ -81,14 +81,14 @@
   80.22  ><DIV
   80.23  CLASS="REFSYNOPSISDIV"
   80.24  ><A
   80.25 -NAME="AEN6171"
   80.26 +NAME="AEN6246"
   80.27  ></A
   80.28  ><H2
   80.29  >Synopsis</H2
   80.30  ><DIV
   80.31  CLASS="FUNCSYNOPSIS"
   80.32  ><A
   80.33 -NAME="AEN6172"
   80.34 +NAME="AEN6247"
   80.35  ></A
   80.36  ><P
   80.37  ></P
   80.38 @@ -112,7 +112,7 @@
   80.39  ><DIV
   80.40  CLASS="REFSECT1"
   80.41  ><A
   80.42 -NAME="AEN6178"
   80.43 +NAME="AEN6253"
   80.44  ></A
   80.45  ><H2
   80.46  >Description</H2
   80.47 @@ -138,7 +138,7 @@
   80.48  ><DIV
   80.49  CLASS="REFSECT1"
   80.50  ><A
   80.51 -NAME="AEN6185"
   80.52 +NAME="AEN6260"
   80.53  ></A
   80.54  ><H2
   80.55  >See Also</H2
    81.1 --- a/docs/html/sdlgetcliprect.html	Sun Jun 10 18:39:47 2001 +0000
    81.2 +++ b/docs/html/sdlgetcliprect.html	Sun Jun 10 19:31:57 2001 +0000
    81.3 @@ -4,7 +4,7 @@
    81.4  >SDL_GetClipRect</TITLE
    81.5  ><META
    81.6  NAME="GENERATOR"
    81.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    81.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    81.9  "><LINK
   81.10  REL="HOME"
   81.11  TITLE="SDL Library Documentation"
   81.12 @@ -73,7 +73,7 @@
   81.13  ><DIV
   81.14  CLASS="REFNAMEDIV"
   81.15  ><A
   81.16 -NAME="AEN1738"
   81.17 +NAME="AEN1815"
   81.18  ></A
   81.19  ><H2
   81.20  >Name</H2
   81.21 @@ -81,14 +81,14 @@
   81.22  ><DIV
   81.23  CLASS="REFSYNOPSISDIV"
   81.24  ><A
   81.25 -NAME="AEN1741"
   81.26 +NAME="AEN1818"
   81.27  ></A
   81.28  ><H2
   81.29  >Synopsis</H2
   81.30  ><DIV
   81.31  CLASS="FUNCSYNOPSIS"
   81.32  ><A
   81.33 -NAME="AEN1742"
   81.34 +NAME="AEN1819"
   81.35  ></A
   81.36  ><P
   81.37  ></P
   81.38 @@ -112,7 +112,7 @@
   81.39  ><DIV
   81.40  CLASS="REFSECT1"
   81.41  ><A
   81.42 -NAME="AEN1748"
   81.43 +NAME="AEN1825"
   81.44  ></A
   81.45  ><H2
   81.46  >Description</H2
   81.47 @@ -132,7 +132,7 @@
   81.48  ><DIV
   81.49  CLASS="REFSECT1"
   81.50  ><A
   81.51 -NAME="AEN1753"
   81.52 +NAME="AEN1830"
   81.53  ></A
   81.54  ><H2
   81.55  >See Also</H2
    82.1 --- a/docs/html/sdlgetcursor.html	Sun Jun 10 18:39:47 2001 +0000
    82.2 +++ b/docs/html/sdlgetcursor.html	Sun Jun 10 19:31:57 2001 +0000
    82.3 @@ -4,7 +4,7 @@
    82.4  >SDL_GetCursor</TITLE
    82.5  ><META
    82.6  NAME="GENERATOR"
    82.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    82.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    82.9  "><LINK
   82.10  REL="HOME"
   82.11  TITLE="SDL Library Documentation"
   82.12 @@ -73,7 +73,7 @@
   82.13  ><DIV
   82.14  CLASS="REFNAMEDIV"
   82.15  ><A
   82.16 -NAME="AEN2091"
   82.17 +NAME="AEN2170"
   82.18  ></A
   82.19  ><H2
   82.20  >Name</H2
   82.21 @@ -81,14 +81,14 @@
   82.22  ><DIV
   82.23  CLASS="REFSYNOPSISDIV"
   82.24  ><A
   82.25 -NAME="AEN2094"
   82.26 +NAME="AEN2173"
   82.27  ></A
   82.28  ><H2
   82.29  >Synopsis</H2
   82.30  ><DIV
   82.31  CLASS="FUNCSYNOPSIS"
   82.32  ><A
   82.33 -NAME="AEN2095"
   82.34 +NAME="AEN2174"
   82.35  ></A
   82.36  ><P
   82.37  ></P
   82.38 @@ -112,7 +112,7 @@
   82.39  ><DIV
   82.40  CLASS="REFSECT1"
   82.41  ><A
   82.42 -NAME="AEN2101"
   82.43 +NAME="AEN2180"
   82.44  ></A
   82.45  ><H2
   82.46  >Description</H2
   82.47 @@ -122,7 +122,7 @@
   82.48  ><DIV
   82.49  CLASS="REFSECT1"
   82.50  ><A
   82.51 -NAME="AEN2104"
   82.52 +NAME="AEN2183"
   82.53  ></A
   82.54  ><H2
   82.55  >See Also</H2
    83.1 --- a/docs/html/sdlgeteventfilter.html	Sun Jun 10 18:39:47 2001 +0000
    83.2 +++ b/docs/html/sdlgeteventfilter.html	Sun Jun 10 19:31:57 2001 +0000
    83.3 @@ -4,7 +4,7 @@
    83.4  >SDL_GetEventFilter</TITLE
    83.5  ><META
    83.6  NAME="GENERATOR"
    83.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    83.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    83.9  "><LINK
   83.10  REL="HOME"
   83.11  TITLE="SDL Library Documentation"
   83.12 @@ -73,7 +73,7 @@
   83.13  ><DIV
   83.14  CLASS="REFNAMEDIV"
   83.15  ><A
   83.16 -NAME="AEN4997"
   83.17 +NAME="AEN5072"
   83.18  ></A
   83.19  ><H2
   83.20  >Name</H2
   83.21 @@ -81,14 +81,14 @@
   83.22  ><DIV
   83.23  CLASS="REFSYNOPSISDIV"
   83.24  ><A
   83.25 -NAME="AEN5000"
   83.26 +NAME="AEN5075"
   83.27  ></A
   83.28  ><H2
   83.29  >Synopsis</H2
   83.30  ><DIV
   83.31  CLASS="FUNCSYNOPSIS"
   83.32  ><A
   83.33 -NAME="AEN5001"
   83.34 +NAME="AEN5076"
   83.35  ></A
   83.36  ><P
   83.37  ></P
   83.38 @@ -112,7 +112,7 @@
   83.39  ><DIV
   83.40  CLASS="REFSECT1"
   83.41  ><A
   83.42 -NAME="AEN5007"
   83.43 +NAME="AEN5082"
   83.44  ></A
   83.45  ><H2
   83.46  >Description</H2
   83.47 @@ -132,7 +132,7 @@
   83.48  ><DIV
   83.49  CLASS="REFSECT1"
   83.50  ><A
   83.51 -NAME="AEN5013"
   83.52 +NAME="AEN5088"
   83.53  ></A
   83.54  ><H2
   83.55  >Return Value</H2
   83.56 @@ -145,7 +145,7 @@
   83.57  ><DIV
   83.58  CLASS="REFSECT1"
   83.59  ><A
   83.60 -NAME="AEN5017"
   83.61 +NAME="AEN5092"
   83.62  ></A
   83.63  ><H2
   83.64  >See Also</H2
    84.1 --- a/docs/html/sdlgetgammaramp.html	Sun Jun 10 18:39:47 2001 +0000
    84.2 +++ b/docs/html/sdlgetgammaramp.html	Sun Jun 10 19:31:57 2001 +0000
    84.3 @@ -4,7 +4,7 @@
    84.4  >SDL_GetGammaRamp</TITLE
    84.5  ><META
    84.6  NAME="GENERATOR"
    84.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    84.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    84.9  "><LINK
   84.10  REL="HOME"
   84.11  TITLE="SDL Library Documentation"
   84.12 @@ -73,7 +73,7 @@
   84.13  ><DIV
   84.14  CLASS="REFNAMEDIV"
   84.15  ><A
   84.16 -NAME="AEN1141"
   84.17 +NAME="AEN1183"
   84.18  ></A
   84.19  ><H2
   84.20  >Name</H2
   84.21 @@ -81,14 +81,14 @@
   84.22  ><DIV
   84.23  CLASS="REFSYNOPSISDIV"
   84.24  ><A
   84.25 -NAME="AEN1144"
   84.26 +NAME="AEN1186"
   84.27  ></A
   84.28  ><H2
   84.29  >Synopsis</H2
   84.30  ><DIV
   84.31  CLASS="FUNCSYNOPSIS"
   84.32  ><A
   84.33 -NAME="AEN1145"
   84.34 +NAME="AEN1187"
   84.35  ></A
   84.36  ><P
   84.37  ></P
   84.38 @@ -112,7 +112,7 @@
   84.39  ><DIV
   84.40  CLASS="REFSECT1"
   84.41  ><A
   84.42 -NAME="AEN1151"
   84.43 +NAME="AEN1193"
   84.44  ></A
   84.45  ><H2
   84.46  >Description</H2
   84.47 @@ -125,7 +125,7 @@
   84.48  ><DIV
   84.49  CLASS="REFSECT1"
   84.50  ><A
   84.51 -NAME="AEN1155"
   84.52 +NAME="AEN1197"
   84.53  ></A
   84.54  ><H2
   84.55  >Return Value</H2
   84.56 @@ -135,7 +135,7 @@
   84.57  ><DIV
   84.58  CLASS="REFSECT1"
   84.59  ><A
   84.60 -NAME="AEN1158"
   84.61 +NAME="AEN1200"
   84.62  ></A
   84.63  ><H2
   84.64  >See Also</H2
    85.1 --- a/docs/html/sdlgetkeyname.html	Sun Jun 10 18:39:47 2001 +0000
    85.2 +++ b/docs/html/sdlgetkeyname.html	Sun Jun 10 19:31:57 2001 +0000
    85.3 @@ -4,7 +4,7 @@
    85.4  >SDL_GetKeyName</TITLE
    85.5  ><META
    85.6  NAME="GENERATOR"
    85.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    85.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    85.9  "><LINK
   85.10  REL="HOME"
   85.11  TITLE="SDL Library Documentation"
   85.12 @@ -73,7 +73,7 @@
   85.13  ><DIV
   85.14  CLASS="REFNAMEDIV"
   85.15  ><A
   85.16 -NAME="AEN5162"
   85.17 +NAME="AEN5237"
   85.18  ></A
   85.19  ><H2
   85.20  >Name</H2
   85.21 @@ -81,14 +81,14 @@
   85.22  ><DIV
   85.23  CLASS="REFSYNOPSISDIV"
   85.24  ><A
   85.25 -NAME="AEN5165"
   85.26 +NAME="AEN5240"
   85.27  ></A
   85.28  ><H2
   85.29  >Synopsis</H2
   85.30  ><DIV
   85.31  CLASS="FUNCSYNOPSIS"
   85.32  ><A
   85.33 -NAME="AEN5166"
   85.34 +NAME="AEN5241"
   85.35  ></A
   85.36  ><P
   85.37  ></P
   85.38 @@ -112,7 +112,7 @@
   85.39  ><DIV
   85.40  CLASS="REFSECT1"
   85.41  ><A
   85.42 -NAME="AEN5172"
   85.43 +NAME="AEN5247"
   85.44  ></A
   85.45  ><H2
   85.46  >Description</H2
   85.47 @@ -133,7 +133,7 @@
   85.48  ><DIV
   85.49  CLASS="REFSECT1"
   85.50  ><A
   85.51 -NAME="AEN5178"
   85.52 +NAME="AEN5253"
   85.53  ></A
   85.54  ><H2
   85.55  >See Also</H2
    86.1 --- a/docs/html/sdlgetkeystate.html	Sun Jun 10 18:39:47 2001 +0000
    86.2 +++ b/docs/html/sdlgetkeystate.html	Sun Jun 10 19:31:57 2001 +0000
    86.3 @@ -4,7 +4,7 @@
    86.4  >SDL_GetKeyState</TITLE
    86.5  ><META
    86.6  NAME="GENERATOR"
    86.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    86.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    86.9  "><LINK
   86.10  REL="HOME"
   86.11  TITLE="SDL Library Documentation"
   86.12 @@ -73,7 +73,7 @@
   86.13  ><DIV
   86.14  CLASS="REFNAMEDIV"
   86.15  ><A
   86.16 -NAME="AEN5068"
   86.17 +NAME="AEN5143"
   86.18  ></A
   86.19  ><H2
   86.20  >Name</H2
   86.21 @@ -81,14 +81,14 @@
   86.22  ><DIV
   86.23  CLASS="REFSYNOPSISDIV"
   86.24  ><A
   86.25 -NAME="AEN5071"
   86.26 +NAME="AEN5146"
   86.27  ></A
   86.28  ><H2
   86.29  >Synopsis</H2
   86.30  ><DIV
   86.31  CLASS="FUNCSYNOPSIS"
   86.32  ><A
   86.33 -NAME="AEN5072"
   86.34 +NAME="AEN5147"
   86.35  ></A
   86.36  ><P
   86.37  ></P
   86.38 @@ -112,7 +112,7 @@
   86.39  ><DIV
   86.40  CLASS="REFSECT1"
   86.41  ><A
   86.42 -NAME="AEN5078"
   86.43 +NAME="AEN5153"
   86.44  ></A
   86.45  ><H2
   86.46  >Description</H2
   86.47 @@ -149,7 +149,7 @@
   86.48  ><DIV
   86.49  CLASS="REFSECT1"
   86.50  ><A
   86.51 -NAME="AEN5088"
   86.52 +NAME="AEN5163"
   86.53  ></A
   86.54  ><H2
   86.55  >Example</H2
   86.56 @@ -163,7 +163,7 @@
   86.57  ><DIV
   86.58  CLASS="REFSECT1"
   86.59  ><A
   86.60 -NAME="AEN5092"
   86.61 +NAME="AEN5167"
   86.62  ></A
   86.63  ><H2
   86.64  >See Also</H2
    87.1 --- a/docs/html/sdlgetmodstate.html	Sun Jun 10 18:39:47 2001 +0000
    87.2 +++ b/docs/html/sdlgetmodstate.html	Sun Jun 10 19:31:57 2001 +0000
    87.3 @@ -4,7 +4,7 @@
    87.4  >SDL_GetModState</TITLE
    87.5  ><META
    87.6  NAME="GENERATOR"
    87.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    87.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    87.9  "><LINK
   87.10  REL="HOME"
   87.11  TITLE="SDL Library Documentation"
   87.12 @@ -73,7 +73,7 @@
   87.13  ><DIV
   87.14  CLASS="REFNAMEDIV"
   87.15  ><A
   87.16 -NAME="AEN5103"
   87.17 +NAME="AEN5178"
   87.18  ></A
   87.19  ><H2
   87.20  >Name</H2
   87.21 @@ -81,14 +81,14 @@
   87.22  ><DIV
   87.23  CLASS="REFSYNOPSISDIV"
   87.24  ><A
   87.25 -NAME="AEN5106"
   87.26 +NAME="AEN5181"
   87.27  ></A
   87.28  ><H2
   87.29  >Synopsis</H2
   87.30  ><DIV
   87.31  CLASS="FUNCSYNOPSIS"
   87.32  ><A
   87.33 -NAME="AEN5107"
   87.34 +NAME="AEN5182"
   87.35  ></A
   87.36  ><P
   87.37  ></P
   87.38 @@ -112,7 +112,7 @@
   87.39  ><DIV
   87.40  CLASS="REFSECT1"
   87.41  ><A
   87.42 -NAME="AEN5113"
   87.43 +NAME="AEN5188"
   87.44  ></A
   87.45  ><H2
   87.46  >Description</H2
   87.47 @@ -122,7 +122,7 @@
   87.48  ><DIV
   87.49  CLASS="REFSECT1"
   87.50  ><A
   87.51 -NAME="AEN5116"
   87.52 +NAME="AEN5191"
   87.53  ></A
   87.54  ><H2
   87.55  >Return Value</H2
   87.56 @@ -130,7 +130,7 @@
   87.57  >The return value can be an OR'd combination of the SDLMod enum.</P
   87.58  ><P
   87.59  ><A
   87.60 -NAME="AEN5120"
   87.61 +NAME="AEN5195"
   87.62  ></A
   87.63  ><BLOCKQUOTE
   87.64  CLASS="BLOCKQUOTE"
   87.65 @@ -158,7 +158,7 @@
   87.66  >
   87.67  SDL also defines the following symbols for convenience:
   87.68  <A
   87.69 -NAME="AEN5123"
   87.70 +NAME="AEN5198"
   87.71  ></A
   87.72  ><BLOCKQUOTE
   87.73  CLASS="BLOCKQUOTE"
   87.74 @@ -174,7 +174,7 @@
   87.75  ><DIV
   87.76  CLASS="REFSECT1"
   87.77  ><A
   87.78 -NAME="AEN5125"
   87.79 +NAME="AEN5200"
   87.80  ></A
   87.81  ><H2
   87.82  >See Also</H2
    88.1 --- a/docs/html/sdlgetmousestate.html	Sun Jun 10 18:39:47 2001 +0000
    88.2 +++ b/docs/html/sdlgetmousestate.html	Sun Jun 10 19:31:57 2001 +0000
    88.3 @@ -4,7 +4,7 @@
    88.4  >SDL_GetMouseState</TITLE
    88.5  ><META
    88.6  NAME="GENERATOR"
    88.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    88.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    88.9  "><LINK
   88.10  REL="HOME"
   88.11  TITLE="SDL Library Documentation"
   88.12 @@ -73,7 +73,7 @@
   88.13  ><DIV
   88.14  CLASS="REFNAMEDIV"
   88.15  ><A
   88.16 -NAME="AEN5247"
   88.17 +NAME="AEN5322"
   88.18  ></A
   88.19  ><H2
   88.20  >Name</H2
   88.21 @@ -81,14 +81,14 @@
   88.22  ><DIV
   88.23  CLASS="REFSYNOPSISDIV"
   88.24  ><A
   88.25 -NAME="AEN5250"
   88.26 +NAME="AEN5325"
   88.27  ></A
   88.28  ><H2
   88.29  >Synopsis</H2
   88.30  ><DIV
   88.31  CLASS="FUNCSYNOPSIS"
   88.32  ><A
   88.33 -NAME="AEN5251"
   88.34 +NAME="AEN5326"
   88.35  ></A
   88.36  ><P
   88.37  ></P
   88.38 @@ -112,7 +112,7 @@
   88.39  ><DIV
   88.40  CLASS="REFSECT1"
   88.41  ><A
   88.42 -NAME="AEN5257"
   88.43 +NAME="AEN5332"
   88.44  ></A
   88.45  ><H2
   88.46  >Description</H2
   88.47 @@ -150,7 +150,7 @@
   88.48  ><DIV
   88.49  CLASS="REFSECT1"
   88.50  ><A
   88.51 -NAME="AEN5266"
   88.52 +NAME="AEN5341"
   88.53  ></A
   88.54  ><H2
   88.55  >Example</H2
   88.56 @@ -163,7 +163,7 @@
   88.57  ><DIV
   88.58  CLASS="REFSECT1"
   88.59  ><A
   88.60 -NAME="AEN5269"
   88.61 +NAME="AEN5344"
   88.62  ></A
   88.63  ><H2
   88.64  >See Also</H2
    89.1 --- a/docs/html/sdlgetrelativemousestate.html	Sun Jun 10 18:39:47 2001 +0000
    89.2 +++ b/docs/html/sdlgetrelativemousestate.html	Sun Jun 10 19:31:57 2001 +0000
    89.3 @@ -4,7 +4,7 @@
    89.4  >SDL_GetRelativeMouseState</TITLE
    89.5  ><META
    89.6  NAME="GENERATOR"
    89.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    89.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    89.9  "><LINK
   89.10  REL="HOME"
   89.11  TITLE="SDL Library Documentation"
   89.12 @@ -73,7 +73,7 @@
   89.13  ><DIV
   89.14  CLASS="REFNAMEDIV"
   89.15  ><A
   89.16 -NAME="AEN5280"
   89.17 +NAME="AEN5355"
   89.18  ></A
   89.19  ><H2
   89.20  >Name</H2
   89.21 @@ -81,14 +81,14 @@
   89.22  ><DIV
   89.23  CLASS="REFSYNOPSISDIV"
   89.24  ><A
   89.25 -NAME="AEN5283"
   89.26 +NAME="AEN5358"
   89.27  ></A
   89.28  ><H2
   89.29  >Synopsis</H2
   89.30  ><DIV
   89.31  CLASS="FUNCSYNOPSIS"
   89.32  ><A
   89.33 -NAME="AEN5284"
   89.34 +NAME="AEN5359"
   89.35  ></A
   89.36  ><P
   89.37  ></P
   89.38 @@ -112,7 +112,7 @@
   89.39  ><DIV
   89.40  CLASS="REFSECT1"
   89.41  ><A
   89.42 -NAME="AEN5290"
   89.43 +NAME="AEN5365"
   89.44  ></A
   89.45  ><H2
   89.46  >Description</H2
   89.47 @@ -152,7 +152,7 @@
   89.48  ><DIV
   89.49  CLASS="REFSECT1"
   89.50  ><A
   89.51 -NAME="AEN5300"
   89.52 +NAME="AEN5375"
   89.53  ></A
   89.54  ><H2
   89.55  >See Also</H2
    90.1 --- a/docs/html/sdlgetrgb.html	Sun Jun 10 18:39:47 2001 +0000
    90.2 +++ b/docs/html/sdlgetrgb.html	Sun Jun 10 19:31:57 2001 +0000
    90.3 @@ -4,7 +4,7 @@
    90.4  >SDL_GetRGB</TITLE
    90.5  ><META
    90.6  NAME="GENERATOR"
    90.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    90.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    90.9  "><LINK
   90.10  REL="HOME"
   90.11  TITLE="SDL Library Documentation"
   90.12 @@ -73,7 +73,7 @@
   90.13  ><DIV
   90.14  CLASS="REFNAMEDIV"
   90.15  ><A
   90.16 -NAME="AEN1261"
   90.17 +NAME="AEN1303"
   90.18  ></A
   90.19  ><H2
   90.20  >Name</H2
   90.21 @@ -81,14 +81,14 @@
   90.22  ><DIV
   90.23  CLASS="REFSYNOPSISDIV"
   90.24  ><A
   90.25 -NAME="AEN1264"
   90.26 +NAME="AEN1306"
   90.27  ></A
   90.28  ><H2
   90.29  >Synopsis</H2
   90.30  ><DIV
   90.31  CLASS="FUNCSYNOPSIS"
   90.32  ><A
   90.33 -NAME="AEN1265"
   90.34 +NAME="AEN1307"
   90.35  ></A
   90.36  ><P
   90.37  ></P
   90.38 @@ -112,7 +112,7 @@
   90.39  ><DIV
   90.40  CLASS="REFSECT1"
   90.41  ><A
   90.42 -NAME="AEN1271"
   90.43 +NAME="AEN1313"
   90.44  ></A
   90.45  ><H2
   90.46  >Description</H2
   90.47 @@ -127,7 +127,7 @@
   90.48  ><DIV
   90.49  CLASS="REFSECT1"
   90.50  ><A
   90.51 -NAME="AEN1275"
   90.52 +NAME="AEN1317"
   90.53  ></A
   90.54  ><H2
   90.55  >See Also</H2
    91.1 --- a/docs/html/sdlgetrgba.html	Sun Jun 10 18:39:47 2001 +0000
    91.2 +++ b/docs/html/sdlgetrgba.html	Sun Jun 10 19:31:57 2001 +0000
    91.3 @@ -4,7 +4,7 @@
    91.4  >SDL_GetRGBA</TITLE
    91.5  ><META
    91.6  NAME="GENERATOR"
    91.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    91.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    91.9  "><LINK
   91.10  REL="HOME"
   91.11  TITLE="SDL Library Documentation"
   91.12 @@ -73,7 +73,7 @@
   91.13  ><DIV
   91.14  CLASS="REFNAMEDIV"
   91.15  ><A
   91.16 -NAME="AEN1290"
   91.17 +NAME="AEN1332"
   91.18  ></A
   91.19  ><H2
   91.20  >Name</H2
   91.21 @@ -81,14 +81,14 @@
   91.22  ><DIV
   91.23  CLASS="REFSYNOPSISDIV"
   91.24  ><A
   91.25 -NAME="AEN1293"
   91.26 +NAME="AEN1335"
   91.27  ></A
   91.28  ><H2
   91.29  >Synopsis</H2
   91.30  ><DIV
   91.31  CLASS="FUNCSYNOPSIS"
   91.32  ><A
   91.33 -NAME="AEN1294"
   91.34 +NAME="AEN1336"
   91.35  ></A
   91.36  ><P
   91.37  ></P
   91.38 @@ -112,7 +112,7 @@
   91.39  ><DIV
   91.40  CLASS="REFSECT1"
   91.41  ><A
   91.42 -NAME="AEN1300"
   91.43 +NAME="AEN1342"
   91.44  ></A
   91.45  ><H2
   91.46  >Description</H2
   91.47 @@ -130,7 +130,7 @@
   91.48  ><DIV
   91.49  CLASS="REFSECT1"
   91.50  ><A
   91.51 -NAME="AEN1305"
   91.52 +NAME="AEN1347"
   91.53  ></A
   91.54  ><H2
   91.55  >See Also</H2
    92.1 --- a/docs/html/sdlgetthreadid.html	Sun Jun 10 18:39:47 2001 +0000
    92.2 +++ b/docs/html/sdlgetthreadid.html	Sun Jun 10 19:31:57 2001 +0000
    92.3 @@ -4,7 +4,7 @@
    92.4  >SDL_GetThreadID</TITLE
    92.5  ><META
    92.6  NAME="GENERATOR"
    92.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    92.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    92.9  "><LINK
   92.10  REL="HOME"
   92.11  TITLE="SDL Library Documentation"
   92.12 @@ -73,7 +73,7 @@
   92.13  ><DIV
   92.14  CLASS="REFNAMEDIV"
   92.15  ><A
   92.16 -NAME="AEN7118"
   92.17 +NAME="AEN7194"
   92.18  ></A
   92.19  ><H2
   92.20  >Name</H2
   92.21 @@ -81,14 +81,14 @@
   92.22  ><DIV
   92.23  CLASS="REFSYNOPSISDIV"
   92.24  ><A
   92.25 -NAME="AEN7121"
   92.26 +NAME="AEN7197"
   92.27  ></A
   92.28  ><H2
   92.29  >Synopsis</H2
   92.30  ><DIV
   92.31  CLASS="FUNCSYNOPSIS"
   92.32  ><A
   92.33 -NAME="AEN7122"
   92.34 +NAME="AEN7198"
   92.35  ></A
   92.36  ><P
   92.37  ></P
   92.38 @@ -113,7 +113,7 @@
   92.39  ><DIV
   92.40  CLASS="REFSECT1"
   92.41  ><A
   92.42 -NAME="AEN7128"
   92.43 +NAME="AEN7204"
   92.44  ></A
   92.45  ><H2
   92.46  >Description</H2
   92.47 @@ -129,7 +129,7 @@
   92.48  ><DIV
   92.49  CLASS="REFSECT1"
   92.50  ><A
   92.51 -NAME="AEN7133"
   92.52 +NAME="AEN7209"
   92.53  ></A
   92.54  ><H2
   92.55  >See Also</H2
    93.1 --- a/docs/html/sdlgetticks.html	Sun Jun 10 18:39:47 2001 +0000
    93.2 +++ b/docs/html/sdlgetticks.html	Sun Jun 10 19:31:57 2001 +0000
    93.3 @@ -4,7 +4,7 @@
    93.4  >SDL_GetTicks</TITLE
    93.5  ><META
    93.6  NAME="GENERATOR"
    93.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    93.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    93.9  "><LINK
   93.10  REL="HOME"
   93.11  TITLE="SDL Library Documentation"
   93.12 @@ -73,7 +73,7 @@
   93.13  ><DIV
   93.14  CLASS="REFNAMEDIV"
   93.15  ><A
   93.16 -NAME="AEN7808"
   93.17 +NAME="AEN7884"
   93.18  ></A
   93.19  ><H2
   93.20  >Name</H2
   93.21 @@ -81,14 +81,14 @@
   93.22  ><DIV
   93.23  CLASS="REFSYNOPSISDIV"
   93.24  ><A
   93.25 -NAME="AEN7811"
   93.26 +NAME="AEN7887"
   93.27  ></A
   93.28  ><H2
   93.29  >Synopsis</H2
   93.30  ><DIV
   93.31  CLASS="FUNCSYNOPSIS"
   93.32  ><A
   93.33 -NAME="AEN7812"
   93.34 +NAME="AEN7888"
   93.35  ></A
   93.36  ><P
   93.37  ></P
   93.38 @@ -112,7 +112,7 @@
   93.39  ><DIV
   93.40  CLASS="REFSECT1"
   93.41  ><A
   93.42 -NAME="AEN7818"
   93.43 +NAME="AEN7894"
   93.44  ></A
   93.45  ><H2
   93.46  >Description</H2
   93.47 @@ -123,7 +123,7 @@
   93.48  ><DIV
   93.49  CLASS="REFSECT1"
   93.50  ><A
   93.51 -NAME="AEN7821"
   93.52 +NAME="AEN7897"
   93.53  ></A
   93.54  ><H2
   93.55  >See Also</H2
    94.1 --- a/docs/html/sdlgetvideoinfo.html	Sun Jun 10 18:39:47 2001 +0000
    94.2 +++ b/docs/html/sdlgetvideoinfo.html	Sun Jun 10 19:31:57 2001 +0000
    94.3 @@ -4,7 +4,7 @@
    94.4  >SDL_GetVideoInfo</TITLE
    94.5  ><META
    94.6  NAME="GENERATOR"
    94.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    94.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    94.9  "><LINK
   94.10  REL="HOME"
   94.11  TITLE="SDL Library Documentation"
   94.12 @@ -73,7 +73,7 @@
   94.13  ><DIV
   94.14  CLASS="REFNAMEDIV"
   94.15  ><A
   94.16 -NAME="AEN656"
   94.17 +NAME="AEN695"
   94.18  ></A
   94.19  ><H2
   94.20  >Name</H2
   94.21 @@ -81,14 +81,14 @@
   94.22  ><DIV
   94.23  CLASS="REFSYNOPSISDIV"
   94.24  ><A
   94.25 -NAME="AEN659"
   94.26 +NAME="AEN698"
   94.27  ></A
   94.28  ><H2
   94.29  >Synopsis</H2
   94.30  ><DIV
   94.31  CLASS="FUNCSYNOPSIS"
   94.32  ><A
   94.33 -NAME="AEN660"
   94.34 +NAME="AEN699"
   94.35  ></A
   94.36  ><P
   94.37  ></P
   94.38 @@ -112,7 +112,7 @@
   94.39  ><DIV
   94.40  CLASS="REFSECT1"
   94.41  ><A
   94.42 -NAME="AEN666"
   94.43 +NAME="AEN705"
   94.44  ></A
   94.45  ><H2
   94.46  >Description</H2
   94.47 @@ -136,7 +136,7 @@
   94.48  ><DIV
   94.49  CLASS="REFSECT1"
   94.50  ><A
   94.51 -NAME="AEN672"
   94.52 +NAME="AEN711"
   94.53  ></A
   94.54  ><H2
   94.55  >See Also</H2
    95.1 --- a/docs/html/sdlgetvideosurface.html	Sun Jun 10 18:39:47 2001 +0000
    95.2 +++ b/docs/html/sdlgetvideosurface.html	Sun Jun 10 19:31:57 2001 +0000
    95.3 @@ -4,7 +4,7 @@
    95.4  >SDL_GetVideoSurface</TITLE
    95.5  ><META
    95.6  NAME="GENERATOR"
    95.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    95.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    95.9  "><LINK
   95.10  REL="HOME"
   95.11  TITLE="SDL Library Documentation"
   95.12 @@ -73,7 +73,7 @@
   95.13  ><DIV
   95.14  CLASS="REFNAMEDIV"
   95.15  ><A
   95.16 -NAME="AEN634"
   95.17 +NAME="AEN673"
   95.18  ></A
   95.19  ><H2
   95.20  >Name</H2
   95.21 @@ -81,14 +81,14 @@
   95.22  ><DIV
   95.23  CLASS="REFSYNOPSISDIV"
   95.24  ><A
   95.25 -NAME="AEN637"
   95.26 +NAME="AEN676"
   95.27  ></A
   95.28  ><H2
   95.29  >Synopsis</H2
   95.30  ><DIV
   95.31  CLASS="FUNCSYNOPSIS"
   95.32  ><A
   95.33 -NAME="AEN638"
   95.34 +NAME="AEN677"
   95.35  ></A
   95.36  ><P
   95.37  ></P
   95.38 @@ -112,7 +112,7 @@
   95.39  ><DIV
   95.40  CLASS="REFSECT1"
   95.41  ><A
   95.42 -NAME="AEN644"
   95.43 +NAME="AEN683"
   95.44  ></A
   95.45  ><H2
   95.46  >Description</H2
   95.47 @@ -125,7 +125,7 @@
   95.48  ><DIV
   95.49  CLASS="REFSECT1"
   95.50  ><A
   95.51 -NAME="AEN647"
   95.52 +NAME="AEN686"
   95.53  ></A
   95.54  ><H2
   95.55  >See Also</H2
    96.1 --- a/docs/html/sdlglattr.html	Sun Jun 10 18:39:47 2001 +0000
    96.2 +++ b/docs/html/sdlglattr.html	Sun Jun 10 19:31:57 2001 +0000
    96.3 @@ -4,7 +4,7 @@
    96.4  >SDL_GLattr</TITLE
    96.5  ><META
    96.6  NAME="GENERATOR"
    96.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    96.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    96.9  "><LINK
   96.10  REL="HOME"
   96.11  TITLE="SDL Library Documentation"
   96.12 @@ -73,7 +73,7 @@
   96.13  ><DIV
   96.14  CLASS="REFNAMEDIV"
   96.15  ><A
   96.16 -NAME="AEN2470"
   96.17 +NAME="AEN2549"
   96.18  ></A
   96.19  ><H2
   96.20  >Name</H2
   96.21 @@ -81,14 +81,14 @@
   96.22  ><DIV
   96.23  CLASS="REFSECT1"
   96.24  ><A
   96.25 -NAME="AEN2473"
   96.26 +NAME="AEN2552"
   96.27  ></A
   96.28  ><H2
   96.29  >Attributes</H2
   96.30  ><DIV
   96.31  CLASS="INFORMALTABLE"
   96.32  ><A
   96.33 -NAME="AEN2475"
   96.34 +NAME="AEN2554"
   96.35  ></A
   96.36  ><P
   96.37  ></P
   96.38 @@ -261,7 +261,7 @@
   96.39  ><DIV
   96.40  CLASS="REFSECT1"
   96.41  ><A
   96.42 -NAME="AEN2526"
   96.43 +NAME="AEN2605"
   96.44  ></A
   96.45  ><H2
   96.46  >Description</H2
   96.47 @@ -286,7 +286,7 @@
   96.48  ><DIV
   96.49  CLASS="REFSECT1"
   96.50  ><A
   96.51 -NAME="AEN2534"
   96.52 +NAME="AEN2613"
   96.53  ></A
   96.54  ><H2
   96.55  >See Also</H2
    97.1 --- a/docs/html/sdlglgetattribute.html	Sun Jun 10 18:39:47 2001 +0000
    97.2 +++ b/docs/html/sdlglgetattribute.html	Sun Jun 10 19:31:57 2001 +0000
    97.3 @@ -4,7 +4,7 @@
    97.4  >SDL_GL_GetAttribute</TITLE
    97.5  ><META
    97.6  NAME="GENERATOR"
    97.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    97.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    97.9  "><LINK
   97.10  REL="HOME"
   97.11  TITLE="SDL Library Documentation"
   97.12 @@ -73,7 +73,7 @@
   97.13  ><DIV
   97.14  CLASS="REFNAMEDIV"
   97.15  ><A
   97.16 -NAME="AEN2210"
   97.17 +NAME="AEN2289"
   97.18  ></A
   97.19  ><H2
   97.20  >Name</H2
   97.21 @@ -81,14 +81,14 @@
   97.22  ><DIV
   97.23  CLASS="REFSYNOPSISDIV"
   97.24  ><A
   97.25 -NAME="AEN2213"
   97.26 +NAME="AEN2292"
   97.27  ></A
   97.28  ><H2
   97.29  >Synopsis</H2
   97.30  ><DIV
   97.31  CLASS="FUNCSYNOPSIS"
   97.32  ><A
   97.33 -NAME="AEN2214"
   97.34 +NAME="AEN2293"
   97.35  ></A
   97.36  ><P
   97.37  ></P
   97.38 @@ -112,7 +112,7 @@
   97.39  ><DIV
   97.40  CLASS="REFSECT1"
   97.41  ><A
   97.42 -NAME="AEN2220"
   97.43 +NAME="AEN2299"
   97.44  ></A
   97.45  ><H2
   97.46  >Description</H2
   97.47 @@ -144,7 +144,7 @@
   97.48  ><DIV
   97.49  CLASS="REFSECT1"
   97.50  ><A
   97.51 -NAME="AEN2229"
   97.52 +NAME="AEN2308"
   97.53  ></A
   97.54  ><H2
   97.55  >Return Value</H2
   97.56 @@ -160,7 +160,7 @@
   97.57  ><DIV
   97.58  CLASS="REFSECT1"
   97.59  ><A
   97.60 -NAME="AEN2234"
   97.61 +NAME="AEN2313"
   97.62  ></A
   97.63  ><H2
   97.64  >See Also</H2
    98.1 --- a/docs/html/sdlglgetprocaddress.html	Sun Jun 10 18:39:47 2001 +0000
    98.2 +++ b/docs/html/sdlglgetprocaddress.html	Sun Jun 10 19:31:57 2001 +0000
    98.3 @@ -4,7 +4,7 @@
    98.4  >SDL_GL_GetProcAddress</TITLE
    98.5  ><META
    98.6  NAME="GENERATOR"
    98.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    98.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    98.9  "><LINK
   98.10  REL="HOME"
   98.11  TITLE="SDL Library Documentation"
   98.12 @@ -73,7 +73,7 @@
   98.13  ><DIV
   98.14  CLASS="REFNAMEDIV"
   98.15  ><A
   98.16 -NAME="AEN2180"
   98.17 +NAME="AEN2259"
   98.18  ></A
   98.19  ><H2
   98.20  >Name</H2
   98.21 @@ -81,14 +81,14 @@
   98.22  ><DIV
   98.23  CLASS="REFSYNOPSISDIV"
   98.24  ><A
   98.25 -NAME="AEN2183"
   98.26 +NAME="AEN2262"
   98.27  ></A
   98.28  ><H2
   98.29  >Synopsis</H2
   98.30  ><DIV
   98.31  CLASS="FUNCSYNOPSIS"
   98.32  ><A
   98.33 -NAME="AEN2184"
   98.34 +NAME="AEN2263"
   98.35  ></A
   98.36  ><P
   98.37  ></P
   98.38 @@ -112,7 +112,7 @@
   98.39  ><DIV
   98.40  CLASS="REFSECT1"
   98.41  ><A
   98.42 -NAME="AEN2190"
   98.43 +NAME="AEN2269"
   98.44  ></A
   98.45  ><H2
   98.46  >Description</H2
   98.47 @@ -139,7 +139,7 @@
   98.48  ><DIV
   98.49  CLASS="REFSECT1"
   98.50  ><A
   98.51 -NAME="AEN2198"
   98.52 +NAME="AEN2277"
   98.53  ></A
   98.54  ><H2
   98.55  >Example</H2
   98.56 @@ -176,7 +176,7 @@
   98.57  ><DIV
   98.58  CLASS="REFSECT1"
   98.59  ><A
   98.60 -NAME="AEN2201"
   98.61 +NAME="AEN2280"
   98.62  ></A
   98.63  ><H2
   98.64  >See Also</H2
    99.1 --- a/docs/html/sdlglloadlibrary.html	Sun Jun 10 18:39:47 2001 +0000
    99.2 +++ b/docs/html/sdlglloadlibrary.html	Sun Jun 10 19:31:57 2001 +0000
    99.3 @@ -4,7 +4,7 @@
    99.4  >SDL_GL_LoadLibrary</TITLE
    99.5  ><META
    99.6  NAME="GENERATOR"
    99.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
    99.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
    99.9  "><LINK
   99.10  REL="HOME"
   99.11  TITLE="SDL Library Documentation"
   99.12 @@ -73,7 +73,7 @@
   99.13  ><DIV
   99.14  CLASS="REFNAMEDIV"
   99.15  ><A
   99.16 -NAME="AEN2150"
   99.17 +NAME="AEN2229"
   99.18  ></A
   99.19  ><H2
   99.20  >Name</H2
   99.21 @@ -81,14 +81,14 @@
   99.22  ><DIV
   99.23  CLASS="REFSYNOPSISDIV"
   99.24  ><A
   99.25 -NAME="AEN2153"
   99.26 +NAME="AEN2232"
   99.27  ></A
   99.28  ><H2
   99.29  >Synopsis</H2
   99.30  ><DIV
   99.31  CLASS="FUNCSYNOPSIS"
   99.32  ><A
   99.33 -NAME="AEN2154"
   99.34 +NAME="AEN2233"
   99.35  ></A
   99.36  ><P
   99.37  ></P
   99.38 @@ -112,7 +112,7 @@
   99.39  ><DIV
   99.40  CLASS="REFSECT1"
   99.41  ><A
   99.42 -NAME="AEN2160"
   99.43 +NAME="AEN2239"
   99.44  ></A
   99.45  ><H2
   99.46  >Description</H2
   99.47 @@ -148,7 +148,7 @@
   99.48  ><DIV
   99.49  CLASS="REFSECT1"
   99.50  ><A
   99.51 -NAME="AEN2171"
   99.52 +NAME="AEN2250"
   99.53  ></A
   99.54  ><H2
   99.55  >See Also</H2
   100.1 --- a/docs/html/sdlglsetattribute.html	Sun Jun 10 18:39:47 2001 +0000
   100.2 +++ b/docs/html/sdlglsetattribute.html	Sun Jun 10 19:31:57 2001 +0000
   100.3 @@ -4,7 +4,7 @@
   100.4  >SDL_GL_SetAttribute</TITLE
   100.5  ><META
   100.6  NAME="GENERATOR"
   100.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
   100.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   100.9  "><LINK
  100.10  REL="HOME"
  100.11  TITLE="SDL Library Documentation"
  100.12 @@ -73,7 +73,7 @@
  100.13  ><DIV
  100.14  CLASS="REFNAMEDIV"
  100.15  ><A
  100.16 -NAME="AEN2244"
  100.17 +NAME="AEN2323"
  100.18  ></A
  100.19  ><H2
  100.20  >Name</H2
  100.21 @@ -81,14 +81,14 @@
  100.22  ><DIV
  100.23  CLASS="REFSYNOPSISDIV"
  100.24  ><A
  100.25 -NAME="AEN2247"
  100.26 +NAME="AEN2326"
  100.27  ></A
  100.28  ><H2
  100.29  >Synopsis</H2
  100.30  ><DIV
  100.31  CLASS="FUNCSYNOPSIS"
  100.32  ><A
  100.33 -NAME="AEN2248"
  100.34 +NAME="AEN2327"
  100.35  ></A
  100.36  ><P
  100.37  ></P
  100.38 @@ -112,7 +112,7 @@
  100.39  ><DIV
  100.40  CLASS="REFSECT1"
  100.41  ><A
  100.42 -NAME="AEN2254"
  100.43 +NAME="AEN2333"
  100.44  ></A
  100.45  ><H2
  100.46  >Description</H2
  100.47 @@ -150,7 +150,7 @@
  100.48  ><DIV
  100.49  CLASS="REFSECT1"
  100.50  ><A
  100.51 -NAME="AEN2265"
  100.52 +NAME="AEN2344"
  100.53  ></A
  100.54  ><H2
  100.55  >Return Value</H2
  100.56 @@ -166,7 +166,7 @@
  100.57  ><DIV
  100.58  CLASS="REFSECT1"
  100.59  ><A
  100.60 -NAME="AEN2270"
  100.61 +NAME="AEN2349"
  100.62  ></A
  100.63  ><H2
  100.64  >Example</H2
  100.65 @@ -199,7 +199,7 @@
  100.66  ><DIV
  100.67  CLASS="REFSECT1"
  100.68  ><A
  100.69 -NAME="AEN2276"
  100.70 +NAME="AEN2355"
  100.71  ></A
  100.72  ><H2
  100.73  >See Also</H2
   101.1 --- a/docs/html/sdlglswapbuffers.html	Sun Jun 10 18:39:47 2001 +0000
   101.2 +++ b/docs/html/sdlglswapbuffers.html	Sun Jun 10 19:31:57 2001 +0000
   101.3 @@ -4,7 +4,7 @@
   101.4  >SDL_GL_SwapBuffers</TITLE
   101.5  ><META
   101.6  NAME="GENERATOR"
   101.7 -CONTENT="Modular DocBook HTML Stylesheet Version 1.61
   101.8 +CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   101.9  "><LINK
  101.10  REL="HOME"
  101.11  TITLE="SDL Library Documentation"
  101.12 @@ -73,7 +73,7 @@
  101.13  ><DIV
  101.14  CLASS="REFNAMEDIV"
  101.15  ><A
  101.16 -NAME="AEN2286"
  101.17 +NAME="AEN2365"
  101.18  ></A
  101.19  ><H2
  101.20  >Name</H2
  101.21 @@ -81,14 +81,14 @@
  101.22  ><DIV
  101.23  CLASS="REFSYNOPSISDIV"
  101.24  ><A
  101.25 -NAME="AEN2289"
  101.26 +NAME="AEN2368"
  101.27  ></A
  101.28  ><H2
  101.29  >Synopsis</H2
  101.30  ><DIV
  101.31  CLASS="FUNCSYNOPSIS"
  101.32  ><A
  101.33 -NAME="AEN2290"
  101.34 +NAME="AEN2369"
  101.35  ></A
  101.36  ><P
  101.37  ></P
  101.38 @@ -112,7 +112,7 @@
  101.39  ><DIV
  101.40  CLASS="REFSECT1"
  101.41  ><A
  101.42 -NAME="AEN2296"
  101.43 +NAME="AEN2375"
  101.44  ></A
  101.45  ><H2
  101.46  >Description</H2
  101.47 @@ -122,7 +122,7 @@
  101.48  ><DIV
  101.49  CLASS="REFSECT1"