Syntax

[C/C++:]
void ggDisplayMarkerColumn(float x, float y, int nsym, int *sym, int *line, char header[ ]);

[F90:]
subroutine ggDisplayMarkerColumn(x, y, nsym, sym, line, header)

real, intent(in) :: x, y
integer, intent(in) :: nsym, sym(*), line(*)
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

nsym
Number of symbols in the column

sym
Array of length nsym containing symbols to be output in each cell

= GSPOT

Dot

= GUP

Standard GINO symbol

= GDOWN

Standard GINO symbol

= GPLUS

Standard GINO symbol

= GCROSS

Standard GINO symbol

= GBOX

Standard GINO symbol

= GDIAMOND

Standard GINO symbol

= GCIRCLE

Standard GINO symbol

= GSTAR

Standard GINO symbol

= 9 to 23

Optional hardware symbol

> 23	Character from font table

line
Array of dimension nsym, determining the line style to be used for the corresponding symbol

= GCURRENT

Specifies the current line style

= 1 to 256

Specifies the line style index

>256	Specifies the current line style

header
Column header

Description

The routine ggDisplayMarkerColumn() outputs a set of symbols in an optionally headed column with its top left corner positioned at x,y. The column is divided into nsym or nsym+1 cells (depending on the header switch) into which the symbols are drawn. A column frame is also drawn using the Text Chart frame line style index set by ggSetTextChartAttribs().

The symbol numbers required for each cell are held in the array sym. Any of the valid GINO standard or font symbol numbers may be used. Negative symbol numbers or symbols that are not available default to symbol GUP. They are drawn centrally within each cell in the line 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 string header is output in an additional header cell if header cells have been switched on in the previous call to ggSetTextChartAttribs(). If displayed, the string is output centrally in the cell using the current GINO attributes.

See Also

ggDisplayMarkerColumn Usage
ggSetTextChartAttribs

---