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
|
= 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 UsagegDefineHLSgDefineHSVgDefineRGBgTrueCol