From 30dd107dd27d76404da5844cf3f4f77c2848a82e Mon Sep 17 00:00:00 2001
From: Sam Lantinga
Date: Fri, 14 Sep 2001 02:41:09 +0000
Subject: [PATCH] Updated from the SDL Documentation Project
---
docs/html/Makefile.am | 2 +
docs/html/event.html | 6 +-
docs/html/eventfunctions.html | 237 +++++++++++++++++++++++
docs/html/eventstructures.html | 5 +
docs/html/general.html | 5 +
docs/html/guideaudioexamples.html | 2 +-
docs/html/guidebasicsinit.html | 2 +-
docs/html/guidecdromexamples.html | 2 +-
docs/html/guideinput.html | 8 +-
docs/html/guidetimeexamples.html | 22 ++-
docs/html/index.html | 9 +-
docs/html/sdlactiveevent.html | 12 +-
docs/html/sdladdtimer.html | 14 +-
docs/html/sdlaudiocvt.html | 12 +-
docs/html/sdlaudiospec.html | 14 +-
docs/html/sdlblitsurface.html | 12 +-
docs/html/sdlbuildaudiocvt.html | 14 +-
docs/html/sdlcd.html | 14 +-
docs/html/sdlcdclose.html | 10 +-
docs/html/sdlcdeject.html | 12 +-
docs/html/sdlcdname.html | 12 +-
docs/html/sdlcdnumdrives.html | 10 +-
docs/html/sdlcdopen.html | 12 +-
docs/html/sdlcdpause.html | 12 +-
docs/html/sdlcdplay.html | 12 +-
docs/html/sdlcdplaytracks.html | 14 +-
docs/html/sdlcdresume.html | 12 +-
docs/html/sdlcdstatus.html | 12 +-
docs/html/sdlcdstop.html | 12 +-
docs/html/sdlcdtrack.html | 12 +-
docs/html/sdlcloseaudio.html | 10 +-
docs/html/sdlcolor.html | 12 +-
docs/html/sdlcondbroadcast.html | 10 +-
docs/html/sdlcondsignal.html | 10 +-
docs/html/sdlcondwait.html | 10 +-
docs/html/sdlcondwaittimeout.html | 10 +-
docs/html/sdlconvertaudio.html | 12 +-
docs/html/sdlconvertsurface.html | 16 +-
docs/html/sdlcreatecond.html | 12 +-
docs/html/sdlcreatecursor.html | 14 +-
docs/html/sdlcreatemutex.html | 12 +-
docs/html/sdlcreatergbsurface.html | 16 +-
docs/html/sdlcreatergbsurfacefrom.html | 12 +-
docs/html/sdlcreatesemaphore.html | 14 +-
docs/html/sdlcreatethread.html | 10 +-
docs/html/sdlcreateyuvoverlay.html | 10 +-
docs/html/sdldelay.html | 10 +-
docs/html/sdldestroycond.html | 10 +-
docs/html/sdldestroymutex.html | 10 +-
docs/html/sdldestroysemaphore.html | 12 +-
docs/html/sdldisplayformat.html | 12 +-
docs/html/sdldisplayformatalpha.html | 12 +-
docs/html/sdldisplayyuvoverlay.html | 20 +-
docs/html/sdlenablekeyrepeat.html | 10 +-
docs/html/sdlenableunicode.html | 54 ++++--
docs/html/sdlevent.html | 54 +++++-
docs/html/sdleventstate.html | 10 +-
docs/html/sdlexposeevent.html | 244 ++++++++++++++++++++++++
docs/html/sdlfillrect.html | 29 ++-
docs/html/sdlflip.html | 12 +-
docs/html/sdlfreecursor.html | 10 +-
docs/html/sdlfreesurface.html | 10 +-
docs/html/sdlfreewav.html | 10 +-
docs/html/sdlfreeyuvoverlay.html | 10 +-
docs/html/sdlgetappstate.html | 12 +-
docs/html/sdlgetaudiostatus.html | 10 +-
docs/html/sdlgetcliprect.html | 10 +-
docs/html/sdlgetcursor.html | 10 +-
docs/html/sdlgeterror.html | 197 +++++++++++++++++++
docs/html/sdlgeteventfilter.html | 12 +-
docs/html/sdlgetgammaramp.html | 12 +-
docs/html/sdlgetkeyname.html | 10 +-
docs/html/sdlgetkeystate.html | 14 +-
docs/html/sdlgetmodstate.html | 18 +-
docs/html/sdlgetmousestate.html | 12 +-
docs/html/sdlgetrelativemousestate.html | 10 +-
docs/html/sdlgetrgb.html | 10 +-
docs/html/sdlgetrgba.html | 10 +-
docs/html/sdlgetthreadid.html | 10 +-
docs/html/sdlgetticks.html | 10 +-
docs/html/sdlgetvideoinfo.html | 10 +-
docs/html/sdlgetvideosurface.html | 10 +-
docs/html/sdlglattr.html | 10 +-
docs/html/sdlglgetattribute.html | 12 +-
docs/html/sdlglgetprocaddress.html | 12 +-
docs/html/sdlglloadlibrary.html | 10 +-
docs/html/sdlglsetattribute.html | 14 +-
docs/html/sdlglswapbuffers.html | 10 +-
docs/html/sdljoyaxisevent.html | 12 +-
docs/html/sdljoyballevent.html | 12 +-
docs/html/sdljoybuttonevent.html | 12 +-
docs/html/sdljoyhatevent.html | 12 +-
docs/html/sdljoystickclose.html | 10 +-
docs/html/sdljoystickeventstate.html | 12 +-
docs/html/sdljoystickgetaxis.html | 14 +-
docs/html/sdljoystickgetball.html | 14 +-
docs/html/sdljoystickgetbutton.html | 12 +-
docs/html/sdljoystickgethat.html | 12 +-
docs/html/sdljoystickindex.html | 12 +-
docs/html/sdljoystickname.html | 16 +-
docs/html/sdljoysticknumaxes.html | 12 +-
docs/html/sdljoysticknumballs.html | 12 +-
docs/html/sdljoysticknumbuttons.html | 12 +-
docs/html/sdljoysticknumhats.html | 12 +-
docs/html/sdljoystickopen.html | 20 +-
docs/html/sdljoystickopened.html | 12 +-
docs/html/sdljoystickupdate.html | 10 +-
docs/html/sdlkey.html | 6 +-
docs/html/sdlkeyboardevent.html | 12 +-
docs/html/sdlkeysym.html | 12 +-
docs/html/sdlkillthread.html | 10 +-
docs/html/sdllistmodes.html | 12 +-
docs/html/sdlloadbmp.html | 12 +-
docs/html/sdlloadwav.html | 12 +-
docs/html/sdllockaudio.html | 10 +-
docs/html/sdllocksurface.html | 15 +-
docs/html/sdllockyuvoverlay.html | 12 +-
docs/html/sdlmaprgb.html | 12 +-
docs/html/sdlmaprgba.html | 12 +-
docs/html/sdlmixaudio.html | 24 ++-
docs/html/sdlmousebuttonevent.html | 12 +-
docs/html/sdlmousemotionevent.html | 12 +-
docs/html/sdlmutexp.html | 10 +-
docs/html/sdlmutexv.html | 10 +-
docs/html/sdlnumjoysticks.html | 12 +-
docs/html/sdlopenaudio.html | 15 +-
docs/html/sdloverlay.html | 12 +-
docs/html/sdlpalette.html | 12 +-
docs/html/sdlpauseaudio.html | 10 +-
docs/html/sdlpeepevents.html | 12 +-
docs/html/sdlpixelformat.html | 12 +-
docs/html/sdlpollevent.html | 12 +-
docs/html/sdlpumpevents.html | 10 +-
docs/html/sdlpushevent.html | 14 +-
docs/html/sdlquitevent.html | 12 +-
docs/html/sdlrect.html | 12 +-
docs/html/sdlremovetimer.html | 14 +-
docs/html/sdlresizeevent.html | 22 +--
docs/html/sdlsavebmp.html | 12 +-
docs/html/sdlsempost.html | 14 +-
docs/html/sdlsemtrywait.html | 14 +-
docs/html/sdlsemvalue.html | 14 +-
docs/html/sdlsemwait.html | 14 +-
docs/html/sdlsemwaittimeout.html | 14 +-
docs/html/sdlsetalpha.html | 14 +-
docs/html/sdlsetcliprect.html | 10 +-
docs/html/sdlsetcolorkey.html | 12 +-
docs/html/sdlsetcolors.html | 14 +-
docs/html/sdlsetcursor.html | 10 +-
docs/html/sdlseteventfilter.html | 10 +-
docs/html/sdlsetgamma.html | 12 +-
docs/html/sdlsetgammaramp.html | 12 +-
docs/html/sdlsetmodstate.html | 10 +-
docs/html/sdlsetpalette.html | 14 +-
docs/html/sdlsettimer.html | 12 +-
docs/html/sdlsetvideomode.html | 90 +++++++--
docs/html/sdlshowcursor.html | 12 +-
docs/html/sdlsurface.html | 14 +-
docs/html/sdlsyswmevent.html | 18 +-
docs/html/sdlthreadid.html | 8 +-
docs/html/sdlunlockaudio.html | 10 +-
docs/html/sdlunlocksurface.html | 10 +-
docs/html/sdlunlockyuvoverlay.html | 10 +-
docs/html/sdlupdaterect.html | 10 +-
docs/html/sdlupdaterects.html | 10 +-
docs/html/sdluserevent.html | 14 +-
docs/html/sdlvideodrivername.html | 12 +-
docs/html/sdlvideoinfo.html | 12 +-
docs/html/sdlvideomodeok.html | 12 +-
docs/html/sdlwaitevent.html | 10 +-
docs/html/sdlwaitthread.html | 12 +-
docs/html/sdlwarpmouse.html | 10 +-
docs/html/sdlwasinit.html | 10 +-
docs/html/sdlwmgetcaption.html | 10 +-
docs/html/sdlwmgrabinput.html | 10 +-
docs/html/sdlwmiconifywindow.html | 10 +-
docs/html/sdlwmsetcaption.html | 10 +-
docs/html/sdlwmseticon.html | 14 +-
docs/html/sdlwmtogglefullscreen.html | 10 +-
docs/html/thread.html | 2 +-
docs/html/video.html | 10 +-
docs/man3/Makefile.am | 2 +
docs/man3/SDL_ActiveEvent.3 | 4 +-
docs/man3/SDL_AddTimer.3 | 4 +-
docs/man3/SDL_AudioCVT.3 | 4 +-
docs/man3/SDL_AudioSpec.3 | 4 +-
docs/man3/SDL_BlitSurface.3 | 4 +-
docs/man3/SDL_BuildAudioCVT.3 | 4 +-
docs/man3/SDL_CD.3 | 4 +-
docs/man3/SDL_CDClose.3 | 4 +-
docs/man3/SDL_CDEject.3 | 4 +-
docs/man3/SDL_CDName.3 | 4 +-
docs/man3/SDL_CDNumDrives.3 | 4 +-
docs/man3/SDL_CDOpen.3 | 4 +-
docs/man3/SDL_CDPause.3 | 4 +-
docs/man3/SDL_CDPlay.3 | 4 +-
docs/man3/SDL_CDPlayTracks.3 | 4 +-
docs/man3/SDL_CDResume.3 | 4 +-
docs/man3/SDL_CDStatus.3 | 4 +-
docs/man3/SDL_CDStop.3 | 4 +-
docs/man3/SDL_CDtrack.3 | 4 +-
docs/man3/SDL_CloseAudio.3 | 4 +-
docs/man3/SDL_Color.3 | 4 +-
docs/man3/SDL_CondBroadcast.3 | 4 +-
docs/man3/SDL_CondSignal.3 | 4 +-
docs/man3/SDL_CondWait.3 | 4 +-
docs/man3/SDL_CondWaitTimeout.3 | 4 +-
docs/man3/SDL_ConvertAudio.3 | 4 +-
docs/man3/SDL_ConvertSurface.3 | 8 +-
docs/man3/SDL_CreateCond.3 | 4 +-
docs/man3/SDL_CreateCursor.3 | 4 +-
docs/man3/SDL_CreateMutex.3 | 4 +-
docs/man3/SDL_CreateRGBSurface.3 | 4 +-
docs/man3/SDL_CreateRGBSurfaceFrom.3 | 4 +-
docs/man3/SDL_CreateSemaphore.3 | 4 +-
docs/man3/SDL_CreateThread.3 | 4 +-
docs/man3/SDL_CreateYUVOverlay.3 | 4 +-
docs/man3/SDL_Delay.3 | 4 +-
docs/man3/SDL_DestroyCond.3 | 4 +-
docs/man3/SDL_DestroyMutex.3 | 4 +-
docs/man3/SDL_DestroySemaphore.3 | 4 +-
docs/man3/SDL_DisplayFormat.3 | 4 +-
docs/man3/SDL_DisplayFormatAlpha.3 | 4 +-
docs/man3/SDL_DisplayYUVOverlay.3 | 7 +-
docs/man3/SDL_EnableKeyRepeat.3 | 4 +-
docs/man3/SDL_EnableUNICODE.3 | 14 +-
docs/man3/SDL_Event.3 | 11 +-
docs/man3/SDL_EventState.3 | 4 +-
docs/man3/SDL_ExposeEvent.3 | 24 +++
docs/man3/SDL_FillRect.3 | 10 +-
docs/man3/SDL_Flip.3 | 4 +-
docs/man3/SDL_FreeCursor.3 | 4 +-
docs/man3/SDL_FreeSurface.3 | 4 +-
docs/man3/SDL_FreeWAV.3 | 4 +-
docs/man3/SDL_FreeYUVOverlay.3 | 4 +-
docs/man3/SDL_GL_GetAttribute.3 | 4 +-
docs/man3/SDL_GL_GetProcAddress.3 | 4 +-
docs/man3/SDL_GL_LoadLibrary.3 | 4 +-
docs/man3/SDL_GL_SetAttribute.3 | 4 +-
docs/man3/SDL_GL_SwapBuffers.3 | 4 +-
docs/man3/SDL_GLattr.3 | 4 +-
docs/man3/SDL_GetAppState.3 | 4 +-
docs/man3/SDL_GetAudioStatus.3 | 4 +-
docs/man3/SDL_GetClipRect.3 | 4 +-
docs/man3/SDL_GetCursor.3 | 4 +-
docs/man3/SDL_GetError.3 | 15 ++
docs/man3/SDL_GetEventFilter.3 | 4 +-
docs/man3/SDL_GetGamma.3 | 4 +-
docs/man3/SDL_GetGammaRamp.3 | 4 +-
docs/man3/SDL_GetKeyName.3 | 4 +-
docs/man3/SDL_GetKeyState.3 | 6 +-
docs/man3/SDL_GetModState.3 | 6 +-
docs/man3/SDL_GetMouseState.3 | 4 +-
docs/man3/SDL_GetRGB.3 | 4 +-
docs/man3/SDL_GetRGBA.3 | 4 +-
docs/man3/SDL_GetRelativeMouseState.3 | 4 +-
docs/man3/SDL_GetThreadID.3 | 4 +-
docs/man3/SDL_GetTicks.3 | 4 +-
docs/man3/SDL_GetVideoInfo.3 | 4 +-
docs/man3/SDL_GetVideoSurface.3 | 4 +-
docs/man3/SDL_Init.3 | 4 +-
docs/man3/SDL_InitSubSystem.3 | 4 +-
docs/man3/SDL_JoyAxisEvent.3 | 4 +-
docs/man3/SDL_JoyBallEvent.3 | 4 +-
docs/man3/SDL_JoyButtonEvent.3 | 4 +-
docs/man3/SDL_JoyHatEvent.3 | 4 +-
docs/man3/SDL_JoystickClose.3 | 4 +-
docs/man3/SDL_JoystickEventState.3 | 4 +-
docs/man3/SDL_JoystickGetAxis.3 | 4 +-
docs/man3/SDL_JoystickGetBall.3 | 4 +-
docs/man3/SDL_JoystickGetButton.3 | 4 +-
docs/man3/SDL_JoystickGetHat.3 | 4 +-
docs/man3/SDL_JoystickIndex.3 | 4 +-
docs/man3/SDL_JoystickName.3 | 6 +-
docs/man3/SDL_JoystickNumAxes.3 | 4 +-
docs/man3/SDL_JoystickNumBalls.3 | 4 +-
docs/man3/SDL_JoystickNumButtons.3 | 4 +-
docs/man3/SDL_JoystickNumHats.3 | 4 +-
docs/man3/SDL_JoystickOpen.3 | 10 +-
docs/man3/SDL_JoystickOpened.3 | 4 +-
docs/man3/SDL_JoystickUpdate.3 | 4 +-
docs/man3/SDL_KeyboardEvent.3 | 4 +-
docs/man3/SDL_KillThread.3 | 4 +-
docs/man3/SDL_ListModes.3 | 4 +-
docs/man3/SDL_LoadBMP.3 | 4 +-
docs/man3/SDL_LoadWAV.3 | 4 +-
docs/man3/SDL_LockAudio.3 | 4 +-
docs/man3/SDL_LockSurface.3 | 5 +-
docs/man3/SDL_LockYUVOverlay.3 | 4 +-
docs/man3/SDL_MapRGB.3 | 4 +-
docs/man3/SDL_MapRGBA.3 | 4 +-
docs/man3/SDL_MixAudio.3 | 10 +-
docs/man3/SDL_MouseButtonEvent.3 | 4 +-
docs/man3/SDL_MouseMotionEvent.3 | 4 +-
docs/man3/SDL_NumJoysticks.3 | 4 +-
docs/man3/SDL_OpenAudio.3 | 7 +-
docs/man3/SDL_Overlay.3 | 4 +-
docs/man3/SDL_Palette.3 | 4 +-
docs/man3/SDL_PauseAudio.3 | 4 +-
docs/man3/SDL_PeepEvents.3 | 4 +-
docs/man3/SDL_PixelFormat.3 | 4 +-
docs/man3/SDL_PollEvent.3 | 4 +-
docs/man3/SDL_PumpEvents.3 | 4 +-
docs/man3/SDL_PushEvent.3 | 4 +-
docs/man3/SDL_Quit.3 | 4 +-
docs/man3/SDL_QuitEvent.3 | 4 +-
docs/man3/SDL_QuitSubSystem.3 | 4 +-
docs/man3/SDL_RWFromFile.3 | 4 +-
docs/man3/SDL_Rect.3 | 4 +-
docs/man3/SDL_RemoveTimer.3 | 4 +-
docs/man3/SDL_ResizeEvent.3 | 4 +-
docs/man3/SDL_SaveBMP.3 | 4 +-
docs/man3/SDL_SemPost.3 | 4 +-
docs/man3/SDL_SemTryWait.3 | 4 +-
docs/man3/SDL_SemValue.3 | 4 +-
docs/man3/SDL_SemWait.3 | 4 +-
docs/man3/SDL_SemWaitTimeout.3 | 4 +-
docs/man3/SDL_SetAlpha.3 | 4 +-
docs/man3/SDL_SetClipRect.3 | 4 +-
docs/man3/SDL_SetColorKey.3 | 4 +-
docs/man3/SDL_SetColors.3 | 4 +-
docs/man3/SDL_SetCursor.3 | 4 +-
docs/man3/SDL_SetEventFilter.3 | 4 +-
docs/man3/SDL_SetGamma.3 | 4 +-
docs/man3/SDL_SetGammaRamp.3 | 4 +-
docs/man3/SDL_SetModState.3 | 4 +-
docs/man3/SDL_SetPalette.3 | 4 +-
docs/man3/SDL_SetTimer.3 | 4 +-
docs/man3/SDL_SetVideoMode.3 | 24 ++-
docs/man3/SDL_ShowCursor.3 | 4 +-
docs/man3/SDL_Surface.3 | 4 +-
docs/man3/SDL_SysWMEvent.3 | 4 +-
docs/man3/SDL_ThreadID.3 | 4 +-
docs/man3/SDL_UnlockAudio.3 | 4 +-
docs/man3/SDL_UnlockSurface.3 | 4 +-
docs/man3/SDL_UnlockYUVOverlay.3 | 4 +-
docs/man3/SDL_UpdateRect.3 | 4 +-
docs/man3/SDL_UpdateRects.3 | 4 +-
docs/man3/SDL_UserEvent.3 | 4 +-
docs/man3/SDL_VideoDriverName.3 | 4 +-
docs/man3/SDL_VideoInfo.3 | 4 +-
docs/man3/SDL_VideoModeOK.3 | 4 +-
docs/man3/SDL_WM_GetCaption.3 | 4 +-
docs/man3/SDL_WM_GrabInput.3 | 4 +-
docs/man3/SDL_WM_IconifyWindow.3 | 4 +-
docs/man3/SDL_WM_SetCaption.3 | 4 +-
docs/man3/SDL_WM_SetIcon.3 | 6 +-
docs/man3/SDL_WM_ToggleFullScreen.3 | 4 +-
docs/man3/SDL_WaitEvent.3 | 4 +-
docs/man3/SDL_WaitThread.3 | 4 +-
docs/man3/SDL_WarpMouse.3 | 4 +-
docs/man3/SDL_WasInit.3 | 4 +-
docs/man3/SDL_keysym.3 | 4 +-
docs/man3/SDL_mutexP.3 | 4 +-
docs/man3/SDL_mutexV.3 | 4 +-
355 files changed, 2317 insertions(+), 1398 deletions(-)
create mode 100644 docs/html/sdlexposeevent.html
create mode 100644 docs/html/sdlgeterror.html
create mode 100644 docs/man3/SDL_ExposeEvent.3
create mode 100644 docs/man3/SDL_GetError.3
diff --git a/docs/html/Makefile.am b/docs/html/Makefile.am
index 7cb0b99d3..8328d354c 100644
--- a/docs/html/Makefile.am
+++ b/docs/html/Makefile.am
@@ -70,6 +70,7 @@ EXTRA_DIST = \
sdlenableunicode.html \
sdlevent.html \
sdleventstate.html \
+ sdlexposeevent.html \
sdlfillrect.html \
sdlflip.html \
sdlfreecursor.html \
@@ -80,6 +81,7 @@ EXTRA_DIST = \
sdlgetaudiostatus.html \
sdlgetcliprect.html \
sdlgetcursor.html \
+ sdlgeterror.html \
sdlgeteventfilter.html \
sdlgetgammaramp.html \
sdlgetkeyname.html \
diff --git a/docs/html/event.html b/docs/html/event.html
index 69f89a114..d7b29854d 100644
--- a/docs/html/event.html
+++ b/docs/html/event.html
@@ -85,7 +85,7 @@
>IntroductionSDL_Init(SDL_INIT_VIDEO);
-Interally, SDL stores all the events waiting to be handled in an event queue. Using functions like — Enable/disable joystick event polling
SDL_InitSubSystem. ). SDL_Init must be called before any other SDL function. It automatically initializes the Event Handling, File I/O and Threading subsystems and it takes a parameter specifying which other subsystems to initialize. So, to initialize the default subsystems and the Video subsystems you would call:
diff --git a/docs/html/guidecdromexamples.html b/docs/html/guidecdromexamples.html
index 917a1a3c0..8083adb40 100644
--- a/docs/html/guidecdromexamples.html
+++ b/docs/html/guidecdromexamples.html
@@ -201,7 +201,7 @@
// Play first and second track and 10 seconds of third track:
if ( CD_INDRIVE(SDL_CDStatus(cdrom)) )
- SDL_CDPlayTracks(cdrom, 0, 0, 2, 10);
Advanced Joystick FunctionsThat 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:
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 with 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:
SDL_WasInit — Check which subsystems are initializedSDL_GetError — Get SDL error string- Introduction
- 8-1. SDL Keysym definitions