By default, numerical data values are displayed along the long edge of the key. The values corresponding to the maximum and minimum colour index are supplied using Parameters HIGH and LOW. Intermediate colour indices are labelled with values which are linearly interpolated between these two extreme values.
The rectangular area in which the key (plus annotations) is drawn may be specified either using a graphics cursor, or by specifying the co-ordinates of two corners using Parameters LBOUND and UBOUND. Additionally, there is an option to make the key fill the current picture. See Parameter MODE. The key may be constrained to the current picture using Parameter CURPIC.
The appearance of the annotation my be controlled in detail using the STYLE parameter.
The LUT must be two-dimensional, the first dimension being 3, and the second being arbitrary. The method used to compress or expand the colour table if the second dimension is different from the number of unreserved colour indices is controlled by Parameter NN. Also the LUT's values must lie in the range 0.0-1.0. [!]
A comma-separated list of strings should be given in which each string is either an attribute setting, or the name of a text file preceded by an up-arrow character " ". Such text files should contain further comma-separated lists which will be read and interpreted in the same manner. Attribute settings are applied in the order in which they occur within the list, with later settings overriding any earlier settings given for the same attribute.
Each individual attribute setting should be of the form:
name = value
where name is the name of a plotting attribute, and value is the value to assign to the attribute. Default values will be used for any unspecified attributes. All attributes will be defaulted if a null value (!)--the initial default--is supplied. To apply changes of style to only the current invocation, begin these attributes with a plus sign. A mixture of persistent and temporary style changes is achieved by listing all the persistent attributes followed by a plus sign then the list of temporary attributes.
See Plotting Attributes for a description of the available attributes. Any unrecognised attributes are ignored (no error is reported).
Axis 1 is always the data value axis, whether it is displayed horizontally or vertically. So for instance, to set the label for the data value axis, assign a value to Label(1) in the supplied style.
To get a ramp key (the default), specify "form=ramp". To get a histogram key (a coloured histogram of pen indices), specify "form=histogram". To get a graph key (three curves of RGB intensities), specify "form=graph". If a histogram key is produced, the population axis can be either logarithmic or linear. To get a logarithmic population axis, specify "logpop=1". To get a linear population axis, specify "logpop=0" (the default). To annotate the long axis with pen numbers instead of pixel value, specify "pennums=1" (the default, "pennums=0", shows pixel values). [current value]
KAPPA --- Kernel Application Package