GINO Graphics Suite - GINOGRAF v9.5  

ggFillBetweenDatasets

Syntax

[C/C++:]
void ggFillBetweenDatasets(int n1, GPOINT *xy1, int n2, GPOINT *xy2, int fill, int line);
[F90:]
subroutine ggFillBetweenDatasets(n1, xy1, n2, xy2, fill, line)

integer, intent(in) :: n1, n2, fill, line
type(GPOINT), intent(in) :: xy1(*), xy2(*)

Arguments

n1
The number of points on first graph line

xy1
Array, of dimension n1, giving the data values of the points to be defined on the first graph line

n2
The number of points on second graph line

xy2
Array, of dimension n2, giving the data values of the points to be defined on the second graph line

fill
Fill style

< -1 Specifies no fill and no boundary
=  GHOLLOW Specifies boundary only
=  GSOLID Specifies a solid fill
=  GFINEHORIZONTAL }
=  GFINEVERTICAL }
=  GFINELEFTDIAGONAL }
=  GFINERIGHTDIAGONAL }
=  GFINEHORIZONTALGRID }
=  GFINEDIAGONALGRID }
=  GFINEHORIZONTALMESH } Specifies the hatch
=  GFINEDIAGONALMESH } style index
=  GCOARSEHORIZONTAL }
=  GCOARSEVERTICAL }
=  GCOARSELEFTDIAGONAL }
=  GCOARSERIGHTDIAGONAL }
=  GCOARSEHORIZONTALGRID }
=  GCOARSEDIAGONALGRID }
=  GCOARSEHORIZONTALMESH }
=  GCOARSEDIAGONALMESH }
>256 Specifies a solid fill for software fill, or the fill style index for hardware fill
line
Number determining the line style to be used to fill graph

= GCURRENT Specifies the current line style
= 1 to 256 Specifies the line style index
>256 Specifies the current line style

The value of line is irrelevant where fill is less than -1

Description

The routine ggFillBetweenDatasets() fills the area between two sets of points on a graph held in the arrays xy1 and xy2, where each set of points is made up of n1 and n2 points respectively. Complete filled graphs may be achieved in conjunction with ggFillBelowDataset().

The area is filled in the style determined by the combination of the values of fill and line. Where fill is equal to GHOLLOW, only the boundary of the area is drawn. A negative value of line causes a warning to be output and the absolute value is used. The default line styles, hatch styles and fill styles appear in Appendix A of this manual (see Defaults). The current line style is left unchanged.

See Also

ggFillBetweenDatasets Usage
ggFillBelowDataset