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
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15#include &lt;revolution/pad.h&gt;
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
25
26void PADSetAnalogMode(u32 mode);
27</pre></dd></dl>
28
29<H2>Arguments</H2>
30<TABLE class="arguments" border="1" >
31  <TBODY>
32    <TR>
33<TH>mode</TH>
34<TD>one of <CODE>PAD_MODE_*</CODE></TD>
35    </TR>
36  </TBODY>
37</TABLE>
38
39<H2>Return Values</H2>
40<P>None.</P>
41
42<H2>Description</H2>
43<P><b>There is no need to use this function.</b></P>
44<P>Specifies the analog mode of the controllers to use. The analog mode controls the resolution of the controller's analog inputs as stored in <A href="PADStatus.html"><CODE>PADStatus</CODE></A> (see modes below). The default mode is <CODE>PAD_MODE_3</CODE>.</P>
45<P><B>Note:</B> The <CODE>PADSetAnalogMode</CODE> function suspends hardware controller sampling. The next <A href="PADRead.html"><CODE>PADRead</CODE></A> function call returns <CODE>PAD_ERR_NO_CONTROLLER</CODE> errors for the attached controllers. The specified analog mode takes effect after the next call to the <A href="PADReset.html"><CODE>PADReset</CODE></A> or <A href="PADInit.html"><CODE>PADInit</CODE></A> function. Note that the <CODE>PADSetAnalogMode</CODE> function can be called before the <A href="PADInit.html"><CODE>PADInit</CODE></A> function.</P>
46<P><B>Note:</B><font size="2">GameCube standard controllers do not support analog input values (</font><CODE>AnalogA/B</CODE><font size="2">) for A or B Buttons. Also, the Revolution SDK 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>
47<H3>Mode 0, 5, 6, 7:</H3>
48<TABLE border="1" cellpadding="3" cellspacing="0.1">
49  <TBODY>
50    <TR>
51<TD><em><code>stickX</code>, <code>stickY</code></em></TD>
52<TD>All 8 bits are valid.</TD>
53    </TR>
54    <TR>
55<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD>
56<TD>All 8 bits are valid.</TD>
57    </TR>
58    <TR>
59<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD>
60<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD>
61    </TR>
62    <TR>
63<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD>
64<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD>
65    </TR>
66  </TBODY>
67</TABLE>
68<H3>Mode 1:</H3>
69<TABLE border="1" cellpadding="3" cellspacing="0.1">
70  <TBODY>
71    <TR>
72<TD><em><code>stickX</code>, <code>stickY</code></em></TD>
73<TD>All 8 bits are valid.</TD>
74    </TR>
75    <TR>
76<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD>
77<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD>
78    </TR>
79    <TR>
80<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD>
81<TD>All 8 bits are valid.</TD>
82    </TR>
83    <TR>
84<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD>
85<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD>
86    </TR>
87  </TBODY>
88</TABLE>
89<H3>Mode 2:</H3>
90<TABLE border="1" cellpadding="3" cellspacing="0.1">
91  <TBODY>
92    <TR>
93<TD><em><code>stickX</code>, <code>stickY</code></em></TD>
94<TD>All 8 bits are valid.</TD>
95    </TR>
96    <TR>
97<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD>
98<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD>
99    </TR>
100    <TR>
101<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD>
102<TD>Uppermost 4 bits are valid. Other bits are set to zero.</TD>
103    </TR>
104    <TR>
105<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD>
106<TD>All 8 bits are valid.</TD>
107    </TR>
108  </TBODY>
109</TABLE>
110<H3>Mode 3:</H3>
111<TABLE border="1" cellpadding="3" cellspacing="0.1">
112  <TBODY>
113    <TR>
114<TD><em><code>stickX</code>, <code>stickY</code></em></TD>
115<TD>All 8 bits are valid.</TD>
116    </TR>
117    <TR>
118<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD>
119<TD>All 8 bits are valid.</TD>
120    </TR>
121    <TR>
122<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD>
123<TD>All 8 bits are valid.</TD>
124    </TR>
125    <TR>
126<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD>
127<TD>All 8 bits are invalid and set to zero.</TD>
128    </TR>
129  </TBODY>
130</TABLE>
131<H3>Mode 4:</H3>
132<TABLE border="1" cellpadding="3" cellspacing="0.1">
133  <TBODY>
134    <TR>
135<TD><em><code>stickX</code>, <code>stickY</code></em></TD>
136<TD>All 8 bits are valid.</TD>
137    </TR>
138    <TR>
139<TD><CODE>substickX</CODE>, <CODE>substickY</CODE></TD>
140<TD>All 8 bits are valid.</TD>
141    </TR>
142    <TR>
143<TD><CODE>triggerLeft</CODE>, <CODE>triggerRight</CODE></TD>
144<TD>All 8 bits are invalid and set to zero.</TD>
145    </TR>
146    <TR>
147<TD><CODE>analogA</CODE>, <CODE>analogB</CODE></TD>
148<TD>All 8 bits are valid.</TD>
149    </TR>
150  </TBODY>
151</TABLE>
152
153<H2>See Also</H2>
154<P class="reference">
155<A href="PADClamp.html">PADClamp</A>,
156<A href="PADInit.html">PADInit</A>,
157<A href="PADReset.html">PADReset</A>,
158<A href="PADStatus.html">PADStatus</A>
159</P>
160
161<H2>Revision History</H2>
162<P>
1632006/03/01 Initial version.<br>
164</p>
165
166<hr><p>CONFIDENTIAL</p></body>
167</HTML>