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>VISetTimeToDimming</title>
10</head>
11
12<body>
13
14<h1 align="left">VISetTimeToDimming</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/vi.h&gt;
19
20VITimeToDIM VISetTimeToDimming( VITimeToDIM time );
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<th>time</th>
27<td>Time until the execution of the screen burn-in protection function.<br>
28    <TABLE class="arguments" border="1" >
29      <tr>
30<td bgcolor="#C0C0C0"><STRONG>Name</STRONG></td>
31<td bgcolor="#C0C0C0"><STRONG>Time Until Execution</STRONG></td>
32      </tr>
33      <tr>
34<th>VI_DM_DEFAULT</th>
35<td>Approximately 5 minutes.</td>
36      </tr>
37      <tr>
38<th>VI_DM_10M</th>
39<td>Approximately 10 minutes.</td>
40      </tr>
41      <tr>
42<th>VI_DM_15M</th>
43<td>Approximately 15 minutes.</td>
44      </tr>
45    </table>
46    </td>
47  </tr>
48</table>
49
50<h2>Return Values</h2>
51<p>Returns the previously set value.</p>
52
53<h2>Description</h2>
54<p>
55This function changes the wait time until the burn-in protection executes. The screen burn-in protection will execute if the controller input state does not change. The time until the execution is five minutes by default. There is no real need to execute <a href="VIFlush.html"><code>VIFlush</code></a> after this function. <br>The exact time until activation can be obtained using the <a href="VIGetDimmingCount.html"><code>VIGetDimmingCount</code></a> function.
56</p>
57
58<p>
59Changes through this function will become enabled starting next field if the controller idle time at the moment is smaller than the set time.<br>This is illustrated in the following example.<br><IMG src="images/VISetTimeToDimming1.gif" alt="VISetTimeToDimming1.gif (4496 bytes)" width="731" height="159">
60</p>
61
62<p>
63In the above case, the changes will be reflected at the next field. (Time until the execution changes.)<br> <IMG src="images/VISetTimeToDimming2.gif" alt="VISetTimeToDimming2.gif (3387 bytes)" width="731" height="140">
64</p>
65
66<br><br> <br><br>
67
68<P>
69If the controller idling time is already longer than the specified time, the change will be put on hold.<br><IMG src="images/VISetTimeToDimming3.gif" alt="VISetTimeToDimming3.gif (4494 bytes)" width="731" height="159">
70</P>
71
72<p>
73In the above case, the execution wait time will be changed at the next field when the controller idling time becomes smaller than the specified time (that is, when there is a controller input or during the recovery from the screen burn-in protection).<br><IMG src="images/VISetTimeToDimming4.gif" alt="VISetTimeToDimming4.gif (4922 bytes)" width="731" height="177">
74</P>
75
76<br><br> <br><br>
77
78<p>
79Please note that the <a href="VIInit.html"><code>VIInit</code></a> function will reset the execution wait time to the default value of approximately five minutes.<br>Please also note that screen burn-in protection functions only if burn-in protection has been set to ON in the system settings menu.
80</p>
81
82<h2>See Also</h2>
83<P class="reference">
84<a href="VIEnableDimming.html">VIEnableDimming</a>,
85<a href="VIResetDimmingCount.html">VIResetDimmingCount</a>,
86<a href="VIGetDimmingCount.html">VIGetDimmingCount</a>
87</p>
88
89<h2>Revision History</h2>
90<p>
912007/07/12 Added a link to <CODE>VIResetDimmingCount</CODE>.<br>
92
93<!-- 2006/11/28 <CODE>VIResetDimmingCount</CODE>, <CODE>VIEnableDimming</CODE> ????????<br> --> 2006/10/25 Initial version.<br>
94</p>
95
96<hr><p>CONFIDENTIAL</p></body>
97</html>
98