Syntax

[C/C++:]
void ggFillBelowDataset(int npts, GPOINT *points, float xylev, int xory, int fill, int line);

[F90:]
subroutine ggFillBelowDataset(npts, points, xylev, xory, fill, line)

type(GPOINT), intent(in) :: points(*)
integer, intent(in) :: npts, xory, fill, line
real, intent(in) :: xylev

Arguments

npts
The number of points on graph line

points
Array, of dimension npts, giving the data values of the points to be defined on the graph line

xylev
Value determining point on X or Y axis which is filled to. If xylev lies beyond the axes limits then that limit is used instead of xylev

xory

Flag determining whether xylev is on the X or Y axis = GXAXIS

xylev on X axis = GYAXIS%%xylev on Y axis

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 ggFillBelowDataset() fills the area between npts points on a graph held in the points array, and a line perpendicular to the X or Y axis, held in xylev. If xylev is outside of the current axes set up by the last axis definition then the relevant axis limits are used. Complete filled graphs may be achieved in conjunction with ggFillBetweenDatasets().

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

ggFillBelowDataset Usage
ggFillBetweenDatasets

---