GXSetZCompLoc

C Specification

#include <revolution/gx.h>
void GXSetZCompLoc( GXBool before_tex );

Arguments

before_tex Enables Z buffering before texturing when set to GX_TRUE. Otherwise, Z buffering takes place after texturing.

Return Values

None.

Description

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 GXSetAlphaCompare).

Performance Notes

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.

See Also

GXSetZMode

Revision History

03/01/2006 Initial version.