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.

DESCRIPTION
     sboxf 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
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.