setallpalette

raw OCR

Changes all palette colors as specified.

Defined in header <graphics.h>

Syntax

#include <graphics.h>
void far setallpalette(struct palettetype far*palette);

Portability

DOS	UNIX	Windows	ANSI C	C++ only
■

Remarks

setallpalette sets the current palette to the values given in the palettetype structure pointed to by palette.

You can partially (or completely) change the colors in the EGA/VGA palette with setallpalette.

The MAXCOLORS	constant and the palettetype structure used by

setallpalette are defined in graphics.h as follows:

#define MAXCOLORS 15

struct palettetype { unsigned char size;

signed char colors[MAXCOLORS-+ 1];

size gives the number of colors in the palette for the current graphics driver in the current mode.

colors is an array of size bytes containing the actual raw color numbers for each entry in the palette. If an element of colors is -1, the palette color for that entry is not changed.

The elements in the colors array used by setallpalette can be represented by symbolic constants defined in graphics.h.

Table 2.6

CGA	EGA/VGA

Actual color table

Name	Value	Name	Value

BLACK	0	EGA BLACK	0
BLUE	1	EGA BLUE	1
GREEN	2	EGA GREEN	2
CYAN	3	EGA CYAN	3
RED	4	EGA RED	4
MAGENTA	5	EGA MAGENTA	5
BROWN	6	EGA LIGHTGRAY	7
LIGHTGRAY	7	EGA BROWN	20
DARKGRAY	8	EGA DARKGRAY	56
LIGHTBLUE	9	EGA LIGHTBLUE	57
LIGHTGREEN	10	EGA LIGHTGREEN	58
LIGHTCYAN	11	EGA LIGHTCYAN	59
LIGHTRED	12	EGA LIGHTRED	60
LIGHTMAGENTA	13	EGA LIGHTMAGENTA	61
YELLOW	14	EGA YELLOW	62
WHITE	15	EGA WHITE	63

Note that valid colors depend on the current graphics driver and current graphics mode.

Changes made to the palette are seen immediately onscreen. Each time a palette color is changed, all occurrences of that color onscreen will change to the new color value.

setallpalette cannot be used with the IBM-8514 driver.

Return value

If invalid input is passed to setallpalette, graphresult returns -11 (grError), and the current palette remains unchanged.

Example

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>
#include <conio.h>

int main(void)
{ ■
   /* request autodetection */
   int gdriver = DETECT, gmode, errorcode;
   struct palettetype pal;
   int color, maxcolor, ht;
   int y = 10;
   char msg[80];

   /* initialize graphics and local variables  */
   initgraph(&gdriver, &gmode,  "");

   /* read result of initialization */
   errorcode = graphresult ();
   if (errorcode != grOk)    /* an error occurred  */
   {
      printf("Graphics error: %s\n", grapherrormsg (errorcode));
      printf("Press any key to halt:");
      getchO ;
      exit(l);               /* terminate with  an error code */
   }
   maxcolor = getmaxcolor ();
   ht = 2 * textheight("W");
   /* grab a copy of the palette */
   getpalette(&pal);
   /* display the default palette colors  */
   for (color=l; 'color<=maxcolor; color++) {
      setcolor(color);
      sprintf(msg, "Color: %d", color);
      outtextxy(l, y, msg);
      y += ht;
   }
   /* wait for a key */
   getchO ;

   /* black out the colors one by one  */
   for (color=l; color<=maxcolor; color++)  {
      setpalette(color, BLACK);
      getchO ;
   }
   /* restore the palette colors */
   setallpalette(&pal);

   /* clean up */
   getchO ;
   closegraphO ;
return

Differences from modern implementations

Nothing recorded yet.

Modern references

Microsoft C runtime (search)

These are search links, not yet checked by hand.

Stable link: /3.1/graphics.h/setallpalette/ · short form /3.1/setallpalette/