Mercurial > sdl-ios-xcode
view docs/html/sdljoystickeventstate.html @ 2938:2929ed239d2a
Adjusted default choice of audio driver.
If a driver can definitely see available devices, it is chosen. Otherwise,
we'll take the first driver that initializes but saw no devices...this might
be because it can't enumerate them, or there really aren't any available.
This prevents the dsp driver from hogging control when there are no /dev/dsp*
nodes (for example, on a Linux box with ALSA and no OSS emulation).
author | Ryan C. Gordon <icculus@icculus.org> |
---|---|
date | Thu, 01 Jan 2009 07:54:58 +0000 |
parents | 355632dca928 |
children |
line wrap: on
line source
<HTML ><HEAD ><TITLE >SDL_JoystickEventState</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="HOME" TITLE="SDL Library Documentation" HREF="index.html"><LINK REL="UP" TITLE="Event Functions." HREF="eventfunctions.html"><LINK REL="PREVIOUS" TITLE="SDL_GetAppState" HREF="sdlgetappstate.html"><LINK REL="NEXT" TITLE="Joystick" HREF="joystick.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFF8DC" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" ALINK="#ff0000" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >SDL Library Documentation</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="sdlgetappstate.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="joystick.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="SDLJOYSTICKEVENTSTATE" ></A >SDL_JoystickEventState</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN5969" ></A ><H2 >Name</H2 >SDL_JoystickEventState -- Enable/disable joystick event polling</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN5972" ></A ><H2 >Synopsis</H2 ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN5973" ></A ><P ></P ><PRE CLASS="FUNCSYNOPSISINFO" >#include "SDL.h"</PRE ><P ><CODE ><CODE CLASS="FUNCDEF" >int <B CLASS="FSFUNC" >SDL_JoystickEventState</B ></CODE >(int state);</CODE ></P ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN5979" ></A ><H2 >Description</H2 ><P >This function is used to enable or disable joystick event processing. With joystick event processing disabled you will have to update joystick states with <A HREF="sdljoystickupdate.html" ><TT CLASS="FUNCTION" >SDL_JoystickUpdate</TT ></A > and read the joystick information manually. <TT CLASS="PARAMETER" ><I >state</I ></TT > is either <TT CLASS="LITERAL" >SDL_QUERY</TT >, <TT CLASS="LITERAL" >SDL_ENABLE</TT > or <TT CLASS="LITERAL" >SDL_IGNORE</TT >.</P ><DIV CLASS="NOTE" ><BLOCKQUOTE CLASS="NOTE" ><P ><B >Note: </B >Joystick event handling is prefered</P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN5990" ></A ><H2 >Return Value</H2 ><P >If <TT CLASS="PARAMETER" ><I >state</I ></TT > is <TT CLASS="LITERAL" >SDL_QUERY</TT > then the current state is returned, otherwise the new processing <TT CLASS="PARAMETER" ><I >state</I ></TT > is returned.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN5996" ></A ><H2 >See Also</H2 ><P ><A HREF="joystick.html" >SDL Joystick Functions</A >, <A HREF="sdljoystickupdate.html" ><TT CLASS="FUNCTION" >SDL_JoystickUpdate</TT ></A >, <A HREF="sdljoyaxisevent.html" ><SPAN CLASS="STRUCTNAME" >SDL_JoyAxisEvent</SPAN ></A >, <A HREF="sdljoyballevent.html" ><SPAN CLASS="STRUCTNAME" >SDL_JoyBallEvent</SPAN ></A >, <A HREF="sdljoybuttonevent.html" ><SPAN CLASS="STRUCTNAME" >SDL_JoyButtonEvent</SPAN ></A >, <A HREF="sdljoyhatevent.html" ><SPAN CLASS="STRUCTNAME" >SDL_JoyHatEvent</SPAN ></A ></P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="sdlgetappstate.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="joystick.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >SDL_GetAppState</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="eventfunctions.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Joystick</TD ></TR ></TABLE ></DIV ></BODY ></HTML >