1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../../css/manpage.css" type="text/css" />
7<title>ReadLatest</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../../nn/Overview.html">nn</a>::<a href="../../../../nn/hid/Overview.html">hid</a>::<a href="../../../../nn/hid/CTR/Overview.html">CTR</a>::<a href="../../../../nn/hid/CTR/PadReader/Overview.html">PadReader</a>::ReadLatest</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14bool ReadLatest(
15     <a href="../../../../nn/hid/CTR/PadStatus/Overview.html">PadStatus</a> * pBuf
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>out</td>
31<th>pBuf</th>
32<td>Loads the sampling data.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">Returns the result of loading sampling data.<br /> <br />
37      <table class="arguments">
38        <thead>
39          <tr>
40<th>Value</th>
41<td>Description</td>
42          </tr>
43        </thead>
44        <tr>
45<th><CODE>true</CODE></th>
46<td>Read successful.</td>
47        </tr>
48        <tr>
49<th><CODE>false</CODE></th>
50<td>Could not read. (The data can be loaded immediately following the first sampling that occurs after the system starts up or wakes up from sleep.)</td>
51        </tr>
52      </table> </div>
53<h2>Description</h2>
54    <div class="section">
55<p>Reads the latest sampling data from the gamepad. Unlike <a href="../../../../nn/hid/CTR/PadReader/Read.html"><CODE>nn::hid::CTR::PadReader::Read</CODE></a>, it is possible to read the same sampling data.</p><p>The trigger and release values are generated with respect to the previous <a href="../../../../nn/hid/CTR/PadReader/ReadLatest.html"><CODE>ReadLatest</CODE></a> results. Use the <a href="../../../../nn/hid/CTR/PadReader/SetStickClamp.html"><CODE>nn::hid::CTR::PadReader::SetStickClamp</CODE></a> function to set the appropriate play in the Circle Pad because there will be input even if it is not touched. Note that it is not possible to get the maximum distance between the input coordinates and the origin of the Circle Pad. This is because some rounding occurs during clamping. Do not use this maximum value for thresholds or the like.</p><!-- write here --><P>
56Electrical fluctuations and other factors can cause variation in the X and Y coordinates input by the Circle Pad even when the pad top has not been intentionally moved. Please refer to the table below about the amounts of change and probability of change to values when the top of the pad is presumably completely fixed in position.
57</P>
58Circle Pad
59<TABLE><THEAD><TR bgcolor="#ccccdd"><TH>Amount of Change</TH><TH>Probability X (%)</TH><TH>Probability Y (%)</TH></TR></THEAD><TR><TD>-3</TD><TD>0.00000585347</TD><TD>0.00000585347</TD></TR><TR><TD>-2</TD><TD>0.0001778</TD><TD>0.0001778</TD></TR><TR><TD>-1</TD><TD>0.0035411</TD><TD>0.0035411</TD></TR><TR><TD>&plusmn;0</TD><TD>99.949837</TD><TD>99.949837</TD></TR><TR><TD>-1</TD><TD>0.0035411</TD><TD>0.0035411</TD></TR><TR><TD>-2</TD><TD>0.0001778</TD><TD>0.0001778</TD></TR><TR><TD>-3</TD><TD>0.00000585347</TD><TD>0.00000585347</TD></TR></TABLE><P>
60To calculate the probability of a change in value during a given period of time, multiply the probability shown in this table by the number of sets of sampling data obtained in the given time period.
61</P><P>
62When the finger is removed from the pad and the pad top sits in its central position, the value is fixed to <CODE>0</CODE> and does not change. This is because even with some variation in value the minimum clamping value is never exceeded.
63</P></div>
64<h2>Revision History</h2>
65    <div class="section">
66      <dl class="history">
67        <dt>2011/12/15</dt>
68<dd>Added note about the probability and extent of variation in Circle Pad values.<br />
69        </dd>
70        <dt>2011/10/09</dt>
71<dd>Revised Japanese terminology for the Circle Pad.<br />
72        </dd>
73        <dt>2010/01/07</dt>
74<dd>Initial version.<br />
75        </dd>
76      </dl>
77    </div>
78  <hr><p>CONFIDENTIAL</p></body>
79</html>
80