Name

---

      IMG_SUBAREA

Purpose

---

      Returns a subarea from an array or color image.

Category

---

Calling Sequence

---

      sub = img_subarea(img, ix, iy, dx, dy).

Inputs

---

      img = Input image. in
      ix,iy = Starting x and y pixel for subimage. in
      dx,dy = Size of subimage to extract. in

Keyword Parameters

---

Keywords

---

        TRUE=tr Returned interleave dimension (0 means 2-D image).
        NX=nx, NY=ny Returned input image dimensions.
        MISSING=miss Value to use for parts of the subarea
          that fall outside the image (default = 0).
          If MISSING=miss is used then it should have the same
          data type as the input image to avoid a type change.
        ERROR=err error flag: 0=ok, 1=not 2-D or 3-D.

Outputs

---

      sub = Returned subimage. out

Common Blocks

---

Notes

---

      Note: Can deal with 2-D or 3-D image arrays.
        Returns a subimage of size dx by dy. Deals
        with areas that extend outside the input image.

Modification History

---

      R. Sterner, 2007 Mar 01.
  Copyright (C) 2007, 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.