Name

---

    FILL_REGION

Purpose

---

    This function will use morphological operations to
    fill the interior region of a provided boundary
    image.

Category

---

    Image Processing.

Calling Sequence

---

    Result = $
      FILL_REGION( boundary, $
                    point, $
                    sizeLimit, $
                    STATUS=status )

Return Value

---

    This function will return an array of byte data type with
    the same dimensions as the provided input image that contains
    a filled boundary region.

Inputs

---

    boundary
      A binary image containing a cluster of pixels for
      which the mean coordinate (centroid) is to be
      computed.
    point
      A 2-element vector defining a point located within the
      provided boundary from which region growth should begin.
    sizeLimit
      The maximum number of pixels that the region should be
        allowed to grow to (to prevent runaways -OR- to limit
        region size).

Keyword Parameters

---

    STATUS=status
      A returned boolean variable indicating if the number of
      pixels in the grown region has exceeded the limit specified.

Side Effects

---

    None

Requires

---

    FILL_REGIN
    FIND_CENTER

Reference

---

    Gonzalez, R.C. and R.E. Woods, Digital Image Processing,
    Third Edition, Prentice Hall, Upper Saddle River, New Jersey,
    2007 (ISBN: 0131687288X / ISBN-13: 978-0131687288)

Modification History

---

    Written by: Carl Salvaggio
    March, 2007 Original code
    June, 2008 Size limit return status added to indicate
                      runaway situations (Philip Salvaggio)