CROSSI Name
CROSSI Purpose
Interactive cross-hair cursor on screen or plot.
Category
Calling Sequence
crossi, [x, y, z] Inputs
Keyword Parameters
Keywords
/DATA Causes data coordinates to be used (default).
/DEVICE Causes window device coordinates to be used.
/NORMAL Causes normalized coordinates to be used.
/ORDER Reverse device y coordinate (0 at window top).
/PIXEL Show pixel value: R G B.
/HSV Use with /PIXEL to list pixel value as H S V.
ARRAY=arr Give a data array same size and shape as image.
If given array values will be listed in display widget.
IZOOM=iz Display data values. iz is a structure:
iz = {x:x, y:y, z:z} where x and y are arrays of
x and y coordinates, and z is the data array. The
sizes of x, y, and z must match. Very similar to izoom.
COLOR=c Set color of line (ignored for /XOR).
Use -2 for dotted line.
LINESTYLE=s Line style.
MAG=m Magnification for an optional magnified window.
Setting MAG turns window on. /MAG gives magnification 10.
SIZE=sz Mag window approx. size in pixels (def=200).
XFORMAT=xfn These keywords are given names of functions
YFORMAT=yfn that accept the numeric value of x or y
and return a corresponding string which is displayed
in place of the actual value. For example, Julian
days could be displayed as a date with jd2date.
XSIZE=xs, YSIZE=ys Coordinate display widths.
/JS Means X axis is time in Julian seconds. Example:
x=maken(-2e8,-1.9e8,200) & y=maken(20,30,200)
z=bytscl(makez(200,200))
izoom,x,y,z,/js
crossi,/js
/NOSTATUS Inhibits status display widget.
SETSTAT=st May use the same status display widget on
each call to crossi (stays in same position).
On first call: the status widget structure is returned.
Following calls: send st. Must use with /KEEP.
To delete status display widget after last box1 call:
widget_control,st.top,/dest (or drop /KEEP)
/KEEP Do not delete status widget or mag window on exit.
/XMODE Means use XOR plot mode instead of tvrd mode.
XYPRO=xypro Name of optional procedure that accepts the
X,Y values and does something (like translate a position
into a name). Must do any display itself. May design
to be initialized before calling crossi.
INSTRUCTIONS=t String array with exit instructions.
Default: Press any button to exit.
/DIALOG Means give an exit dialog box.
MENU=m A string array with exit dialog box options.
An option labeled Continue is always added. Def=Continue.
DEFAULT=def Set exit menu default.
EXITCODE=x Returns exit code. Always 0 unless a dialog
box is requested, then is selected exit option number.
BUTTON=b Returned button code: 1=left, 2=middle, 4=right.
Outputs
x = X coordinate of line. in, out
y = Y coordinate of line. in, out
z = optionally returned pixel value. out
Only if /PIXEL is specified.
Common Blocks
js_com
Notes
Note: data coordinates are default.
X and Y may be set to starting position in entry.
Modification History
R. Sterner, 1994 May 16
R. Sterner, 1994 May 19 --- Added mag window.
R. Sterner, 1995 May 12 --- Added exit menu default.
R. Sterner, 1995 Jun 30 --- Added /ORDER.
R. Sterner, 1995 Oct 17 --- Added /PIXEL and RGB display.
R. Sterner, 1995 Nov 30 --- Added color=-2 option.
R. Sterner, 1998 Jan 15 --- Dropped the use of !d.n_colors.
R. Sterner, 1999 Oct 05 --- Upgraded for true color.
R. Sterner, 1999 Dec 07 --- Fixed /PIXEL for 24-bit color & mag bug.
R. Sterner, 2001 Jan 12 --- Fixed for maps.
R. Sterner, 2002 Sep 05 --- Added data array option.
R. Sterner, 2003 May 16 --- Added izoom option.
R. Sterner, 2003 Oct 09 --- Fixed startup non-erased line (rounded).
R. Sterner, 2003 Oct 09 --- Added XYPRO.
R. Sterner, 2004 Jan 13 --- Added /HSV.
R. Sterner, 2004 May 17 --- Fixed XOR mode for mag window.
R. Sterner, 2008 Jan 14 --- Fixed XOR mode for XYPRO.
R. Sterner, 2008 Mar 17 --- Added last to common.
R. Sterner, 2010 May 04 --- Converted arrays from () to [].
Copyright (C) 1994, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.