spatstat (version 1.44-0)

run.simplepanel: Run Point-and-Click Interface

Description

Execute various operations in a simple point-and-click user interface.

Usage

run.simplepanel(P, popup=TRUE, verbose = FALSE)
clear.simplepanel(P)
redraw.simplepanel(P, verbose = FALSE)

Arguments

P
An interaction panel (object of class "simplepanel", created by simplepanel or grow.simplepanel).
popup
Logical. If popup=TRUE (the default), the panel will be displayed in a new popup window. If popup=FALSE, the panel will be displayed on the current graphics window if it already exists, and on a new window otherwi
verbose
Logical. If TRUE, debugging information will be printed.

Value

  • The return value of run.simplepanel(P) is the value returned by the exit function of P. See simplepanel.

    The functions clear.simplepanel and redraw.simplepanel return NULL.

Details

These commands enable the user to run a simple, robust, point-and-click interface to any Rcode. The interface is implemented using only the basic graphics package in R.

The argument P is an object of class "simplepanel", created by simplepanel or grow.simplepanel, which specifies the graphics to be displayed and the actions to be performed when the user interacts with the panel.

The command run.simplepanel(P) activates the panel: the display is initialised and the graphics system waits for the user to click the panel. While the panel is active, the user can only interact with the panel; the Rcommand line interface and the RGUI cannot be used. When the panel terminates (typically because the user clicked a button labelled Exit), control returns to the Rcommand line interface and the RGUI.

The command clear.simplepanel(P) clears all the display elements in the panel, resulting in a blank display except for the title of the panel.

The command redraw.simplepanel(P) redraws all the buttons of the panel, according to the redraw functions contained in the panel.

If popup=TRUE (the default), run.simplepanel begins by calling dev.new so that a new popup window is created; this window is closed using dev.off when run.simplepanel terminates. If popup=FALSE, the panel will be displayed on the current graphics window if it already exists, and on a new window otherwise; this window is not closed when run.simplepanel terminates.

For more sophisticated control of the graphics focus (for example, to use the panel to control the display on another window), initialise the graphics devices yourself using dev.new or similar commands; save these devices in the shared environment env of the panel P; and write the click/redraw functions of P in such a way that they access these devices using dev.set. Then use run.simplepanel with popup=FALSE.

See Also

simplepanel

Examples

Run this code
if(interactive()) {
    example(simplepanel)
    run.simplepanel(P)
  }

Run the code above in your browser using DataCamp Workspace