Syntax

[C/C++:]
void ggFillStepChart(int nsteps, GSTEPCHART *steps, float base, int xory, int *fill, int *line);

[F90:]
subroutine ggFillStepChart(nsteps, steps, base, xory, fill, line)
integer, intent(in) :: nsteps, xory, fill(*), line(*)
type(GSTEPCHART), intent(in) :: steps(*)
real, intent(in) :: base

Arguments

nsteps
The number of steps to be plotted

steps
Array of dimension nsteps, giving the start and finish widths and height values of all the steps in the Step Chart

base
Base value in graphical coordinates which steps are filled to

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 nsteps, determining the fill styles to be used to fill each column

< -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 nsteps, determining the 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

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

Description

The routine ggFillStepChart() draws filled rectangles defined by the data ranges held in the components steps.s and steps.f and between the base value on the axis on which the steps.h values are measured and the height values held in the component steps.h. The display of the rectangles is drawn 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 columns, held in steps.s and steps.f, are shown on the X axis if xory=GXAXIS, and on the Y axis if xory=GYAXIS.

The rectangles 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 rectangle is drawn. One or more of the rectangles 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

ggFillStepChart Usage

---