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 name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<TITLE>GXSetFieldMode</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GXSetFieldMode</H1>
12
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15#include &lt;revolution/gx.h&gt;
16
17void GXSetFieldMode( <A href="../Enumerated_Types/GXBool.html">GXBool</A> field_mode, <A href="../Enumerated_Types/GXBool.html">GXBool</A> half_aspect_ratio );
18</pre></dd></dl>
19
20<H2>Arguments</H2>
21<TABLE class="arguments" border="1" >
22  <TBODY>
23    <TR>
24<TH>field_mode</TH>
25<TD>When true, adjusts texture LOD computation as explained in the description. If false, no adjustment.</TD>
26    </TR>
27    <TR>
28<TH>half_aspect_ratio</TH>
29<TD>When true, adjust the line aspect ratio as suitable. If false, no adjustment.</TD>
30    </TR>
31  </TBODY>
32</TABLE>
33
34<H2>Return Values</H2>
35<P>None.</P>
36
37<H2>Description</H2>
38<P>This function controls various rasterization and texturing parameters that relate to field-mode and double-strike rendering.&nbsp;In field-mode rendering, adjust the vertical part of the texture LOD computation to account for the fact that pixels cover only half of the space from one rendered scan line to the next (with the other half of the space filled by a pixel from the other field).&nbsp;In both field-mode and double-strike rendering, adjust the aspect ratio for points and lines to account for the fact that pixels will be double-height when displayed (the pixel aspect ratio is 1/2).</P>
39<P>The values set here usually come directly from the <a href="../Framebuffer/RenderMode.html">render mode</a>.&nbsp;The <SPAN class="argument">field_rendering</SPAN> flag is passed directly to <SPAN class="argument">field_mode</SPAN>.&nbsp;The <SPAN class="argument">half_aspect_ratio</SPAN> parameter is true if <SPAN class="argument">xfbHeight</SPAN> is half of <SPAN class="argument">viHeight</SPAN>, false otherwise.</P>
40<P>The <A href="../Management/GXInit.html"><CODE>GXInit</CODE></A> function sets both fields according to the default render mode.</P>
41
42<H2>See Also</H2>
43<P class="reference">
44<A href="GXSetFieldMask.html">GXSetFieldMask</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>