.. _palette:

.. index::
   pair: menu item; Custom palette
   pair: command line option; palette
   pair: command; palette

Custom palette
==============

**Syntax**:(palette integer integer integer)

A custom palette lets you re-create some of the random palettes. The first value
specifies the algorithm, which should currently be one of the following:

0

    Default palette

1

    Black to color gradient

2

    Black to color to white gradient

3

    Cubistic-like algorithm.

The seed specifies a random seed for the palette; different seeds generate
different palettes. The last value is the amount by which the palette is shifted.

Note that changing the palette in the truecolor modes forces recalculation of
the whole screen. To avoid this, you can enable the
:ref:`palette emulation filter <palettef>` first.

**Available as**: menu item, command line option, command