Directives
VIDEO_PALETTE Control Video Colours
   
Formats 1. Read Palette: VIDEO_PALETTE READ var$[,ERR=stmtref]
 
2. Change Palette: VIDEO_PALETTE string$[,ERR=stmtref]
 
3. Read Palette Indexed Table: VIDEO_PALETTE INDEXED READ var$[,ERR=stmtref]
 
4. Change Palette Indexed Table: VIDEO_PALETTE INDEXED string$[,ERR=stmtref]
 
Where
string$ String expression containing the new VIDEO_PALETTE or INDEXED table settings to be used.
stmtref Program line number or statement label to which to transfer control.
var$ String variable to receive the current VIDEO_PALETTE or INDEXED table settings.
   
Description ProvideX supplies a 16-colour video palette with direct access to the standard 16
colours provided by Windows. Use the VIDEO_PALETTE directive to modify the
16-colour video palette in ProvideX.
   
Format 1 Read Palette

VIDEO_PALETTE READ var$[,ERR=stmtref]

Use this format to read the current settings of the video palette. The video palette consists of a string of 16 3-byte entries, where each byte defines the intensity of the colours Red, Green and Blue. For example, the 3-byte entry for bright (foreground) green is $00FF00$, magenta is $FF00FF$ ...

VIDEO_PALETTE READ X$ will return you the following defaults in a single string:

$000000 FF0000 00FF00 FFFF00$
$0000FF FF00FF 00FFFF FFFFFF$
$808080 800000 008000 808000$
$000080 800080 008080 C0C0C0$

The string is only punctuated by spaces to show you the sixteen 3-byte entries.

   
Format 2 Change Palette

VIDEO_PALETTE string$[,ERR=stmtref]

Use this format to change/reset the video palette, as in VIDEO_PALETTE X$ where X$ contains your new values.

*Note* Changing the palette may not work on all systems. This depends on the colour capabilities of the PC hardware.
   
Format 3 Read Palette Indexed Table

VIDEO_PALETTE INDEXED READ var$[,ERR=stmtref]

There is also an indexed table to reference the video palette. This index table consists of 48 entries: six 8-byte tables, where each byte represents an index into the video palette described above:

  • The first 8 bytes represent the standard foreground colours.
  • The second 8 bytes represent the colours used when the 'SB' mnemonic is in effect
  • The third 8 bytes represent the colours used when the 'BB' mnemonic is in effect
  • The fourth 8 bytes represent the colours used when both 'BB' and 'SB' are in effect
  • The fifth 8 bytes represent the "Background" colours
  • The sixth 8 bytes represent the colours used when 'BR' and 'SB' are in effect Use the READ format to return the current settings in the index table, as in VIDEO_PALLETTE READ INDEXED X$. For more information, refer to the 'BB' Mnemonic, the 'BR' Mnemonic, and the 'SB' Mnemonic.
   
Format 4 Change Palette Indexed Table

VIDEO_PALETTE INDEXED string$[,ERR=stmtref]

Use this format to change/reset the video palette index table, as in VIDEO_PALLETTE INDEXED X$ where X$ contains your new values.