fx_SetPal()

Gets/sets the palette to display when "fixed" mode is enabled.

Syntax:
     fx_SetPal( [<nPalette>] )   ->   nPalette

Arguments:
     <nPalette> is an integer value in the range 0 to 15 representing
     the palette number to get/set.

Returns:
     Returns the integer number of the current palette displayed.

Description:
     fx_SetPal() allows switching between palettes when "fixed" palette
     mode is enabled.  If an undefined palette is specified or an error
     occurs, no switching will occur.

Example:
     // Save the current displayed palette and switch
     // to palette 5.  When a key is pressed, return
     // to the original palette.
     nSavePal := fx_SetPal( 5 )
     INKEY( 0 )
     fx_SetPal( nSavePal )

SeeAlso: fx_FixPal()