GINO Graphics Suite - GINO v9.0  

gSetLineColour

Syntax

[C/C++:]
void gSetLineColour(int col);
[F90:]
subroutine gSetLineColour(col)
integer, intent(in) :: col

Arguments

col
Colour setting

= 0, GBACKGROUND
= 1, GBLACK
= 2, GRED
= 3, GORANGE
= 4, GYELLOW
= 5, GGREEN
= 6, GCYAN
= 7, GBLUE
= 8, GMAGENTA
= 9, GBROWN
= 10, GWHITE
> 10, Index up to device colour capability

Description

The routine gSetLineColour() selects a colour for subsequent graphical output. The argument col can be an index in the current GINO colour table or (on a true colour device) a 24bit RGB triplet returned by the function gTrueCol().

The colour index values/constants described above represent the initial setting of the GINO colour table, which may however be modified using one of the colour definition routines  gDefineRGB(), gDefineHSV() or gDefineHLS(). Whether a colour actually appears on a device depends on the device's hardware capabilities.

The background colour is selected by setting col=GBACKGROUND. Graphical output may be erased from the picture by redrawing it with the background colour, provided that this is supported by the device.

If a negative value is passed in col, a warning message is output and the absolute value of col is used. When col is outside the range of colours of the device, a default colour is selected. A call to gEnqSelectedPen() returns the colour actually provided.

See Also

gSetLineColour Usage
gDefineHLS
gDefineHSV
gEnqLineColour
gDefineRGB
gTrueCol