VTurnOnOverlay
Name
VTurnOnOverlay - turns the specified overlay on.
Synopsis
VTurnOnOverlay(ovl, red, green, blue)
int ovl;
unsigned short red, green, blue;
Description
VTurnOnOverlay turns the specified overlay on with the specified RGB color.
VTurnOnOverlay changes the colormap entries and updates the 3DVIEWNIX
reserved color for the specified overlay. VTurnOnOverlay should be called
before calling other overlay functions, except VChangeNumberOfOverlays.
Return Value
0 - work successfully.
1 - memory allocation error.
225 - no overlay created.
Parameters
ovl - specifies the overlay number to be turned on.
red, green, blue - the RGB color to be used for the overlay.
Side Effects
None.
Entry Conditions
If ovl is not valid, or VCreateColormap is not called earlier,
VTurnOnOverlay prints an error message to the standard error stream,
produces a core dump file and exits from the current process.
Related Functions
VChangeNumberOfOverlays,
VTurnOffOverlay.