nn::hid::CTR::ExtraPadReader::ReadLatest Member Function
bool ReadLatest(
ExtraPadStatus * pBuf
);
| Name | Description | |
|---|---|---|
| out | pBuf | Loads the sampling data. |
| Value | Description |
|---|---|
true |
Read successful. |
false |
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.) |
Reads the most recent sampling data from the Nintendo 3DS Circle Pad Pro and the CTR system gamepad. Unlike Read, this function allows you to read the same sampling data.
Call the SetStickClamp and SetExtraStickClamp functions to set the appropriate play tolerances because input is received even when no one is touching the Circle Pad and the Right Circle Pad. Note that you cannot get the maximum value for the distance between the input coordinates and the origin of the Circle Pad and Right Circle Pad. This is because some rounding occurs during clamping. Do not use this maximum value for thresholds or the like.
Electrical fluctuations and other factors can cause variation in the X and Y coordinates input by the Circle Pad and Right Circle Pad even when the pad tops have 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. (Note that the Right Circle Pad has a particularly high probability of experiencing such variation in value.)
Circle Pad| Amount of Change | Probability X (%) | Probability Y (%) |
|---|---|---|
| -3 | 0.00000585347 | 0.00000585347 |
| -2 | 0.0001778 | 0.0001778 |
| -1 | 0.0035411 | 0.0035411 |
| ±0 | 99.949837 | 99.949837 |
| -1 | 0.0035411 | 0.0035411 |
| -2 | 0.0001778 | 0.0001778 |
| -3 | 0.00000585347 | 0.00000585347 |
| Amount of Change | Probability X (%) | Probability Y (%) |
|---|---|---|
| -3 | 0.002 | 0.002 |
| -2 | 0.349 | 0.349 |
| -1 | 3.485 | 3.485 |
| ±0 | 92.326 | 92.326 |
| -1 | 3.491 | 3.491 |
| -2 | 0.346 | 0.346 |
| -3 | 0.002 | 0.002 |
To 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.
When the finger is removed from the pad and the pad top sits in its central position, the value is fixed to 0 and does not change. This is because even with some variation in value the minimum clamping value is never exceeded.
CONFIDENTIAL