Name

---

  MGH_PRINT_PICTURE

Purpose

---

  This prints a picture (an IDL drawable object, ie an IDLgrView,
  IDLgrScene or IDLgrViewgroup) to a printer

Category

---

  Object graphics

Calling Sequence

---

  result = MGH_PRINT_PICTURE, Picture, PRINTER=printer

Positional Parameters

---

  Picture (input, object reference)
    Picture to be printed

Keyword Parameters

---

  BACKGROUND_COLOUR (input, colour index or RGB vector)
    Bakground colour.
  BANNER (input, switch)
    Set this keyword to print a descriptive banner at the bottom of
    the page.
  PRINTER (input, object reference)
    This keyword can be used to specify the printer object. This
    allows the caller to keep its own printer, so that changes to
    the setup can be saved between calls. If no value is specified
    then the routine creates a printer object and destroys it after
    printing is complete.
  VECTOR (input, switch)
    This keyword is passed to the printer's Draw method.
###########################################################################
  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, 1999-08:
    Written, based on code previously in MGH_Window::Print.
  Mark Hadfield, 1999-09:
    Added VECTOR keyword to allow vector output under IDL 5.3.
  Mark Hadfield, 2000-08:
    Removed call to one of my old MGHDT routines for the date-time
    string in the banner.
  Mark Hadfield, 2001-07:
    Made this routine compatible with the new MGH_PRINTER function,
    which provides a session-wide default printer.
  Mark Hadfield, 2004-06:
    Minor changes to code generating banner text.