GXSetCoPlanar

C Specification

##include <revolution/gx.h>

void GXSetCoPlanar( GXBool enable );

Arguments

enable When enable=GX_ENABLE, coplanar mode is enabled and the last triangle rendered becomes the reference plane. If enable=GX_DISABLE coplanar mode is disabled.

Return Values

None.

Description

This function uses enable to enable coplanar triangle processing. Coplanar mode should be enabled immediately after a reference triangle is drawn. While coplanar mode is enabled, all subsequent triangles (called decal triangles) will have the same Z coefficients as the reference plane.

Note: The reference triangle can be culled using:

GXSetCullMode(GX_CULL_ALL);

to create an invisible reference plane. However, the reference triangle must not be completely out of view, i.e. trivially rejected by clipping.

GXInit disables coplanar mode.

Revision History

2006/03/01 Initial version.