Syntax

[C/C++:]
void ggDisplayFillColumn(float x, float y, int nfill, int *fill, int *line, char header[ ]);

[F90:]
subroutine ggDisplayFillColumn(x, y, nfill, fill, line, header)

real, intent(in) :: x, y
integer, intent(in) :: nfill, fill(*), 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

nfill
The number of filled rectangles

fill
Integer array, of dimension nfill, determining the fill styles to be used in each cell

< -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 nfill, determining the line style to be used to fill the rectangle
The value of line is irrelevant where fill has a value less than -1

= 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 ggDisplayFillColumn() outputs a set of rectangles in an optionally headed column with its top left corner positioned at x,y in user space coordinates. The column is divided into nfill or nfill+1 cells (depending on the header switch) into which the rectangles are drawn. A column frame is also drawn using the Text Chart frame line style index set by ggSetTextChartAttribs().

The rectangle in each cell is 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 cells 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.

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

ggDisplayFillColumn Usage
ggSetTextChartAttribs

---