Syntax
[C/C++:]
void ggDisplayGeneratedColumn(float x, float y, int nval, float vbeg, float vend, char header[ ]);
[F90:]
subroutine ggDisplayGeneratedColumn(x, y, nval, vbeg, vend, header)
real, intent(in) :: x, y, vbeg, vend
integer, intent(in) :: nval
character*(*), intent(in) :: header
Arguments
x
X coordinate of the top left hand corner of the column in the current units (default units are millimetres)
y
Y coordinate of the top left hand corner of the column in the current units
nval
The number of values to be output between and including
vbeg and
vend
vbeg
First value to be output
vend
Last value to be output
header
Column header
Description
The routine ggDisplayGeneratedColumn() generates a set of values and outputs them in an optionally headed column with its top left corner positioned at
x,
y in user space coordinates. The column is divided into
nval or
nval+1 cells (depending on the header switch) into which the generated values are placed according to the current Text Chart justification as set by ggSetTextChartAttribs(). A column frame is also drawn using the Text Chart frame colour index also set by ggSetTextChartAttribs().
nval numbers are generated equally spaced from
vbeg to
vend inclusively. For example, if
vbeg = 1,
vend = 7 and
nval = 4 then the numbers 1, 3, 5, and 7 are output. The values are output, using the current GINO text and line attributes, in the format of the current Y axis annotation as set by ggSetAxesAnnotation(). Prefix and/or suffix strings may be added to each value in the column using the routine ggSetValueTags().
The string
header is output in an additional header cell if headers are switched on in the previous call to ggSetTextChartAttribs(). If displayed, the string is output centrally in the cell using the current GINO text and line attributes.
See Also
ggDisplayGeneratedColumn UsageggSetAxesAnnotationggSetTextChartAttribsggSetValueTags
