PALENTRY

Enters a colour into an graphics device’s palette

Description:

This application obtains a colour and enters it into the palette  portion of the current graphics device’s  colour table. The palette comprises up to 16 colours and is intended to provide coloured annotations, borders, axes, graphs etc. that are unaffected by changes to the lookup table  used for images.

A colour is specified either by the giving the red, green, blue intensities; or named colours.

Usage:

palentry palnum colour [device]

Parameters:

COLOUR() = LITERAL (Read)
A colour to be added to the palette at the entry given by Parameter PALNUM. It is one of the following options.
  • A named colour from the standard colour set, which may be abbreviated. If the abbreviated name is ambiguous the first match (in alphabetical order) is selected. The case of the name is ignored. Some examples are "Pink", "Yellow", "Aquamarine", and "Orchid".

  • Normalised red, green, and blue intensities separated by commas or spaces. Each value must lie in the range 0.0–1.0. For example, "1.0,1.0,0.5" would give a pale yellow.

  • An HTML colour code such as #ff002d.

DEVICE = DEVICE (Read)
Name of the graphics device to be used. [Current graphics device]
PALNUM = _INTEGER (Read)
The number of the palette entry whose colour is to be modified. PALNUM must lie in the range zero to the minimum of 15 or the number of colour indices minus one. The suggested default is 1.

Examples:

palentry 5 gold
This makes palette entry number 5 have the colour gold in the reserved portion of the colour table of the current image display.
palentry 12 [1.0,1.0,0.3] xwindows
This makes the xwindows device’s palette entry number 12 have a pale-yellow colour.

Notes:

Related Applications

KAPPA: PALDEF, PALREAD, PALSAVE.