Events

Version 1.9 Build 1556

News	FAQ
Search	Home

Next: viewerdisplaypanel - Constructor Up: viewerdisplaypanel - Tool Previous: Graphical User Interface

Events

The Viewerdisplaypanel tool emits several events. A few of them can be of interest for the programmer.

pseudoregion The pseudoregion event is emitted after double-clicking a region tool. The record this event holds contains unfromatted information about the region. Use region instead.
pseudoposition The pseudoposition event is emitted after double-clicking a positioning tool. The record this event holds contains unfromatted information about the positon. Use position instead.
motion The motion event returns a record containing (screen)pixel and world coordinate (and units) of the position the cursor is moved. It is for internal use only.
region Note: This event only occurs when Viewerdisplaydata tools are registered.
An event called region is emitted when you interactively create a region with the cursor. This event is always emitted, unless region accumulation mode is active (see above). When you terminate accumulation mode, the region event is then emitted.
The region event $value record is shown diagramatically below.
```
\$value
  region                 # The region tool
  type                   # The region type (box, polygon etc)
```

position Note : This event only occurs when Viewerdisplaydata tools are registered.

An event called position is emitted when you interactively created a position with the cursor (see above).

The $value of the event is a record with the fields position and profile.

The position event record is shown diagramatically below.

\$value
  position               # Location of cursor
    pixel                #   Absolute integer pixel coordinate
    world                #   Absolute world coordinate
      numeric            #     as a numeric vector
      quantity           #     as vector of quantities
      string             #     as a formatted string
      measure            #     as measures (further subfields not shown)
    intensity            #   Intensity of image
      mask               #     mask value
      value              #     value of image (quanity)
      pixel              #     absolute integer pixel location
  profile                # The z-profile (if > 2D image)
    x                    #   abcissa
      pixel              #     pixel coordinate
        abs              #       absolute
        rel              #       relative
      nativeworld        #     world coordinate in native units
        abs              #       absolute
        rel              #       relative
      name               #     name of abcissa axis
      nativeunit         #     native abcissa unit
      currentworld       #     world coordinate as currently plotted (if plotted
)
      currentunit        #     abcissa unit as currently plotted 
      currentveltype     #     velocity type as currently plotted
      currentabs         #     absolute or relative as currently plotted
      isSpectral         #     is the abcissa a spectral coordinate
    y                    #   ordinate
      unit               #     unit of ordinate
      data               #     ordinate values

polyline This event is generated by the polyline tool, when the user double-clicks, or drags and drops an existing polyline or its points.
statistics Note: This event only occurs when Viewerdisplaydata tools are registered.
If the statistics rollup is rolled down, then statistics are written to the listboxes (Plane, Full button press or region event emitted) then a statistics event is generated.
The statistics event record is shown diagramatically below. The stats subfield is a record with the same format as that generated by the return record of function Image.statistics.
```
\$value
  region           # The region from which the statistics were evaluated
  stats            # The statistics record 
    npts           
    sum            
    sumsq
    min
    max
    mean
    sigma
    rms
    blc
    blcf
    trc
    trcf
    minpos
    minposf
    maxpos
    maxposf
```

Next: viewerdisplaypanel - Constructor Up: viewerdisplaypanel - Tool Previous: Graphical User Interface Contents Index