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

   

nuGfxFuncSet

Format
void nuGfxFuncSet(NUGfxFunc func)

Arguments
  • func is the callback function
Returned Value
none

What This Function Does
It registers the callback function that will be executed in sync with the retrace in the graphics thread. The number of graphics tasks remaining in the queue of the graphics task thread is passed as an argument by the function specified by func. The func function is defined using this code:

void func (u32 gfxTaskNum)

To remove a callback function, use the nuGfxFuncRemove function.

Example
/* retrace function */
void retraceFunc(u32 gfxTaskNum)
{
/* if graphic tasks remain, do no processing */
if(gfxTaskNum >0) return;
.......
}
void gameGfxInit(void)
{
.......
/* registers function to be executed by retrace */
nuGfxFuncSet(retraceFunc);
}
See Also
nuGfxFuncRemove



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 January 1998