1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<meta http-equiv="Content-Style-Type" content="text/css">
6<link rel="stylesheet" type="text/css" href="../CSS/revolution.css">
7<title>VIInit</title>
8</head>
9<body>
10<h1 align="left">VIInit</h1>
11
12<h2>Syntax</h2>
13<dl><dd><pre class="construction">#include &lt;revolution/vi.h&gt;
14
15void VIInit(void);
16</pre></dd></dl>
17
18<h2>Arguments</h2>
19<p>None.</p>
20
21<h2>Return Values</h2>
22<p>None.</p>
23
24<h2>Description</h2>
25<p>This function sets the default state of the video controller. It <font color="#FF0000"><u><strong>must be called before any other VI functions are called.</strong></u></font>
26</p>
27
28<p>How <code>VIInit</code> initializes the video controller depends on the selected TV format when this function is called.</p>
29
30<p><strong>When the TV format is NTSC:</strong> On NTSC hardware, the IPL initializes the TV format to NTSC. <code>VIInit</code> configures the video controller to display at 640x480 and 60Hz and retains the scan type (interlaced, non-interlaced or progressive) and the TV format (NTSC) as set by the IPL.</p>
31
32<p><strong>When the TV format is PAL: </strong> On PAL hardware, IPL initializes the TV format to PAL. In this case, <code>VIInit</code> configures the video controller to display at 640x574 and retains the scan type (interlaced, non-interlaced or progressive) and TV format (PAL or EURGB60) as set by the IPL. Restarting does not change the TV format.
33</p>
34
35<p>
36When execution of <code>VIInit</code> completes, both the D-Terminal cable (component cable) connection and <code>SCGetProgressiveMode</code> have been checked already, so there is no need for the application to perform these checks.
37</p>
38
39<p><code>VIInit</code> disables the trap filter and sets the gamma value to 1.0.<br>After a forced recovery from screen burn-in protection, the burn-in protection settings from the system settings menu are set.
40</p>
41
42<h2>See Also</h2>
43<p>None.</p>
44
45<h2>Revision History</h2>
46<p>
472008/06/16 Mentioned that progressive mode is also considered when determining scan type.<br>2008/04/08 Corrected a mention of MPAL that had escaped deletion.<br>2007/12/04 Deleted the MPAL description.<br>2006/10/17 Revised the description of the video mode set initially.<br>2006/09/21 Changed &quot;screen saver&quot; to &quot;burn-in protection&quot; in the descriptions.<br>2006/09/16 Added description regarding trap filter, gamma value, and burn-in protection.<br>2006/03/01 Initial version.<br>
48</p>
49
50<hr><p>CONFIDENTIAL</p></body>
51</html>