nn::hid::CTR::ExtraPadReader Class

Syntax

class ExtraPadReader

Description

Class for reading sampling data from the Nintendo 3DS Circle Pad Pro and the CTR system gamepad.

Call the ExtraPad::Initialize function before using this class. The ExtraPad::StartSampling and ExtraPad::StopSampling functions control sampling for the Circle Pad Pro. While sampling is in progress for the Circle Pad Pro, both the CTR system's gamepad information and the Circle Pad Pro's input information are updated at the intervals set by the ExtraPad::StartSampling function. Note that you cannot get the CTR system gamepad information from the PadReader function while a connection to the Circle Pad Pro is maintained.

When the Circle Pad Pro is not connected, only the CTR system gamepad information is updated. (It is updated every 4 milliseconds, which is the gamepad sampling period.)
Note: Both the information obtained by sampling and the sampling period differ depending on the state of the Nintendo 3DS Circle Pad Pro.

Enumerated Types

StickClampMode The clamp mode of the Circle Pad and the Right Circle Pad. This is set by the SetStickClampMode and SetExtraStickClampMode functions. This has the same meaning as PadReader::StickClampMode. For more information, see PadReader::StickClampMode.

Member Functions

Constructors/Destructors
ExtraPadReader Constructor.
V ~ExtraPadReader Destructor.
Reading Sampling Data
Read Reads sampling data from the Nintendo 3DS Circle Pad Pro and the CTR system gamepad in reverse chronological order.
ReadLatest 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.
Clamping the CTR System Circle Pad
SetStickClamp Sets the clamp values for the CTR system Circle Pad.
GetStickClamp Gets the clamp values of the current clamp mode for the CTR system Circle Pad.
GetStickClampMode Gets the clamp mode of the CTR system Circle Pad.
SetStickClampMode Sets the clamp mode of the CTR system Circle Pad.
NormalizeStick Normalizes and returns the CTR system Circle Pad values obtained by the Read and ReadLatest functions to floating-point values between -1.0 and 1.0.
NormalizeStickWithScale Normalizes and returns the CTR system Circle Pad values obtained by the Read and ReadLatest functions to floating-point values between -1.0 and 1.0. Includes a sensitivity correction feature.
SetNormalizeStickScaleSettings Configures settings for the NormalizeStickWithScale function.
GetNormalizeStickScaleSettings Gets the NormalizeStickWithScale function settings.
Clamping the Right Circle Pad
SetExtraStickClamp Sets the clamp values for the Right Circle Pad.
GetExtraStickClamp Gets the clamp values of the current clamp mode for the Right Circle Pad.
GetExtraStickClampMode Gets the clamp mode for the Right Circle Pad.
SetExtraStickClampMode Sets the clamp mode for the Right Circle Pad.
NormalizeExtraStick Normalizes and returns the Right Circle Pad values obtained by the Read and ReadLatest functions to floating-point values between -1.0 and 1.0.
NormalizeExtraStickWithScale Normalizes and returns the Right Circle Pad values obtained by the Read and ReadLatest functions to floating-point values between -1.0 and 1.0. Includes a sensitivity correction feature.
SetNormalizeExtraStickScaleSettings Configures settings for the NormalizeExtraStickWithScale function.
GetNormalizeExtraStickScaleSettings Gets the NormalizeExtraStickWithScale function settings.

Revision History

2011/10/06
Initial version.

CONFIDENTIAL