WPADGetDataFormat

C Specification

#include <revolution/wpad.h>

#define WPAD_CHAN0                     0
#define WPAD_CHAN1                     1
#define WPAD_CHAN2                     2
#define WPAD_CHAN3                     3

#define WPAD_FMT_CORE                  0
#define WPAD_FMT_CORE_ACC              1
#define WPAD_FMT_CORE_ACC_DPD          2
#define WPAD_FMT_FREESTYLE             3
#define WPAD_FMT_FREESTYLE_ACC         4
#define WPAD_FMT_FREESTYLE_ACC_DPD     5
#define WPAD_FMT_CLASSIC               6
#define WPAD_FMT_CLASSIC_ACC           7
#define WPAD_FMT_CLASSIC_ACC_DPD       8
#define WPAD_FMT_CORE_ACC_DPD_FULL     9

u32 WPADGetDataFormat( s32 chan );
      
    

Arguments

chan One of the WPAD_CHANn values.

Return Values

One of the WPAD_FMT_*.

Description

Obtains the data format of the received data on the specified channel. The default setting is the data format for the Wii Remote (WPAD_FMT_CORE).

Received data formats are defined with the macro constants shown below.
WPAD_FMT_CORE Wii Remote data format (WPADStatus structure). Only button information is valid.
Note: This is the default type.
WPAD_FMT_CORE_ACC Wii Remote data format (WPADStatus structure). The button and motion sensor information is valid.
WPAD_FMT_CORE_ACC_DPD Wii Remote data format (WPADStatus structure). The button, motion sensor, and pointer information is valid. The pointer has valid size and coordinate data.
WPAD_FMT_FREESTYLE Nunchuk Style data format type (WPADFSStatus structure). For the Wii Remote, only the button information is valid.
WPAD_FMT_FREESTYLE_ACC Nunchuk Style data format type (WPADFSStatus structure). For the Wii Remote, the button and motion sensor information is valid.
WPAD_FMT_FREESTYLE_ACC_DPD Nunchuk Style data format type (WPADFSStatus structure). The Wii Remote button, motion sensor, and pointer information is valid. However, only the coordinate data is valid for the pointer.
WPAD_FMT_CLASSIC Classic Style data format type (WPADCLStatus structure). For the Wii Remote, only the button information is valid.
WPAD_FMT_CLASSIC_ACC Classic Style data format type (WPADCLStatus structure). For the Wii Remote, the button and motion sensor information is valid.
WPAD_FMT_CLASSIC_ACC_DPD Classic Style data format type (WPADCLStatus structure). The Wii Remote button, motion sensor, and pointer information is valid. However, only the coordinate data is valid for the pointer.
WPAD_FMT_CORE_ACC_DPD_FULL Wii Remote extended data format (the WPADStatusEx structure). The Wii Remote button, motion sensor, and pointer information is valid. For the pointer, the coordinates data, size, object radius, pixel value, and range are valid. However, the data rate is half that of normal (roughly 100 samples per second).

See Also

WPAD Functions
WPADSetDataFormat, WPADStatus, WPADFSStatus, WPADCLStatus, WPADStatusEx

Revision History

2006/08/15 Added the extended data format
2006/06/19 Changed the name of the external extended controller; added data format
2005/10/27 Changed the layout.
2005/10/20 Initial version.


CONFIDENTIAL