.TH guParseGbiDL 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
guParseGbiDL \- Print a GBI display list in human readable format.
.SH C SPECIFICATION
.nf
\f3#include "ultra64.h"

void guParseGbiDL(u64 *gbi_dl, u32 nbytes, u8 flags)

\fP
.fi
.SH PARAMETERS
.TP 10
.I gbi_dl
pointer to Graphics Binary Interface (GBI) display list in DRAM.
.TP
.I nbytes
number of bytes in GBI display list (0 causes entire display list to print.)
.TP
.I flags
The following flags may be OR'd together to enable printing of
additional information about the display list.

.I GU_PARSEGBI_ROWMAJOR
Print matrices in row major order.  Otherwise printed in column major order.

.I GU_PARSEGBI_NONEST
Do not follow nested display lists.

.I GU_PARSEGBI_FLTMTX
Print matrices in floating point.

.I GU_PARSEGBI_SHOWDMA
Show DMA'd data.

.I GU_PARSEGBI_ALLMTX
Print modeling and projection matrices.

.I GU_PARSEGBI_DUMPONLY
Print the display list as a hexadecimal dump.

.SH DESCRIPTION
This function interprets and displays the commands and data in a GBI display
list. For it to function you must be running the tool,
.B dlprint 
on the Indy host.
The parameters
.B gbi_dl
and
.B nbytes
are equivelent to the fields
.B data_ptr
and
.B data_size
in the 
.I OSTask
structure, respectively. Normally the
.B nbytes (data_size)
parameter is set to 0, which causes the entire display list to be printed.






.P
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
.I guParseRdpDL (3P)
may be used to print it in a readable format (see
.I guParseRdpDL (3P)).
.P
.SH SEE ALSO
.IR dlprint (1),
.IR guParseRdpDL (3P),
.IR alParseAbiCL (3P)