Name

---

      TOPCOLORS

Purpose

---

      Reserve and define some colors at top of color table.

Category

---

Calling Sequence

---

      topcolors

Inputs

---

Keyword Parameters

---

Keywords

---

        TOP=top Returned top available image color.
        PUT_HUE=s Specified starting index for reserved colors.
          By default reserved colors start at top+1.
        /REMAP Means remap current color table to new range.
        HUE=hue Returned index table of hues. The pure colors are:
          color=hue(0) gives white.
          color=hue(1) gives red.
          color=hue(2) gives yellow.
          color=hue(3) gives green.
          color=hue(4) gives cyan.
          color=hue(5) gives blue.
          color=hue(6) gives magenta.
          Hue-1: darker, Hue-2: darkest, Hue+1: pale, Hue+2: palest

Outputs

---

Common Blocks

---

Notes

---

      Notes: Example use:
        Load desired color table: loadct, 4
        Remap and reserve colors: topcolors,top=top,hue=hue,/remap
        Display image using bytscl: tv,bytscl(img,top=top).
        Make a dark blue background: erase, hue(5)-2
        Make a pale red plot: plot,x,y,color=hue(1)+1,/noerase

Modification History

---

      R. Sterner, 9 Dec, 1993
      R. Sterner, 1994 Jan 12 --- Added PUT_HUE keyword.
      R. Sterner, 2010 Jun 04 --- Converted arrays from () to [].
  Copyright (C) 1993, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.