GINO Graphics Suite - GINO v9.0  

gEnqRGB

Syntax

[C/C++:]
void gEnqRGB(int col, GRGBSTY *rgb);
[F90:]
subroutine gEnqRGB(col, rgb)

integer, intent(in) :: col
type (GRGBSTY), intent(out) :: rgb

Arguments

col
Colour index

< 0, Dummy definition
= GBACKGROUND, Background colour index
> 0, Index up to device capability
> 224, Packed RGB triplet

rgb
Red, green, blue colour components

Description

The routine gEnqRGB() returns the red, green, blue values represented by col, where col may be an index into the GINO colour table or a packed RGB triplet.

Where col is an index into the GINO colour table, the red, green and blue values retruned represent the current colour setting of that entry in the table. This may be the default as defined at device initialisation, or the modified setting as defined by any of the colour definition routines, gDefineRGB(), gDefineHLS() or gDefine HSV().

If col<0, the colour values returned are those last specified by any of the colour definition routines.

The default values correspond to as many of the standard GINO colours as the device can implement. For plotters and other devices that do not cater for variable colours, or if col is out of range for the device, gEnqRGB() returns rgb.red, rgb.green and rgb.blue set to zero.

Packed RGB triplets are defined using the routine gTrueCol().

See Also

gEnqRGB Usage
gDefineHLS
gDefineHSV
gDefineRGB
gTrueCol