Syntax

[C/C++:]
void ggFillAreaChart(int nareas, GAREACHART *areas, int xory, int *fill,
int *line);

[F90:]
subroutine ggFillAreaChart(nareas, areas, xory, fill, line)

integer, intent(in) :: nareas, xory, fill(*), line(*)
type(GAREACHART), intent(in) :: areas(*)

Arguments

nareas
The number of areas to be plotted

areas
Array of structures giving data for the Area Chart

xory
Flag determining which axis the data ranges are shown on, and on which axis the heights are shown

= GXAXIS

Data on X axis, heights on Y axis

= GYAXIS

Data on Y axis, heights on X axis

fill
Integer array, of dimension nareas, determining the fill styles to be used to fill each bar

< -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
Integer array, of dimension nareas, determining the line style to be used to fill each column

= GCURRENT

Specifies the current line style

= 1 -256

Specifies the line style index

>256	Specifies the current line style

The value of an element of line is irrelevant where the corresponding element of fill has a value of less than -1

Description

The routine ggFillAreaChart() draws filled rectangles defined by the data ranges held in the components areas.s and areas.f and height values held in the components areas.h1 and areas.h2, with respect to either the current axes, as set up by ggSetAxesPos() and ggSetAxesScaling(), or the default axes used by one of the high level routines. The widths of the areas, held in areas.s and areas.f, are shown on the X axis if xory=GXAXIS, and on the Y axis if xory=GYAXIS.

The areas are filled in the style determined by the combination of the corresponding elements of fill and line. Where a fill element is equal to GHOLLOW, only the boundary of the area is drawn. One or more of the segments may be left unfilled by giving the corresponding element(s) of fill a value of -2 or less. Negative values of line cause 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

ggFillAreaChart Usage
ggPlotAreaChart
ggAddAreaChartOutline
ggAddAreaChartValues

---