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

   

guParseGbiDL

Format
#include "ultra64.h"
void guParseGbiDL(u64 *gbi_dl,
   u32 nbytes, u8 flags)
Arguments
  • gbi_dl is the pointer to the Graphics Binary Interface (GBI) display list in DRAM
  • nbytes is the number of bytes in the GBI display list (0 causes entire display list to print)
  • flags includes the following flags, which may be OR'd together to enable printing of additional information about the display list:

    • GU_PARSEGBI_ROWMAJOR to print matrices in row major order; otherwise they are printed in column major order
    • GU_PARSEGBI_NONEST to not follow nested display lists
    • GU_PARSEGBI_FLTMTX to print matrices in floating-point format
    • GU_PARSEGBI_SHOWDMA to show DMA'd data
    • GU_PARSEGBI_ALLMTX to print modeling and projection matrices
    • GU_PARSEGBI_DUMPONLY to print the display list as a hexadecimal dump
What This Function Does
It prints a GBI display list in human readable format. It interprets and displays the commands and data in a GBI display list. For it to function, you must be running the dlprint tool on the Indy host. The parameters gbi_dl and nbytes are equivalent to the fields data_ptr and data_size in the OSTask structure, respectively. Usually the nbytes (data_size) parameter is set to 0, which causes the entire display list to be printed.

The GBI display list is processed by the graphics microcode running on the Reality Signal Processor (RSP) to produce a Reality Display Processor (RDP) format display list. The output of the RSP may be directed either directly to the RDP or to DRAM by using different microcode in the graphics task. If the RSP's output (the RDP display list) is stored in DRAM, the function guParseRdpDL may be used to print it in a readable format.

See Also
dlprint
guParseRdpDL
alParseAbiCL



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