N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential





gDPSetCycleType [macro]

Sets the RDP cycle type.

Syntax

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

Arguments

  • gdl is the display list pointer.

  • type is the cycle type.
    G_CYC_1CYCLE (1-cycle mode)
    G_CYC_2CYCLE (2-cycle mode)
    G_CYC_COPY (Copy mode)
    G_CYC_FILL (Fill mode)

Explanation
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.

Notes
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
2/1/99 Completely rewritten.




Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998-1999
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last Updated April, 1999