Difference between revisions of "User:Goofster1020/Code Tutorials/Tutorial 1 - Basic Wiimote Usage"

From WiiBrew
Jump to navigation Jump to search
Line 160: Line 160:
  
 
===Wiimote Expansions===
 
===Wiimote Expansions===
 +
When you use expansions within your code, it is easier just to type out the name of the expansion. The definitions for the expansions available in Wiiuse follow:
 +
<source lang="c">
 +
WPAD_EXP_NONE
 +
// No expansion is connected. (equals 0)
 +
WPAD_EXP_NUNCHUK
 +
// The Nunchuk is connected. (equals 1)
 +
WPAD_EXP_CLASSIC
 +
// The Classic Controller is connected. (equals 2)
 +
WPAD_EXP_GUITARHERO3
 +
// The Guitar is connected. (equals 3)
 +
WPAD_EXP_WIIBOARD
 +
// The Wii Balance Board is connected on that channel. (equals 4)
 +
</source>
 +
If a expansion is unknown, it is defined as:
 +
<source lang="c">
 +
WPAD_EXP_UNKNOWN
 +
// An unknown expansion is connected. (equals 255)
 +
// This could be because it is a new expansion or
 +
// Wiiuse has no compatibility for it yet.
 +
</source>
 +
 
===Wiimote Errors===
 
===Wiimote Errors===
 
==Basic Usage==
 
==Basic Usage==

Revision as of 08:32, 27 June 2009

This tutorial explains how to use the wiimote in many different ways:

Useful Codes

Basic Usage

Wiimote Features

Expansions

Detection

Other


Useful Codes

Wiimote Channels

When programming, the Wiimote channels start from 0 and go to 3. So:

  • Wiimote 1 = Channel 0
  • Wiimote 2 = Channel 1
  • Wiimote 3 = Channel 2
  • Wiimote 4 = Channel 3


Furthermore, there are preprocessor (macro) codes to make life a little simpler:

WPAD_CHAN_0
// For the first Wiimote. (equals 0)
WPAD_CHAN_1
// For the second Wiimote. (equals 1)
WPAD_CHAN_2
// For the third Wiimote. (equals 2)
WPAD_CHAN_3
// For the fourth Wiimote. (equals 3)

Additionally, there is a code for all Wiimotes that can be used as well:

WPAD_CHAN_ALL
// For every Wiimote. (equals -1)

Wiimote Buttons

In order to detect a button press, you need to define the button. Thankfully, Wiiuse defines these, otherwise you would have to type codes such as:

(0x0001<<16)
// Z button on the Nunchuk. (Defined as WPAD_NUNCHUK_BUTTON_Z)

Instead, you only have to type the name of the button.

Wiimote Codes

The definitions for the buttons on the Wiimote follow:

WPAD_BUTTON_2
// 2 Button.
WPAD_BUTTON_1
// 1 Button.
WPAD_BUTTON_B
// B Button.
WPAD_BUTTON_A
// A Button.
WPAD_BUTTON_MINUS
// Minus Button.
WPAD_BUTTON_HOME
// Home Button.
WPAD_BUTTON_PLUS
// Plus Button.
WPAD_BUTTON_LEFT
// Left Button.
WPAD_BUTTON_RIGHT
// Right Button.
WPAD_BUTTON_DOWN
// Down Button.
WPAD_BUTTON_UP
// Up Button.

Nunchuk Codes

The definitions for the buttons on the Nunchuk follow:

WPAD_NUNCHUK_BUTTON_Z
// Nunchuk Z Button.
WPAD_NUNCHUK_BUTTON_C
// Nunchuk C Button.

Classic Controller Codes

The definitions for the buttons on the Classic Controller follow:

WPAD_CLASSIC_BUTTON_UP
// Classic Controller Up Button.
WPAD_CLASSIC_BUTTON_LEFT
// Classic Controller Left Button.
WPAD_CLASSIC_BUTTON_ZR
// Classic Controller ZR Button.
WPAD_CLASSIC_BUTTON_X
// Classic Controller X Button.
WPAD_CLASSIC_BUTTON_A
// Classic Controller A Button.
WPAD_CLASSIC_BUTTON_Y
// Classic Controller Y Button.
WPAD_CLASSIC_BUTTON_B
// Classic Controller B Button.
WPAD_CLASSIC_BUTTON_ZL
// Classic Controller ZL Button.
WPAD_CLASSIC_BUTTON_FULL_R
// Classic Controller R Button. (when fully pressed)
WPAD_CLASSIC_BUTTON_PLUS
// Classic Controller Plus Button.
WPAD_CLASSIC_BUTTON_HOME
// Classic Controller Home Button.
WPAD_CLASSIC_BUTTON_MINUS
// Classic Controller Minus Button.
WPAD_CLASSIC_BUTTON_FULL_L
// Classic Controller L Button. (when fully pressed)
WPAD_CLASSIC_BUTTON_DOWN
// Classic Controller Down Button.
WPAD_CLASSIC_BUTTON_RIGHT
// Classic Controller Right Button.

Guitar Codes

The definitions for the buttons on the Guitar follow: NOTE: This only works for the Guitar Hero 3 Controller.

WPAD_GUITAR_HERO_3_BUTTON_STRUM_UP
// Guitar Strum Up.
WPAD_GUITAR_HERO_3_BUTTON_YELLOW
// Guitar Fret Yellow.
WPAD_GUITAR_HERO_3_BUTTON_GREEN
// Guitar Fret Green.
WPAD_GUITAR_HERO_3_BUTTON_BLUE
// Guitar Fret Blue.
WPAD_GUITAR_HERO_3_BUTTON_RED
// Guitar Fret Red.
WPAD_GUITAR_HERO_3_BUTTON_ORANGE
// Guitar Fret Orange.
WPAD_GUITAR_HERO_3_BUTTON_PLUS
// Guitar Plus Button.
WPAD_GUITAR_HERO_3_BUTTON_MINUS
// Guitar Minus Button.
WPAD_GUITAR_HERO_3_BUTTON_STRUM_DOWN
// Guitar Strum Up.

Wiimote Expansions

When you use expansions within your code, it is easier just to type out the name of the expansion. The definitions for the expansions available in Wiiuse follow:

WPAD_EXP_NONE
// No expansion is connected. (equals 0)
WPAD_EXP_NUNCHUK
// The Nunchuk is connected. (equals 1)
WPAD_EXP_CLASSIC
// The Classic Controller is connected. (equals 2)
WPAD_EXP_GUITARHERO3
// The Guitar is connected. (equals 3)
WPAD_EXP_WIIBOARD
// The Wii Balance Board is connected on that channel. (equals 4)

If a expansion is unknown, it is defined as:

WPAD_EXP_UNKNOWN
// An unknown expansion is connected. (equals 255)
// This could be because it is a new expansion or
// Wiiuse has no compatibility for it yet.

Wiimote Errors

Basic Usage

The following section includes the very basic usage of the Wiimote.

If you are using the Wiimote, no matter what, you always need to have this line in your file:

#include <wiiuse/wpad.h>
//This simple line allows your program access to everything available (in LibWiiuse)  for the Wiimote.


Initializing the Wiimote

In order to turn on and use the Wiimote, you need to add this line (at least once) in your program:

WPAD_Init();
// This will turn on and allow you to use the Wiimote.


Disconnecting the Wiimote

If you want to, you can disconnect the Wiimote when you are done using it. This can be done by:

WPAD_Flush(WPAD_CHAN_ALL);
// This will stop all data being transferred between the Wiimote and the Wii. (Not required)
WPAD_Disconnect(WPAD_CHAN_ALL);
// This will turn off all connected Wiimotes.

Wiimote Features

Using the Buttons

Using the Joysticks

Using the Accelerometer

Using the IR

Using Rumble

Expansions

Nunchuk

Classic Controller

Guitar

Balance Board

Detection

Wiimote Detection

Expansion Detection

Other

Wiimote Settings

Wiimote Callbacks