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 http-equiv="Content-Style-Type" content="text/css">
6<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
7<title>KPADSetReviseMode</title>
8</head>
9
10<body>
11
12<h1>KPADSetReviseMode</h1>
13
14<h2>Syntax</h2>
15<dl><dd><pre class="construction">
16#include &lt;revolution/kpad.h&gt;
17
18void KPADSetReviseMode( s32 chan, BOOL sw );
19</pre></dd></dl>
20
21<h2>Arguments</h2>
22<TABLE class="arguments" border="1" >
23  <TBODY>
24    <TR>
25<TH>chan</TH>
26<TD>One of the <code>WPAD_CHAN<i>n</i></code> values.</TD>
27    </TR>
28    <TR>
29<TH>sw</TH>
30<TD>Specify <code>TRUE</code> to apply angular correction, or <code>FALSE</code> to not apply it.</TD>
31    </TR>
32  </TBODY>
33</TABLE>
34
35<h2>Return Values</h2>
36<p>None.</p>
37
38<H2>Description</H2>
39<p>
40Specifies whether to apply, in advance, the angular correction to the values that are returned from the Nunchuk Motion Sensor and are obtainable with <CODE>KPADEXStatus</CODE>. Be aware that when the correction is set to ON, it is applied after clamping the Motion Sensor measurement range.
41</p>
42
43<h2>Angular Correction</h2>
44<p>
45The Nunchuk Motion Sensor is aligned parallel to the plane of operation of the Nunchuk Control Stick. When the Nunchuk is held as shown in the following diagram, the Motion Sensor indicates horizontal orientation.
46</p>
47<IMG SRC="nuncha_0.gif">
48<p>
49To make the Nunchuk as easy to handle as the Wii Remote, this function adjusts the Motion Sensor values such that the Nunchuk indicates horizontal alignment when held as shown in the diagram below. This is accomplished by rotating the Motion Sensor values counterclockwise (when facing to the positive X-direction) around the  X-axis of the Motion Sensor's coordinate system. When this is performed, the exact angle of rotation can be obtained with the <a href="./KPADGetReviseAngle.html"><code>KPADGetReviseAngle</code></a> function.
50</p>
51<IMG SRC="nuncha_1.gif">
52
53<h2>See Also</h2>
54<p class="reference">
55<a href="./KPADReviseAcc.html">KPADReviseAcc</a>,
56<a href="./KPADGetReviseAngle.html">KPADGetReviseAngle</a>
57</p>
58
59<H2>Revision History</H2>
60<P>
612007/05/21 Initial version.<br>
62</P>
63
64<hr><p>CONFIDENTIAL</p></body>
65</html>
66