_gPalSet()
 Set the current color palette
------------------------------------------------------------------------------
 C Prototype

     #include "llibg.api"
     ERRCODE _gPalSet(
                       LLG_LPPALETTE lpPaletteSet
                     )

 Arguments

     lpPaletteSet is a pointer to an LLG_PALETTE structure that you must
     allocate and initialize prior to calling this function.  _gPalSet() uses
     the members of this structure to define the current color palette.

 Returns

     SUCCESS if successful; otherwise, an error code.

 Description

     This function is used to set an entire palette.  To use it, you must
     first set up an array of LLG_RGB structures--one for each color in the
     palette.  The palette can consist of 16, 256, 32 K, 64 K, or 16 M
     colors, depending on the video mode specified using _gModeSet().

     Then, you define an LLG_PALETTE structure that points to the LLG_RGB
     structure array and defines a few additional palette parameters, and
     pass a pointer to this structure to _gPalSet().

     Note:  To retrieve information about an existing palette, call
     _gPalGet().

 Files   Library is LLIBG.LIB, header file is Llibg.api.