#include <revolution/gx.h>
void GXSetCoPlanar( GXBool enable );enable |
Coplanar mode is enabled when enable is set to GX_ENABLE. The last polygon to be rendered before coplanar mode is enabled will become the reference plane.Coplanar mode is disabled when enable is set to GX_DISABLE. |
None.
This function enables coplanar mode when enable is set to GX_ENABLE. When coplanar mode is enabled, every polygon will be rendered on the reference plane with the same Z value as the reference plane. This plane is defined by the last polygon rendered before coplanar mode was enabled (the reference polygon).
The rendering procedure is as follows.
1. Always set the Z comparison mode to GX_LEQUAL.
2. Render the reference polygon.
3. Call GXSetCoplanar(GX_ENABLE) to enable coplanar mode. The reference plane will be defined by the reference polygon.
4. Polygons are rendered from back to front. These polygons share the same plane as the reference polygon.
5. Call GXSetCoplanar(GX_DISABLE) to disable coplanar mode.
The reference polygon does not need to be visible. You can use the following command to make the reference polygon invisible.
GXSetCullMode(GX_CULL_ALL);
However, the reference polygon must not be entirely outside the viewport; in other words, it cannot be placed where it will be trivially rejected by clipping.
Coplanar mode is disabled when enable is set to GX_DISABLE. Coplanar mode is also disabled when the GXInit function has been called.
2008/05/13 Cleaned up content.
2006/03/01 Initial version.
CONFIDENTIAL