sboxf(3G)sboxf(3G)NAME
sboxf, sboxfi, sboxfs - draw a filled screen-aligned rectangle
C SPECIFICATION
void sboxf(x1, y1, x2, y2)
Coord x1, y1, x2, y2;
void sboxfi(x1, y1, x2, y2)
Icoord x1, y1, x2, y2;
void sboxfs(x1, y1, x2, y2)
Scoord x1, y1, x2, y2;
All of the above functions are functionally the same except for the type
declarations of the parameters.
PARAMETERS
x1 expects the x coordinate of a corner of the filled box.
y1 expects the y coordinate of a corner of the filled box.
x2 expects the x coordinate of the opposite corner of the filled box.
y2 expects the y coordinate of the opposite corner of the filled box.
DESCRIPTIONsboxf draws a filled, two-dimensional, screen-aligned rectangle. The
rectangle is drawn as a single polygon, and therefore inherits many
properties that affect the drawing of polygons. These include the
current color, writemask, fill pattern, and subpixel mode.
The sides of the rectangle will be parallel to the screen x and y axes.
This rectangle cannot be rotated. The z coordinate is set to zero.
When you use sboxf, you must not use alpha blending, backfacing or
frontfacing, depthcueing, fog, gouraud shading, lighting, polygon
antialiasing, screen subdivision, stenciling, texture mapping, or z-
buffering. polymode must be set to PYM_FILLED.
sboxf may be faster than rectf on some machines. Use sboxf when you need
to draw a large number of screen-aligned rectangles.
After sboxf executes, the graphics position is undefined.
SEE ALSO
backface, bgnpolygon, blendfunction, depthcue, frontface, glcompat,
lmbind, polymode, polysmooth, rectf, scrsubdivide, setpattern,
shademodel, stencil, subpixel, texbind, zbuffer
Page 1
sboxf(3G)sboxf(3G)NOTE
By default sboxf draws a polygon using the old-style scan conversion
algorithm, rather than the point sampling algorithm used by bgnpolygon
and endpolygon. Point sampling is prefered over old-style scan
conversion because it has higher performance. Call
glcompat(GLC_OLDPOLYGON,0) to enable point sampling of polygons generated
by sboxf.
Page 2
