default-pixmap-color-vector

Arguments: nil

Returns the default-pixmap-color-vector. This is a color vector shared by the texture-infos of many Allegro pixmaps for efficiency. It contains the following sixteen colors:

0 black
1 dark-red
2 dark-green
3 dark-yellow
4 dark-blue
5 dark-magenta
6 dark-cyan
7 light-gray
8 gray
9 red
10 green
11 yellow
12 blue
13 magenta
14 cyan
15 white

An application pixmap that uses these 16 colors in this order could use this color vector in the colors slot of the texture-info used with the pixmap in order to reduce the total number of color vectors needed by the application. Pixmap-creating programs such as the Paint applet may create pixmaps that use this color order or a similar one that could be edited to this one.

An additional advantage of using default-pixmap-color-vector is that Allegro automatically changes the vector's gray entry to the system-edge-shadow-color, the light-gray entry to the system-dialog-background-color, and the white entry to the system-background-color. This means that button pixmaps using this color vector will automatically appear in the custom colors that the end user has set up in the Windows Control Panel.

default-pixmap-color-vector is a property of the system class.

In releases prior to 7.0, this function was named default-palette-vector and took one argument, which was in fact ignored. New code should use this function called without arguments.

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.