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.

o 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".

o 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.

o An HTML colour code such as #ff002d. The leading # character can be replaced if required by an "@" character.

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:

• The effects of this command will only be immediately apparent when run on X windows which have 256 colours (or other similar pseudocolour devices). On other devices (for instance, X windows with more than 256 colours) the effects will only become apparent when subsequent graphics applications are run.

Related Applications

KAPPA: PALDEF, PALREAD, PALSAVE.