PMICSetEsMode

Syntax

#include <revolution/pmic.h>

// pre-defined modes
extern PMICEsMode  PMICEsPhone;         // for phone-mode
extern PMICEsMode  PMICEsConference2;   // for conference-mode between 2 persons
extern PMICEsMode  PMICEsConference3;   // for conference-mode between 3 persons
extern PMICEsMode  PMICEsConference3_1; // for conference-mode between 3 persons (deep loss     than c3)
extern PMICEsMode  PMICEsConference3_2; // for conference-mode between 3 persons (deep loss     than c3_1)
extern PMICEsMode  PMICEsConference3_3; // for conference-mode between 3 persons (fast decrease than c3)
extern PMICEsMode  PMICEsConference3_4; // for conference-mode between 3 persons (fast decrease than c3_1)
extern PMICEsMode  PMICEsConference3_5; // for conference-mode between 3 persons (fast decrease than c3_2)
extern PMICEsMode  PMICEsConference4;   // for conference-mode between 4 persons

void PMICSetEsMode(PMICEsMode* mode);

Arguments

Pointer to the PMICEsMode object corresponding to the communications state.

Return Values

None.

Description

When using Wii Speak for voice chat, the PMICExecEs function controls the echo suppressor on the Wii to enable smoother conversations with less echo.

In order for the echo suppressor to operate properly, use this function to set the parameter appropriate to the chat method and number of participants.

The library provides the following parameters for echo suppression:

`PMICEsPhone`	Sets the VCT library's phone mode.
`PMICEsConference2`	Sets the VCT library's conference mode (2 participants).
`PMICEsConference3`	Sets the VCT library's conference mode (3 participants).
`PMICEsConference3_1`	Suppresses more echoes than `PMICEsConference3`.
`PMICEsConference3_2`	Suppresses more echoes than `PMICEsConference3_1`.
`PMICEsConference3_3`	Suppresses echoes more abruptly than `PMICEsConference3`.
`PMICEsConference3_4`	Suppresses echoes more abruptly than `PMICEsConference3_1`.
`PMICEsConference3_5`	Suppresses echoes more abruptly than `PMICEsConference3_2`.
`PMICEsConference4`	Sets the VCT library's conference mode (4 participants).

Although you can increase the amount of echo suppression to decrease the number of echoes, you may find it harder to understand people when they start to talk.

Although you can suppress echoes abruptly to decrease the number of echoes when one party stops speaking and a party on the other end begins speaking, you may think that the conversation has been cut off.

The default setting is PMICEsPhone.

Revision History

2008/12/22 Standardized terminology.
2008/10/27 Added ES mode.
2008/07/30 Initial version.