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 name="GENERATOR" content="Microsoft FrontPage 3.0">
7<meta http-equiv="Content-Style-Type" content="text/css">
8<link rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9<title>VIResetDimmingCount</title>
10</head>
11
12<body>
13
14<h1 align="left">VIResetDimmingCount</h1>
15
16<h2>C Specification</h2>
17
18<dl>
19<dd><pre><code>#include &lt;revolution/vi.h&gt;</code></pre></dd>
20
21<dd><pre><code>BOOL VIResetDimmingCount( void )</code></pre></dd>
22</dl>
23
24<h2>Arguments</h2>
25<p>None.</p>
26
27<h2>Return Values</h2>
28<p>Returns TRUE if the counter was reset successfully; otherwise, returns FALSE.</p>
29
30
31
32<h2>Description</h2>
33
34<p>This function resets the counter until screen burn-in reduction goes into effect. (Returns it to the initial value.)<br><br> Screen burn-in reduction goes into effect when this counter reaches zero. If this function is called when the counter is already zero (when screen burn-in reduction is in effect), the counter is reset and the system will recover from screen burn-in reduction. The counter will be reset at the next field. There is no need to execute <code><a href="VIFlush.html">VIFlush</a></code>.<br>
35
36<br> <font color="#FF0000"><u><strong>Use this function to recover from screen burn-in reduction when using Nintendo DS (or DS Lite) as the controller for Wii. As a basic rule, do not use this function for any other purpose.</strong></u></font><br><br>
37
38<font color="#FF0000"><u><strong>Executing this function on a regular periodic basis is the same as turning off the screen burn-in reduction feature. You thus need to be careful not to continually execute this function over an extended period of time.</strong></u></font>
39
40</p>
41
42
43<h2>See Also</h2>
44
45<p><!-- <a href="VIEnableDVDStopMotor.html">VIEnableDVDStopMotor</a>,  <a href="VIGetDVDStopMotorCount.html">VIGetDVDStopMotorCount</a>, --> <a href="VIEnableDimming.html"><CODE>VIEnableDimming</CODE></a>, <a href="VIGetDimmingCount.html"><CODE>VIGetDimmingCount</CODE></a>, <a href="VISetTimeToDimming.html"><CODE>VISetTimeToDimming</CODE></a>
46
47
48</p>
49
50<h2>Revision History</h2>
51
52<p>
532007/07/11 Added a cautionary note that the use is prohibited except when using a Nintendo DS as a controller.<br>2006/11/28 Initial version.
54</p>
55</body>
56</html>
57