GXSetZCompLoc

Syntax

#include <revolution/gx.h>

void GXSetZCompLoc( GXBool before_tex );

Arguments

before_tex: When set to GX_TRUE, it enables Z-buffering before texturing. Otherwise, Z-buffering takes place after texturing.

Return Values

None.

Description

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. However, when alpha compare is used, Z buffering must be done after texturing (see the GXSetAlphaCompare function).

Performance Notes

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.

See Also

GXSetZMode

Revision History

2006/03/01 Initial version.


CONFIDENTIAL