.TH osDp 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
osDpGetStatus, osDpSetStatus, osDpSetNextBuffer \-
control and interrogate the display processor (DP)
.SH SYNOPSIS
.nf
\f3
.Op c
#include <ultra64.h>
.sp .8v
u32 osDpGetStatus(void);
.sp .8v
void osDpSetStatus(u32 status);
.sp .8v
s32 osDpSetNextBuffer(void *bufPtr, u64 size);
.Op
\f1
.fi
.SH DESCRIPTION
These routines provide basic control for the DP interface. 
.PP
The
.I osDpGetStatus
call simply returns the hardware status of the DP command status register.
The 32-bit returned value contains the following bits which may be of interest
to the user:
.PP
.TP 10
.I DPC_STATUS_TMEM_BUSY
DP texture load is in progress.
.TP
.I DPC_STATUS_PIPE_BUSY
DP primitive is still being processed.
.TP
.I DPC_STATUS_CMD_BUSY
DP command buffer is full.
.TP
.I DPC_STATUS_DMA_BUSY
DP DMA is in progress.
.PP
The
.I osDpSetStatus
call updates the DP command status register with
.I status.
The bits of potential interest to the user are as follows:
.PP
.TP 10
.I DPC_CLR_TMEM_CTR
Reset DP
.I TMEM
counter.
.TP
.I DPC_CLR_PIPE_CTR
Reset DP
.I PIPE
counter.
.TP
.I DPC_CLR_CMD_CTR
Reset DP
.I CMD
counter.
.TP
.I DPC_CLR_CLOCK_CTR
Reset DP
.I CLOCK
counter.
.PP
The
.I osDpSetNextBuffer
call updates the DP pointers causing the DP to begin reading an RDP display
list from the DRAM buffer located at 
.I bufPtr.
The length of the buffer must be indicated by 
.I size
which is the number of bytes in the RDP display list.
.SH "SEE ALSO"
.IR osDpGetCounters (3P)