polf(3G)

NAME
     polf, polfi, polfs, polf2, polf2i, polf2s - draws a filled polygon

C SPECIFICATION
     void polf(long n, const Coord parray[][3])

     void polfi(long n, const Icoord parray[][3])

     void polfs(long n, const Scoord parray[][3])

     void polf2(long n, const Coord parray[][2])

     void polf2i(long n, const Icoord parray[][2])

     void polf2s(long n, const Scoord parray[][2])

     All of the above routines are functionally the same.  They differ only in
     the declared type of their parameters and whether or not they assume a
     two-dimensional or three-dimensional world.

PARAMETERS
     n        expects the number of vertices in the polygon.

     parray   expects the array containing the vertices of the polygon.

DESCRIPTION
     polf fills the polygonal area bounded by the vertices specified in
     parray.  The first and last vertices connect automatically to close a
     polygon.  The vertices can be expressed as integers, shorts, or real
     numbers, in 2-D or 3-D space.  2-D polygons are drawn with z=0.  After
     the polygon is filled, the current graphics position is set to the first
     vertex in the array.

     Properties that affect the drawing of polygons include the current color,
     writemask, fill pattern, shade model, polygon antialiasing mode, polygon
     scan conversion mode, and subpixel mode.  Some polygon modes are
     applicable only if old-style scan conversion is defeated.  (See note
     below.)

     There can be no more than 256 vertices in a polygon. In addition, polf
     cannot correctly draw polygons that intersect themselves.

SEE ALSO
     backface, bgnpolygon, concave, frontface, glcompat, poly, polymode,
     polysmooth, scrsubdivide, setpattern, shademodel, subpixel

NOTE
     By default polf 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, 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 glcompat(GLC_OLDPOLYGON,0) to enable point sampling
     of polygons generated by polf.