spScissor.3p 1.1 KB
.TH spScissor 3P local "Silicon Graphics, Inc."
.SH NAME
spScissor \- Set the bounding region inwhich subsequent sprites will be drawn
.SH C SPECIFICATION
.nf
\f3#include <sp.h>

void spScissor( u32 xmin, u32 xmax, u32 ymin, u32 ymax)
\fP
.fi
.SH PARAMETERS
.TP 10
.I xmin
Horizontal position of left edge of scissoring window
.TP
.I xmax
Horizontal position of right edge of scissoring window
.TP
.I xmin
Vertical position of top edge of scissoring window
.TP
.I xmax
Vertical position of bottom edge of scissoring window
.SH DESCRIPTION
This function specifues the bounding region in which sprites 
will be drawn.  Any part of a sprite outside of this will not
be drawn.  Tiles entirely outside of this region will not be
drawn. Tiles partially outside this region will be properly
clipped so that only the part inside the region is drawn.
.PP
By default, the region starts out with xmin=0, xmax=319, ymin=0,
ymax=239.  Do not set this region to an area larger than the current
framebuffer as this may cause the hardware to hang.
.SH "SEE ALSO"
.IR spDraw (3P),
.IR spScale (3P),
.IR spScissor (3P),
.IR gDPSetImage (3P)