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 5.0">
7<meta http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9<title>VIGetNextField</title>
10</head>
11
12<body>
13
14<h1 align="left">VIGetNextField</h1>
15
16<h2>C Specification</h2>
17
18<dl>
19<dd><pre><code>#include &lt;revolution/vi.h&gt;</code></pre>
20  </dd>
21<dd><pre><code>u32 VIGetNextField(void)</code></pre>
22  </dd>
23</dl>
24
25<h2>Arguments</h2>
26
27<p>None.</p>
28
29<h2>Return Values</h2>
30
31<p><CODE>VI_FIELD_ABOVE</CODE> if the next field is 'above'. <CODE>VI_FIELD_BELOW</CODE> if 'below'.</p>
32
33<h2>Description</h2>
34
35<p>This function returns whether the next field is 'above' or 'below'. This function is designed for field-rendering so useful information can only be obtained if the TV mode is interlaced and the XFB mode is SF (single field). The 'above' field is the content the XFB is going to draw on the even-numbered lines (0, 2, 4, etc.) on the screen. The 'below' field is the content the XFB is going to draw on the odd-numbered lines (1, 3, 5, etc.). The return value of this function should directly be passed to <a href="../gx/Transform/GXSetViewportJitter.html"><code>GXSetViewportJitter</code></a>.</p>
36
37<h2>See Also</h2>
38
39<p><code><a href="VIInit.html">VIInit</a>, <a href="../gx/Transform/GXSetViewportJitter.html">GXSetViewportJitter</a></code></p>
40
41<h2>Revision History</h2>
42
43<P>03/01/2006 Initial version.</p>
44</body>
45</html>