Syntax
[C/C++:]
void ggAddAreaChartValues(int nareas, GAREACHART *areas, int sfl, int xory);
[F90:]
subroutine ggAddAreaChartValues(nareas, areas, sfl, xory)
integer, intent(in) :: nareas, sfl, xory
type(GAREACHART), intent(in) :: areas(*)
Arguments
nareas
The number of areas to be annotated
areas
Array of structures giving data for the Area Chart
sfl
Flag determining which aspect of each area is output
|
= GSTART |
Value of areas.s is output |
|
= GFINISH |
Value of areas.f is output |
|
= GLOWER |
Value of areas.h1 is output |
|
= GUPPER |
Value of areas.h2 is output |
|
= GWIDTH |
Area width is output (ie, areas.f - areas.s) |
|
= GHEIGHT |
Area height is output (ie, areas.h2 - areas.h1) |
|
= GAREA |
Area of rectangle is output
(ie, (areas.f-areas.s)*(areas.h2-areas.h1)) |
xory
Specified axis on which the data widths are represented
Description
The routine ggAddAreaChartValues() displays the area coordinates, widths, heights, or areas, with respect to the current axes as set up by the last axis definition calls or through a previous call to ggPlotAreaChart().
xory determines which direction the areas are displayed, thus if
xory=GXAXIS the
areas.s and
areas.f values are displayed on the X axis and
areas.h1 and
areas.h2 values are displayed on the Y axis. If ggAddAreaChartValues() follows a call to ggPlotAreaChart(),
xory should be set to GXAXIS.
The most recent call to ggSetValueAttribs() determines the position of the annotation about each area as well as the angle, justification and offset of the value string. The default is to position the required value at the centre of each area. Start, finish, width and area values are output according to the format of the
xory axis, whereas lower, upper and area height values are output according to the format of the other axis. The format is set by the most recent call to ggSetAxesAnnotation(). Prefix and suffix strings defined by the most recent call to ggSetValueTags() are appended to the numerical output.
If
sfl is out or range, a warning message is output and the area of the rectangles are displayed.
See Also
ggAddAreaChartValues UsageggSetAxesAnnotationggPlotAreaChartggFillAreaChartggAddAreaChartOutlineggSetValueAttribsggSetValueTags
