Name

---

      IMG_STRETCH

Purpose

---

      Stretch a 2-D or 3-D image array.

Category

---

Calling Sequence

---

      out = img_stretch(in,lo,hi)

Inputs

---

      in = Input image. in
      lo = low cutoff (def=0). in
      hi = high cutoff (def=255). in

Keyword Parameters

---

Keywords

---

        OUTLO=lo2 lo maps to lo2 (default=0).
        OUTHI=hi2 hi maps to hi2 (default=255).
        /NOCLIP means do not clip output to lo2, hi2.
        ERROR=err error flag: 0=ok, 1=not 2-D or 3-D,
          2=wrong number of color channels for 3-D array.

Outputs

---

      out = Stretched image. out

Common Blocks

---

Notes

---

      Notes: Remaps image values lo and hi to lo2 and hi2.
        Returned image is same type is input image.

Modification History

---

      R. Sterner, 2001 Jan 08
      R. Sterner, 2001 Sep 20 --- Fixed a bug for the no-op case.
      R. Sterner, 2010 May 12 --- Converted arrays from () to [].
  Copyright (C) 2001, 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.