Syntax

[C/C++:]
void ggBlockFillBarChart(int nbars, GBARCHART *bars, float frac, int line);

[F90:]
subroutine ggBlockFillBarChart(nbars, bars, frac, line)

type(GBARCHART), intent(in) :: bars(*)
integer, intent(in) :: nbars, line
real, intent(in) :: frac

Arguments

nbars
The number of bars in the Bar Chart

bars
Array of dimension nbars, giving the start and finish values of all the bars in the Bar Chart

frac
Fraction of an interval to be filled for each bar

line
Line style to be used to fill each column

= GCURRENT

Specifies the current line style

= 1 to 256

Specifies the line style index

>256	Specifies the current line style

Description

The routine ggBlockFillBarChart() block fills the bars of a Bar Chart, with respect to either the current axes, as set up by ggSetAxesPos() and ggSetAxesScaling(), or the default axes used by ggPlotBarChart(). If a discrete axis has not been defined (using ggSetAxesScaling() with scale=GDISCRETE) or both axes have been defined as discrete axes, the discrete axis is assumed to be the X axis. Linear scaling is assumed as the default for the Y axis.

The area filled for each bar has the start and finish values defined in the components bars.s and bars.f and the width ((length of discrete axis)/nbars) * frac. If frac = 1.0, the fill occupies the whole interval.

The bars are centred on the tick marks on the discrete axis.

All the bars are solid filled in the line style specified by line whereas the colour, depth and angle of the extrusions are determined by the current block fill settings as set by ggSetBlockChartAttribs(). The outline of each area is drawn in the current GINO line style.

See Also

ggBlockFillBarChart Usage
ggPlotBarChart
ggSetBlockChartAttribs

---