Mercurial > sdl-ios-xcode
view docs/html/sdljoyhatevent.html @ 765:4c2ba6161939
Editors Note: The original patch was modified to use SDL_Delay() instead of
nanosleep because nanosleep may not be portable to all systems
using SDL with the ALSA backend. This may be a moot point with
the switch to blocking writes anyway...
Date: Sat, 27 Dec 2003 21:47:36 +0100
From: Michel Daenzer
To: Debian Bug Tracking System
Subject: [SDL] Bug#225252: [PATCH] ALSA fixes
Package: libsdl1.2debian-all
Version: 1.2.6-2
Severity: normal
Tags: patch
For SDL 1.2.6, the ALSA backend was changed to call snd_pcm_open() with
SND_PCM_NONBLOCK. That's a good idea per se, however, it causes high CPU
usage, interrupted sound and stuttering in some games here. Taking a nanosleep
whenever snd_pcm_writei() returns -EAGAIN fixes this, but I think it's more
efficient to use blocking mode for the actual sound playback. Feedback from the
SDL and ALSA lists appreciated.
The patch also fixes the default ALSA device to be used.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Sun, 04 Jan 2004 15:40:50 +0000 |
parents | e5bc29de3f0a |
children | 355632dca928 |
line wrap: on
line source
<HTML ><HEAD ><TITLE >SDL_JoyHatEvent</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.64 "><LINK REL="HOME" TITLE="SDL Library Documentation" HREF="index.html"><LINK REL="UP" TITLE="SDL Event Structures." HREF="eventstructures.html"><LINK REL="PREVIOUS" TITLE="SDL_JoyButtonEvent" HREF="sdljoybuttonevent.html"><LINK REL="NEXT" TITLE="SDL_JoyBallEvent" HREF="sdljoyballevent.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFF8DC" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" ALINK="#ff0000" ><DIV CLASS="NAVHEADER" ><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="sdljoybuttonevent.html" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="sdljoyballevent.html" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="SDLJOYHATEVENT" >SDL_JoyHatEvent</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN3936" ></A ><H2 >Name</H2 >SDL_JoyHatEvent -- Joystick hat position change event structure</DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3939" ></A ><H2 >Structure Definition</H2 ><PRE CLASS="PROGRAMLISTING" >typedef struct{ Uint8 type; Uint8 which; Uint8 hat; Uint8 value; } SDL_JoyHatEvent;</PRE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3942" ></A ><H2 >Structure Data</H2 ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN3944" ></A ><P ></P ><TABLE BORDER="0" CLASS="CALSTABLE" ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="TOP" ><TT CLASS="STRUCTFIELD" ><I >type</I ></TT ></TD ><TD ALIGN="LEFT" VALIGN="TOP" ><TT CLASS="LITERAL" >SDL_JOY</TT ></TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="TOP" ><TT CLASS="STRUCTFIELD" ><I >which</I ></TT ></TD ><TD ALIGN="LEFT" VALIGN="TOP" >Joystick device index</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="TOP" ><TT CLASS="STRUCTFIELD" ><I >hat</I ></TT ></TD ><TD ALIGN="LEFT" VALIGN="TOP" >Joystick hat index</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="TOP" ><TT CLASS="STRUCTFIELD" ><I >value</I ></TT ></TD ><TD ALIGN="LEFT" VALIGN="TOP" >Hat position</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3964" ></A ><H2 >Description</H2 ><P ><SPAN CLASS="STRUCTNAME" >SDL_JoyHatEvent</SPAN > is a member of the <A HREF="sdlevent.html" ><SPAN CLASS="STRUCTNAME" >SDL_Event</SPAN ></A > union and is used when an event of type <TT CLASS="LITERAL" >SDL_JOYHATMOTION</TT > is reported.</P ><P >A <TT CLASS="LITERAL" >SDL_JOYHATMOTION</TT > event occurs when ever a user moves a hat on the joystick. The field <TT CLASS="STRUCTFIELD" ><I >which</I ></TT > is the index of the joystick that reported the event and <TT CLASS="STRUCTFIELD" ><I >hat</I ></TT > is the index of the hat (for a more detailed exlaination see the <A HREF="joystick.html" >Joystick section</A >). <TT CLASS="STRUCTFIELD" ><I >value</I ></TT > is the current position of the hat. It is a logically OR'd combination of the following values (whose meanings should be pretty obvious:) :</P ><P ></P ><TABLE BORDER="0" ><TBODY ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_CENTERED</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_UP</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_RIGHT</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_DOWN</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_LEFT</TT ></TD ></TR ></TBODY ></TABLE ><P ></P ><P >The following defines are also provided:</P ><P ></P ><TABLE BORDER="0" ><TBODY ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_RIGHTUP</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_RIGHTDOWN</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_LEFTUP</TT ></TD ></TR ><TR ><TD ><TT CLASS="LITERAL" >SDL_HAT_LEFTDOWN</TT ></TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN3998" ></A ><H2 >See Also</H2 ><P ><A HREF="sdlevent.html" ><SPAN CLASS="STRUCTNAME" >SDL_Event</SPAN ></A >, <A HREF="joystick.html" >Joystick Functions</A >, <A HREF="sdljoystickeventstate.html" ><TT CLASS="FUNCTION" >SDL_JoystickEventState</TT ></A >, <A HREF="sdljoystickgetball.html" ><TT CLASS="FUNCTION" >SDL_JoystickGetHat</TT ></A ></P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="sdljoybuttonevent.html" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="sdljoyballevent.html" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >SDL_JoyButtonEvent</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="eventstructures.html" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >SDL_JoyBallEvent</TD ></TR ></TABLE ></DIV ></BODY ></HTML >