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>GXSetFieldMask</title>
10</head>
11
12<body>
13
14<h1 align="left">GXSetFieldMask</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/gx.h&gt;
19
20void GXSetFieldMask( <a href="../Enumerated_Types/GXBool.html">GXBool</a> odd_mask, <a href="../Enumerated_Types/GXBool.html">GXBool</a> even_mask );
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<TH>odd_mask</TH>
27<TD>Writes pixels with odd Y coordinates.</TD>
28  </tr>
29  <tr>
30<TH>even_mask</TH>
31<TD>Write pixels with even Y coordinates.</TD>
32  </tr>
33</TABLE>
34
35<h2>Return Values</h2>
36<p>None.</p>
37
38<H2>Description</H2>
39<P>This function is used when rendering fields to an interlaced embedded frame buffer (EFB).&nbsp;It selectively enables and disables interlacing of the frame buffer image.&nbsp;When the mask is <CODE>GX_FALSE</CODE>, the field will not be written to the EFB.&nbsp;However, the other field will be computed.&nbsp;In other words, it will cost the fill rate price of a frame to produce a field.&nbsp; The recommended method for field rendering does not use field masking. For more information, see <A href="../Framebuffer/RenderMode.html">Render Modes</A>.</P>
40<P>The <A href="../Management/GXInit.html"><CODE>GXInit</CODE></A> function enables rendering for both fields.</P>
41
42<h2>See Also</h2>
43<P class="reference">
44<A href="GXSetFieldMode.html">GXSetFieldMode</A>
45</P>
46
47<H2>Revision History</H2>
48<P>
492006/03/01 Initial version.<br>
50</P>
51
52<hr><p>CONFIDENTIAL</p></body>
53</HTML>