1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META name="GENERATOR" content="Microsoft FrontPage 5.0"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8<TITLE>PADSetAnalogMode</TITLE> 9</HEAD> 10<BODY> 11<H1>PADSetAnalogMode</H1> 12<H2>C Specification</H2> 13<DL> 14 <DD> 15<PRE><CODE>#include <revolution/pad.h> 16 17#define PAD_MODE_0 0 18#define PAD_MODE_1 1 19#define PAD_MODE_2 2 20#define PAD_MODE_3 3 21#define PAD_MODE_4 4 22#define PAD_MODE_5 5 23#define PAD_MODE_6 6 24#define PAD_MODE_7 7</CODE></PRE> 25 <DD> 26<PRE><CODE>void PADSetAnalogMode(u32 mode);</CODE></PRE> 27</DL> 28<H2>Arguments</H2> 29<TABLE border="1" cellpadding="3" cellspacing="0.1"> 30 <TBODY> 31 <TR> 32<TD width="120" valign="top" bgcolor="#ffffe8"><CODE><STRONG><EM>mode</EM></STRONG></CODE></TD> 33<TD width="520">One of the <code>PAD_MODE_*</code> constants.</TD> 34 </TR> 35 </TBODY> 36</TABLE> 37<H2>Return Values</H2> 38<P>None.</P> 39<H2>Description</H2> 40<P><b>There is no need to use this function.</b> </P> 41<P>Specifies the controller analog mode to be used. The analog mode controls the resolution of the controller's analog inputs as stored in <code><a href="PADStatus.html">PADStatus</a></code> and as shown below. The default mode is <code>PAD_MODE_3</code>.</P> 42<P>NB: The <code>PADSetAnalogMode</code> function pauses the hardware controller sampling. The next <a href="PADRead.html"><code>PADRead</code></a> function returns <code>PAD_ERR_NO_CONTROLLER</code> errors for any connected controllers. The specified analog mode takes effect after the next call to <A href="PADReset.html"><CODE>PADReset</CODE></A> or <CODE><A href="PADInit.html">PADInit</A></CODE>. Note that <code>PADSetAnalogMode()</code> may be called before <code><a href="PADInit.html">PADInit()</a></code>.</P> 43<P><B>NB:</B><font size="2"> GameCube standard controllers do not support analog input values (<CODE>AnalogA/B</CODE>) for A or B Buttons. Also, the Revolution controller library <A href="../wpad/list.html"><CODE>WPAD</CODE></A> does not support analog input values from the A and B Buttons.</font></P> 44<H3>Mode 0, 5, 6, 7:</H3> 45<TABLE border="1" cellpadding="3" cellspacing="0.1"> 46 <TBODY> 47 <TR> 48<TD><CODE>stickX</CODE>, <CODE>stickY</CODE></TD> 49<TD>All 8 bits are valid.</TD> 50 </TR> 51 <TR> 52<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD> 53<TD>All 8 bits are valid.</TD> 54 </TR> 55 <TR> 56<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD> 57<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD> 58 </TR> 59 <TR> 60<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD> 61<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD> 62 </TR> 63 </TBODY> 64</TABLE> 65<H3>Mode 1:</H3> 66<TABLE border="1" cellpadding="3" cellspacing="0.1"> 67 <TBODY> 68 <TR> 69<TD><CODE>stickX</CODE>, <CODE>stickY</CODE></TD> 70<TD>All 8 bits are valid.</TD> 71 </TR> 72 <TR> 73<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD> 74<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD> 75 </TR> 76 <TR> 77<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD> 78<TD>All 8 bits are valid.</TD> 79 </TR> 80 <TR> 81<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD> 82<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD> 83 </TR> 84 </TBODY> 85</TABLE> 86<H3>Mode 2:</H3> 87<TABLE border="1" cellpadding="3" cellspacing="0.1"> 88 <TBODY> 89 <TR> 90<TD><CODE>stickX</CODE>, <CODE>stickY</CODE></TD> 91<TD>All 8 bits are valid.</TD> 92 </TR> 93 <TR> 94<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD> 95<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD> 96 </TR> 97 <TR> 98<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD> 99<TD>Leftmost 4 bits are valid. Other bits are set to zero.</TD> 100 </TR> 101 <TR> 102<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD> 103<TD>All 8 bits are valid.</TD> 104 </TR> 105 </TBODY> 106</TABLE> 107<H3>Mode 3:</H3> 108<TABLE border="1" cellpadding="3" cellspacing="0.1"> 109 <TBODY> 110 <TR> 111<TD><CODE>stickX</CODE>, <CODE>stickY</CODE></TD> 112<TD>All 8 bits are valid.</TD> 113 </TR> 114 <TR> 115<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD> 116<TD>All 8 bits are valid.</TD> 117 </TR> 118 <TR> 119<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD> 120<TD>All 8 bits are valid.</TD> 121 </TR> 122 <TR> 123<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD> 124<TD>All 8 bits are invalid and set to zero.</TD> 125 </TR> 126 </TBODY> 127</TABLE> 128<H3>Mode 4:</H3> 129<TABLE border="1" cellpadding="3" cellspacing="0.1"> 130 <TBODY> 131 <TR> 132<TD><CODE>stickX</CODE>, <CODE>stickY</CODE></TD> 133<TD>All 8 bits are valid.</TD> 134 </TR> 135 <TR> 136<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD> 137<TD>All 8 bits are valid.</TD> 138 </TR> 139 <TR> 140<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD> 141<TD>All 8 bits are invalid and set to zero.</TD> 142 </TR> 143 <TR> 144<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD> 145<TD>All 8 bits are valid.</TD> 146 </TR> 147 </TBODY> 148</TABLE> 149 150<P></P> 151<H2>See Also</H2> 152<P><A href="toc.html" target="contents">Controller Functions</A>, <A href="PADClamp.html"><CODE>PADClamp</CODE></A>, <CODE><A href="PADInit.html">PADInit</A></CODE>, <CODE><A href="PADReset.html">PADReset</A></CODE>, <CODE><A href="PADStatus.html">PADStatus</A></CODE></P> 153<H2>Revision History</H2> 154<P>03/01/2006 Initial version.</p> 155</BODY> 156</HTML>