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

## gDPPipeSync [mode]

Synchronizes RDP attribute updates by waiting for pixels to be processed during the rendering process.

Syntax

    #include <ultra64.h> /* gbi.h */
    gDPPipeSync(Gfx *gdl)
    gsDPPipeSync(void)

Arguments

- gdl is the display list pointer

Explanation
This is a synchronization command that effects the timing of an RDP attribute update, making it wait during primitive rendering.

The RDP does not automatically synchronize primitive rendering with attribute updates. So if the attribute changes after the processing of a primitive has begun, this could affect the pixels while the primitive is being rendered.

For details, see Chapter 12, "RDP Programing," in the N64 Programming Manual.

There are three attributes for which synchronization is not necessary: the primitive color (g*DPSetPrimColor), the primitive depth (g*DPSetPrimDepth), and scissor (g*DPSetScissor).

Notes
As a general rule, the gDPPipeSync command must be inserted after a series of primitives. If you are going to execute a RDP attribute change command, be sure to insert gDPPipeSync before that command.

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
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated March 1998