11.6 Loading the color database

You can load new color definitions into the color database.

read-color-db

Function

This reads color definitions from the given file (a filename or pathname). If no file is given, it uses the default color definitions file in the LispWorks library. The returned data structure can be passed to load-color-database . The format of the file is:

#(:RGB 1.0s0 0.980391s0 0.980391s0)     snow

#(:RGB 0.972548s0 0.972548s0 1.0s0)     GhostWhite

etc

Each line contains a color definition which consists of a color-spec and a name. The names are converted to uppercase and interned in the keyword package. Whitespace in names is preserved.

load-color-database

Function

This loads the color database with color definitions contained in data , which should have been obtained via the function read-color-db . The colors thus defined may not be replaced by color aliases.

To clear the color database use the form:

Warning: You should do this before starting Common LispWorks (that is, before env:start-environment is called) and be sure to load new color definitions for all the colors used in the environment when you do start it. Those colors are determined from the config/colors.db file.

You can remove a color database entry with delete-color-translation .