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>GXSetZCompLoc</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GXSetZCompLoc</H1>
12
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15#include &lt;revolution/gx.h&gt;
16
17void GXSetZCompLoc( <A href="../Enumerated_Types/GXBool.html">GXBool</A> before_tex );
18</pre></dd></dl>
19
20<H2>Arguments</H2>
21<TABLE class="arguments" border="1" >
22  <TBODY>
23    <TR>
24<TH>before_tex:</TH>
25<TD>When set to <code>GX_TRUE</code>, it enables Z-buffering before texturing.&nbsp;Otherwise, Z-buffering takes place after texturing.</TD>
26    </TR>
27  </TBODY>
28</TABLE>
29
30<H2>Return Values</H2>
31<P>None.</P>
32
33<H2>Description</H2>
34<P>This function sets whether Z buffering happens before or after texturing. Normally, the Z buffering should be performed before texturing as this improves performance by not texturing pixels that are not visible.&nbsp;However, when alpha compare is used, Z buffering must be done after texturing (see the <A href="../Tev/GXSetAlphaCompare.html"><CODE>GXSetAlphaCompare</CODE></A> function).</P>
35
36<H2>Performance Notes</H2>
37<P>Since changing the Z buffering location control requires the pixel pipeline to be synchronized, this function stalls the graphics processor. Therefore, redundant calls of this function should be avoided.</P>
38
39<H2>See Also</H2>
40<P class="reference">
41<A href="GXSetZMode.html">GXSetZMode</A>
42</P>
43
44<H2>Revision History</H2>
45<P>
462006/03/01 Initial version.<br>
47</P>
48
49<hr><p>CONFIDENTIAL</p></body>
50</HTML>