sboxf(3G)

NAME
     sboxf, sboxfi, sboxfs - draw a filled screen-aligned rectangle

FORTRAN 77 SPECIFICATION
     subroutine sboxf(x1, y1, x2, y2)
     real x1, y1, x2, y2

     subroutine sboxfi(x1, y1, x2, y2)
     integer*4 x1, y1, x2, y2

     subroutine sboxfs(x1, y1, x2, y2)
     integer*2 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.  polymo must be set to PYMFIL.

     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
     backfa, bgnpol, blendf, depthc, frontf, glcomp, lmbind, polymo, polysm,
     rectf, scrsub, setpat, shadem, stenci, subpix, texbin, zbuffe

NOTE
     By default sboxf draws a polygon using the old-style scan conversion
     algorithm, rather than the point sampling algorithm used by bgnpol and
     endpol.  Point sampling is prefered over old-style scan conversion
     because it has higher performance.  Call glcomp(GLCOLD,0) to enable point
     sampling of polygons generated by sboxf.