Name

---

  MGH_PICTURE_GET_VIEWS

Purpose

---

  This function returns a list of views contained in a
  picture. "Picture" is my name for an IDL drawable object, ie an
  IDLgrView, IDLgrScene or IDLgrViewgroup.

Category

---

  Object graphics

Calling Sequence

---

  Result = MGH_PICTURE_GET_VIEWS(picture, N_VIEWS=n_views)

Positional Parameters

---

  picture (input, scalar object reference)
    A picture whose properties are to be queried

Keyword Parameters

---

  N_VIEWS (output, scalar integer)
    Number of views contained in the picture.

Return Value

---

  The function returns a 1-D array of object references to all the
  views contained in the picture. If no views are found the function
  returns -1.
###########################################################################
  This software is provided subject to the following conditions:
  1. NIWA makes no representations or warranties regarding the
    accuracy of the software, the use to which the software may
    be put or the results to be obtained from the use of the
    software. Accordingly NIWA accepts no liability for any loss
    or damage (whether direct of indirect) incurred by any person
    through the use of or reliance on the software.
  2. NIWA is to be acknowledged as the original author of the
    software where the software is used or presented in any form.
###########################################################################

Modification History

---

  Mark Hadfield, 2002-06:
      Written.