1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<title>PMICSetEsMode</title>
9</head>
10
11<body>
12
13<h1>PMICSetEsMode</h1>
14
15<h2>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution/pmic.h&gt;
18
19// pre-defined modes
20extern PMICEsMode  PMICEsPhone;         // for phone-mode
21extern PMICEsMode  PMICEsConference2;   // for conference-mode between 2 persons
22extern PMICEsMode  PMICEsConference3;   // for conference-mode between 3 persons
23extern PMICEsMode  PMICEsConference3_1; // for conference-mode between 3 persons (deep loss     than c3)
24extern PMICEsMode  PMICEsConference3_2; // for conference-mode between 3 persons (deep loss     than c3_1)
25extern PMICEsMode  PMICEsConference3_3; // for conference-mode between 3 persons (fast decrease than c3)
26extern PMICEsMode  PMICEsConference3_4; // for conference-mode between 3 persons (fast decrease than c3_1)
27extern PMICEsMode  PMICEsConference3_5; // for conference-mode between 3 persons (fast decrease than c3_2)
28extern PMICEsMode  PMICEsConference4;   // for conference-mode between 4 persons
29
30void PMICSetEsMode(PMICEsMode* mode);
31</pre></dd></dl>
32
33<h2>Arguments</h2>
34<p>Pointer to the <code>PMICEsMode</code> object corresponding to the communications state.</p>
35
36<h2>Return Values</h2>
37<p>None.</p>
38
39<H2>Description</H2>
40<p>
41When using Wii Speak for voice chat, the <a href="PMICExecEs.html"><code>PMICExecEs</code></a> function controls the echo suppressor on the Wii to enable smoother conversations with less echo.
42</p>
43
44<p>
45In order for the echo suppressor to operate properly, use this function to set the parameter appropriate to the chat method and number of participants.
46</p>
47
48<p>
49The library provides the following parameters for echo suppression:
50</p>
51
52<TABLE class="arguments" border="1" >
53  <tr>
54<th><CODE>PMICEsPhone</CODE></th>
55<td>Sets the VCT library's phone mode.</td>
56  </tr>
57  <tr>
58<th><CODE>PMICEsConference2</CODE></th>
59<td>Sets the VCT library's conference mode (2 participants).</td>
60  </tr>
61  <tr>
62<th><CODE>PMICEsConference3</CODE></th>
63<td>Sets the VCT library's conference mode (3 participants).</td>
64  </tr>
65  <tr>
66<th><CODE>PMICEsConference3_1</CODE></th>
67<td>Suppresses more echoes than <code>PMICEsConference3</code>.</td>
68  </tr>
69  <tr>
70<th><CODE>PMICEsConference3_2</CODE></th>
71<td>Suppresses more echoes than <code>PMICEsConference3_1</code>.</td>
72  </tr>
73  <tr>
74<th><CODE>PMICEsConference3_3</CODE></th>
75<td>Suppresses echoes more abruptly than <code>PMICEsConference3</code>.</td>
76  </tr>
77  <tr>
78<th><CODE>PMICEsConference3_4</CODE></th>
79<td>Suppresses echoes more abruptly than <code>PMICEsConference3_1</code>.</td>
80  </tr>
81  <tr>
82<th><CODE>PMICEsConference3_5</CODE></th>
83<td>Suppresses echoes more abruptly than <code>PMICEsConference3_2</code>.</td>
84  </tr>
85  <tr>
86<th><CODE>PMICEsConference4</CODE></th>
87<td>Sets the VCT library's conference mode (4 participants).</td>
88  </tr>
89</TABLE>
90
91<p>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.</p>
92
93<p>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.</p>
94
95<p>
96The default setting is <code>PMICEsPhone</code>.
97</p>
98
99<H2>See Also</H2>
100<p class="reference">
101<a href="PMICExecEs.html"><code>PMICExecEs</code></a>
102</p>
103
104<H2>Revision History</H2>
105<p>
1062008/12/22 Standardized terminology.<br>2008/10/27 Added ES mode. <br>2008/07/30 Initial version.
107</p>
108
109<hr><p>CONFIDENTIAL</p></body>
110
111</html>
112