GINO Graphics Suite - GINO v9.0  

gFillSelectedPolygons

Syntax

[C/C++:]
void gFillSelectedPolygons(void);

void gFillSelectedPolygons(int fill, int line, int inv);
[F90:]
subroutine gFillSelectedPolygons()

subroutine gFillSelectedPolygons(fill, line, inv)

integer, intent(in) :: fill,line,inv

Arguments

fill
Local polygon fill style (see gSetFillAttribs)

= GHOLLOW, Draw boundary
= GSOLID, Solid fill
= 1 - 256, Fill style index (hardware fill) or hatch style index (software fill)
> 256, Fill style index (hardware fill) or solid fill (software fill)

line
Local polygon fill line style (see gSetFillAttribs)

= GCURRENT, Current line style
= 1 - 256, Line style index
> 256, Current line style

inv
Local polygon inverse fill flag (see gSetFillAttribs)

= GAREA, Fill polygons
= GINVERSE, Fill all but polygons (inverse fill)

Description

The routine gFillSelectedPolygons() is used to fill polygons created using the routines gStartPolygon()/gEndPolygon() and selected using gSelectPolygons(). These polygons may consist of any combination of lines, moves, arcs and curves. As polygons may intersect there is a need for a more precise definition of the areas that should be filled: an area is filled if it is separated from the background area by an odd number of polygon boundaries. Inverse fill calls for an even number of separating boundaries and by definition always fills the background area (the continuous area that surrounds all polygons).

Although polygons may be defined anywhere in picture space, the fill actually generated will be clipped to the current clipping limits.

The routines may be used with the global filling attributes, set by gSetFillAttribs(), or locally overridding the filling attributes by including the fill, line and inv arguments.

The current position is restored to that prior to calling gFillSelectedPolygons().

See Also

gFillSelectedPolygons Usage
gStartPolygon
gEndPolygon
gSelectPolygons
gSetFillMode
gDefineHatchStyle
gDefineLineStyle