This routine saves a section of the colour palette for the currently open graphics device in an HDS container file in the users ADAM directory. The file is called " kappa_palette.sdf" and contains palettes for different devices. Each palette is a _REAL array of shape (3,n) where n is the number of colours in the palette. The first colour (i.e. the first element in the array) is the background colour and is refered to as colour index zero. Therefore the highest colour index in the array is (n-1). Each array has a name which identifies the graphics device to which it refers.

If a palette already exists for the device in the HDS container file, then the values stored in the HDS palette for the range of colour indices specified by CI1 and CI2 are modified to reflect the current colour table, and values in the HDS palette for other colour indices are left unchanged. If no HDS palette already exists, then an entire palette array is created and initally filled with values of

• 1. These indicate that no value has yet been specified for the colour index, and allows the default value to be used. This default may depend on the graphics device. For instance, the default for pen 1 will be white on an Xwindow but black on a printer.

CALL KPG1_PLSAV( CI1, CI2, RESET, STATUS )

CI1 = INTEGER (Given)

CI2 = INTEGER (Given)

RESET = LOGICAL (Given)

STATUS = INTEGER (Given and Returned)

• The HDS container file is created if it does not already exist.

• A graphics device must previously have been opened using SGS/GKS.