Syntax
[C/C++:]
void ggDisplayLineColumn(float x, float y, int nline, int *line, int ang, char header[ ]);
[F90:]
subroutine ggDisplayLineColumn(x, y, nline, line, ang, header)
real, intent(in) :: x, y
integer, intent(in) :: nline, line(*), ang
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
nline
The number of lines
line
Integer array, of dimension
nline, determining the line style to be used in each cell
|
= GCURRENT |
Specifies the current line style |
|
= 1 to 256 |
Specifies the line style index |
|
>256 |
Specifies the current line style |
ang
Flag determining which angle the lines are displayed
|
= GRIGHTDIAGONAL |
Bottom left to top right |
|
= GLEFTDIAGONAL |
Top left to bottom right |
header
Column header
Description
The routine ggDisplayLineColumn() outputs a set of lines in an optionally headed column with its top left corner positioned at
x,
y in user space coordinates. The column is divided into
nline or
nline+1 cells (depending on the header switch) into which the lines are drawn. A column frame is also drawn using the Text Chart frame line style index set by ggSetTextChartAttribs().
The line in each cell is drawn in the style of the corresponding index held in the array
line, each element pointing to an entry in the GINO line style table. If the array
line contains any negative line style indices, a warning message is output and the absolute value is used. The line is drawn in one of four directions depending on the value of
ang. If the value of
ang is out of range, option 3 is used.
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
ggDisplayLineColumn UsageggSetTextChartAttribs
