GINO Graphics Suite - GINOGRAF v9.5  

ggBlockFillHistogram

Syntax

[C/C++:]
void ggBlockFillHistogram(int ncols, float *yarray, float frac, int line);
[F90:]
subroutine ggBlockFillHistogram(ncols, yarray, frac, line)

integer, intent(in) :: ncols, line
real, intent(in) :: yarray(*), frac

Arguments

ncols
The number of columns in the Histogram

yarray
Array, of dimension ncols, giving the heights of all the columns in the Histogram


frac
Fraction of an interval to be filled for each column

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 ggBlockFillHistogram() block fills the columns of a Histogram with respect to either the current axes, as set up by ggSetAxesPos() and ggSetAxesScaling(), or the default Histogram axes used by ggPlotHistogram(). If a discrete axis has not been defined using ggSetAxesScaling(), 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 the front of each column has the height defined in the array yarray and the width = ((length of X axis)/ncols) * frac. If frac = 1.0, the fill occupies the whole interval. The columns are centred on the tick marks on the discrete axis.

All the columns 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

ggBlockFillHistogram Usage
ggPlotHistogram
ggSetBlockChartAttribs