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>PADRecalibrate</TITLE> 9</HEAD> 10<BODY> 11<H1>PADRecalibrate</H1> 12<H2>C Specification</H2> 13<DL> 14 <DD> 15 <PRE><CODE>#include <revolution/pad.h> 16 17#define PAD_CHAN0_BIT 0x80000000 18#define PAD_CHAN1_BIT 0x40000000 19#define PAD_CHAN2_BIT 0x20000000 20#define PAD_CHAN3_BIT 0x10000000</CODE></PRE> 21 <DD> 22 <PRE><CODE>BOOL PADRecalibrate(u32 mask);</CODE></PRE> 23</DL> 24<H2>Arguments</H2> 25<TABLE border="1" cellpadding="3" cellspacing="0.1"> 26 <TBODY> 27 <TR> 28<TD width="120" bgcolor="#ffffe8"><FONT face="Courier New"><EM><STRONG>mask</STRONG></EM></FONT></TD> 29<TD width="520">the bit OR mask of controllers (<code>PAD_CHAN</code><i>n</i><code>_BIT</code>) to reset</TD> 30 </TR> 31 </TBODY> 32</TABLE> 33<H2>Return Values</H2> 34<P>Always returns <CODE>TRUE</CODE>.</P> 35<P>Be aware that if <code><a href="PADRead.html">PADRead</a></code> is called immediately after <code>PADRecalibrate</code> is run, the returned <code><a href="PADStatus.html">PADStatus</a></code> for the specified ports may contain an error code, either <code>PAD_ERR_NOT_READY</code> or <code>PAD_ERR_TRANSFER</code>. If this happens, <a href="PADReset.html"><code>PADReset</code></a> (not <code>PADRecalibrate</code>) should be called repeatedly until <code><a href="PADRead.html">PADRead</a></code> returns the <code>PAD_ERR_NONE</code> error code.</P> 36<H2>Description</H2> 37<P>This function recalibrates the specified controller. Furthermore, <CODE>PADRecalibrate</CODE> behaves like <A href="PADReset.html"><CODE>PADReset</CODE></A>. Note that the controller is automatically adjusted when the power is turned on. The <CODE>PADRecalibrate</CODE> function must be called when the Revolution RESET Button has been pressed.</P> 38<P>No recalibration is performed for the WaveBird Controller even when the <CODE>PADRecalibrate</CODE> function is called. However, game programmers don't have to worry about this fact. Call <CODE>PADRecalibrate</CODE> whenever the RESET Button has been pressed.</P> 39 40<P></P> 41<H2>See Also</H2> 42<P><A href="toc.html" target="contents">Controller Functions</A>, <CODE><A href="PADButtonDown.html">PADButtonDown</A></CODE>, <CODE><A href="PADButtonUp.html">PADButtonUp</A></CODE>, <CODE><A href="PADInit.html">PADInit</A></CODE>, <CODE><A href="PADRead.html">PADRead</A></CODE>, <CODE><A href="PADReset.html">PADReset</A></CODE>, <CODE><A href="PADStatus.html">PADStatus</A></CODE></P> 43<H2>Revision History</H2> 44<P>2006/03/01 Initial version.</p> 45<hr> 46<P>CONFIDENTIAL</p> 47</BODY> 48</HTML>