Syntax

[C/C++:]
 int gTrueCol(float red, float green, float blue);

[F90:]
integer function gTrueCol(red, green, blue)
real, intent (in) :: red,green,blue

Arguments

red
Red intensity, 0.0 to 1.0

green
Green intensity, 0.0 to 1.0

blue
Blue intensity, 0.0 to 1.0

Description

The function gTrueCol() returns a packed 24bit true colour value derived from the supplied red, green and blue intensities.

The returned value contains 8 bits of colour information for each of the three primaries and can be used for passing true colour information to the current device through routines such as gSetLineColour() etc, when operating in true colour mode (as set by gSetColourInfo()).

Devices which can operate in true colour mode and have been set in that mode using gSetColourInfo() can accept true colour information through gSetColourInfo(), gDrawPixel() and gDrawPixelArea(). Users should refer to Appendix B to determine whether a device can operate in true colour mode before using this routine.

The routine gEnqRGB() can be used to unpack a RGB triplet value defined by this routine.

See Also

gTrueCol Usage
Device Drivers
gDrawPixel
gDrawPixelArea
gEnqRGB
gSetColourInfo
gSetLineColour

---