rectf(3G)

rectf, rectfi, rectfs - fills a rectangular area

As shipped in IRIX 6.5. First release of IRIX 6.5.

NAME
     rectf, rectfi, rectfs - fills a rectangular area

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

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

     subroutine rectfs(x1, y1, x2, y2)
     integer*2 x1, y1, x2, y2

     All of the above routines are functionally the same.  They differ only in
     the type declarations of their parameters.

PARAMETERS
     x1   expects the x coordinate of one corner of the rectangle that is to
          be drawn.

     y1   expects the y coordinate of one corner of the rectangle that is to
          be drawn.

     x2   expects the x coordinate of the opposite corner of the rectangle
          that is to be drawn.

     y2   expects the y coordinate of the opposite corner of the rectangle
          that is to be drawn.

DESCRIPTION
     rect draws a filled rectangle in the x-y plane with z assumed to be zero.
     The sides of the rectangle are parallel to the x and y axes.  To create a
     rectangle that does not lie in the x-y plane, draw the rectangle in the
     x-y plane, then rotate and/or translate the rectangle.

     A rectangle is drawn as a single polygon, and therefore inherits all
     properties that affect the drawing of polygons.  These include the
     current color, writemask, fill pattern, shade model, polygon antialiasing
     mode, polygon scan conversion mode, and subpixel mode.  Front-face and
     back-face elimination work correctly with filled rectangles.  The front-
     face of a rectangle faces the positive z half-space when (x1, y1) is the
     lower-left corner of the rectangle in object coordinates.  Some polygon
     modes are applicable only if old-style scan conversion is defeated.  (See
     note below.)

     After rectf executes, the graphics position is undefined.

SEE ALSO
     backfa, bgnpol, frontf, glcomp, polymo, polysm, rect, scrsub, setpat,
     shadem, subpix
NOTES
     Previous graphics library implementations set the current graphics
     position to (x1, y1) after the rectangle was drawn.  Current graphics
     position is now undefined after a rectangle is drawn.

     By default rectf 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, it results in higher-quality images
     when blending, logical operations, or stenciling are used, and it
     supports new rendering features such as texture mapping, fog, and
     antialiasing.  Call glcomp(GLCOLD,0) to enable point sampling of polygons
     generated by rectf.