# coyote: FSC_PLOTWINDOW

- coyote/General Programming
- [Source code]

NAME

      FSC_PLOTWINDOW

PURPOSE

      The purpose of this compound widget is to create a resizeable
      "plot window" inside a larger "page window". I'm not sure it
      has any value except as a utility routine for the PostScript
      configuration object FSC_PSCONFIG__DEFINE, but it's a neat
      program anyway. :-)

AUTHOR

      FANNING SOFTWARE CONSULTING
      David Fanning, Ph.D.
      1645 Sheely Drive
      Fort Collins, CO 80526 USA
      Phone: 970-221-0438
      E-mail: david@idlcoyote.com
      Coyote's Guide to IDL Programming: http://www.idlcoyote.com/

CATEGORY

      Utility routine for FSC_PSCONFIG__DEFINE.

CALLING SEQUENCE

      plotwindowObject = CW_PlotWindow(parent)

REQUIRED INPUT PARAMETERS

      parent - The parent base widget of this compound widget.

RETURN VALUE

      plotwindowObject - The object reference of the compound widget.

KEYWORDS

      COLOR - If set, display the window in "color". This is the default on 24-bit devices.
      DEBUG - Set this keyword to turn traceback error handling on in the error handling code.
      EVENT_PRO - The event procedure for the widget. Required for events to be generated. Otherwise, all events are handled internally.
      LANDSCAPE - If set, display the page in landscape mode. Otherwise the page is display in portrait mode.
      PAGESIZE - The "pagesize" of the widget. Possible values are: "LETTER", "LEDGER", "LEGAL", "A4", and "DISPLAY".
      UNITS - A string indicating INCHES or CENTIMETER units. DEVICE units represented by a null string, "".
      UVALUE - A user value for the caller of this program.
      WINDOWCOLOR - A three-element array specifying the background window color (RGB).
      WINDOWSIZE - The size of the "window" on the page. A four-element array of normalized coordinates in the form [x0, y0, x1, y1].

EVENT STRUCTURE

      The event structure that is returned from this compound widget is defined like this,
      where the sizes and offsets locate the target "window" on the page in normalized units:
         event = {ID:0L, TOP:0L, HANDLER:0L, XSize:0.0, YSize:0.0, XOffset:0.0, YOffset:0.0}

MODIFICATIONS

      Written by David Fanning, 31 January 2000.
      Fixed a small bug that prevented it working on Macintosh computers. 26 Sept 2000. DWF.
      Added a "DISPLAY" page size, so the program can be used to position
         plots and other graphics in a display window. The "page area" will
         have the same aspect ratio is the current graphics window. 17 March 2001. DWF.
      Changed some of the tolerances for "closeness" from 0.1 to 0.025 to allow smaller
         sizing for colorbars and other small objects. 6 July 2005. DWF.