>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  CROSSI

CROSSI

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.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us