ADJUSTPOSITION

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

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.