# coyote: ADJUSTPOSITION

- coyote/Graphics
- [Source code]

NAME

      AdjustPosition

PURPOSE

      This is a program for interactively adjusting the plot position
      coordinates. The result of the function is a four-element floating
      point array of normalized coordinates, suitable for passing to the
      POSITION keyword of most IDL graphics commands.

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

      Graphics

CALLING SEQUENCE

      position = AdjustPosition(startingPosition)

OPTIONAL INPUTS

      startingPosition - A four-element array of normalized coordinates
           of the form [x0, y0, x1, y1].

OUTPUTS

      position - The adjusted plot position. A four-element array of normalized coordinates.

INPUT KEYWORDS

      GROUP_LEADER - The group leader of this program. This keyword
           is required to ensure modal operation when calling from
           another widget program.
      TITLE - The title of the window. "Adjust Plot Position in Window..." by default.
      XOFFSET - The X offset of the program on the display. Calculated from the
           upper left-hand corner of the display.
      YOFFSET - The Y offset of the program on the display. Calculated from the
           upper left-hand corner of the display.

OUTPUT KEYWORDS

      CANCEL - Returns a 1 if the user selects the Cancel button. Returns 0 otherwise.
           Note that if the use cancels, the "position" parameter is set to the value of
           the "startingPosition" parameter.

DEPENDENCIES

      Reqires FSC_FIELD and FSC_PLOTWINDOW from the Coyote Library:
                    http://www.idlcoyote.com/programs/fsc_field.pro
                    http://www.idlcoyote.com/programs/fsc_plotwindow.pro

MODIFICATION HISTORY

      Written by David Fanning, March 2001.