gDPSetCycleType [Macro]

Function

gDPSetCycleType

Sets the RDP cycle type

Syntax

#include <ultra64.h>        /* gbi.h */
gDPSetCycleType(Gfx *gdl, u32 type)
gsDPSetCycleType(         u32 type)

Arguments

gdl

Display list pointer.

type

Cycle type.

G_CYC_1CYCLE (1-cycle mode)

G_CYC_2CYCLE (2-cycle mode)

G_CYC_COPY (Copy mode)

G_CYC_FILL (Fill mode)

Description

Sets the RDP to one of four rendering cycle types. To learn how to set the RDP, see Section 12 "RDP Programming" in the N64 Programming Manual. The cycle types are explained below:

G_CYC_1CYCLE (1-cycle mode)

In this mode, each element in the RDP pipeline is used once, and you can write 1 pixel per cycle.

This mode can be used to generate high-quality pixels that have been perspective-corrected, bilinear-filtered, modulate-textured/decal-textured, made transparent and Z-buffered.

G_CYC_2CYCLE (2-cycle mode)

In this mode, every element in the RDP pipeline except the rasterizer (RS) is used twice, and you can write 2 pixels per cycle.

This mode has all the features of 1-cycle mode, and it can also be applied to MIP-mapping and fog.

G_CYC_COPY (Copy mode)

Transfers the pattern in texture memory (TMEM) at a rate of 4 pixels per cycle (in 16-bit mode) or 2 pixels per cycle (in 32-bit mode).

This mode can copy images as large as 4 Kbytes.

G_CYC_FILL (Fill mode)

Writes at a rate of 4 pixels per cycle (when the value of the fill color register is set to 16-bit mode) or 2 pixels per cycle (when set to 32-bit mode).

This mode is used mainly to clear the color frame buffer and the Z buffer.

Note

For fill mode and copy mode, please use g*DPSetRenderMode (G_RM_NOOP,G_RM_NOOP2). If you try to use the Z buffer with fill mode, the RDP pipeline might hang.

See Also

gDPSetRenderMode

Revision History

02/01/99   Completely rewritten