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

   

nuGfxInit

Format
void nuGfxInit(void)

Returned Value
none

What This Function Does
It initializes and activates the graphics thread and the Graphics Task Manager. It completes the following initializations and settings:
  • It creates and activates the thread to execute the callback function synchronized with a retrace. (The retrace callback function is entered with the nuGfxFuncSet function.) The thread also executes the callback function synchronized with a PRE-NMI event. (The PRE-NMI callback function is entered with the nuGfxPreNMIFuncSet function).
  • It registers the frame buffer, Z-Buffer, and graphics microcode. That is, it sets the address of the frame buffer and Z-Buffer in the Graphics Task Manager, and it also registers the graphics microcode.

    By default, it sets the frame buffer in RDRAM in three 320 by 240 16-bit blocks from 0x8038F800; it sets the Z-Buffer in 320 by 240 16-bit blocks from 0x80000400; and it registers the microcode for the F3DEX series, for L3DEX, and for S2DEX.

    The frame buffer can be reset with the nuGfxSetCfb function. The Z-Buffer can be reset with the nuGfxSetZBuffer function. The microcode can be re-entered with the nuGfxSetUCode function.
  • It registers the callback function executed at the end of a graphics task. If NU_GFX_SWAPBUFFER is specified as an argument in the nuGfxTaskStart function, then when that function is called, the nuGfxSwapCfb function will be registered by nuGfxInit at the end of the task. For application-independent processes, use the nuGfxSwapCfbFuncSet function to register the callback function.
  • It initializes the reality display processor (RDP). The RDP value is not fixed, but initial settings are made when a graphics task is activated. Once nuGfxInit is called, the nuGfxTaskStart function can be used.
See Also
nuGfxFuncSet
nuGfxSetCfb
nuGfxSetZBuffer
nuGfxSetUcode
nuGfxSwapCfb
nuGfxSetSwapCfbFunc



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