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><CODE>GXSetZCompLoc</CODE></TITLE> 9</HEAD> 10<BODY> 11<H1 align="left"><CODE>GXSetZCompLoc</CODE></H1> 12<H2>C Specification</H2> 13<DL> 14 <DD> 15<PRE><CODE>#include <revolution/gx.h></CODE></PRE> 16 <DD> 17<PRE>void GXSetZCompLoc( <a href="../Enumerated_Types/GXBool.html">GXBool</a> before_tex );</PRE> 18</DL> 19<H2>Arguments</H2> 20<TABLE border="1" cellpadding="3" cellspacing="0.1"> 21 <TBODY> 22 <TR> 23<TD width="120" valign="top" bgcolor="#ffffe8"><EM><STRONG>before_tex</STRONG></EM></TD> 24<TD width="520">Enables Z buffering before texturing when set to <code>GX_TRUE</code>. Otherwise, Z buffering takes place after texturing.</TD> 25 </TR> 26 </TBODY> 27</TABLE> 28<H2>Return Values</H2> 29<P>None.</P> 30<H2>Description</H2> 31<P>This function sets whether Z buffering happens before or after texturing. Normally, Z buffering happens before texturing, as this improves performance by not texturing pixels that are not visible. However, when alpha compare is used, Z buffering must be done after texturing (see <a href="../Tev/GXSetAlphaCompare.html">GXSetAlphaCompare</a>).</P> 32<H2>Performance Notes</H2> 33<P>Since changing the Z buffering location control requires the pixel pipeline to be synchronized, this function stalls the graphics processor. Therefore, avoid redundant calls of this function.</P> 34 35<H2>See Also</H2> 36<P><A href="GXSetZMode.html"><CODE>GXSetZMode</CODE></A></P> 37<H2>Revision History</H2> 38<P>2006/03/01 Initial version.</P> 39<hr> 40<P>CONFIDENTIAL</p> 41</BODY> 42</HTML>