WgStripTool Procedure

Creates a window that displays data in a style that simulates a real-time, moving strip chart.

Figure 2-163 The WgStripTool window lets you interactively view data in moving strip charts; up to ten strip charts can be simultaneously displayed by the WgStripTool window. You can adjust the display width in the strip charts to create the effect of zooming in and out. You can also adjust the rate and the manner with which the strip charts progress through the data.

Figure 2-164 The WgStripTool window lets you interactively view data in moving strip charts; up to ten strip charts can be simultaneously displayed by the WgStripTool window. You can adjust the display width in the strip charts to create the effect of zooming in and out. You can also adjust the rate and the manner with which the strip charts progress through the data.

Event Handling

You can use the WgStripTool widget in one of the following two ways:

From the WAVE prompt Enter the procedure name at the WAVE prompt to display the WgStripTool widget. The WgStripTool widget handles its own event loop by calling WwLoop.
Stand-alone widget in its own window created by another application The WgStripTool widget has its own Main window, but the application (not the WgStripTool widget) handles the event loop by calling WwLoop.

The output parameter shell can be returned only if you also supply the input parameter parent.

Contents of the Window

The StripTool window has two main parts

the display area and the control area.

StripTool Display Area

The display area is the largest area of the window; it is where the data strip charts are displayed. The number of strip charts you see in this area is determined by the number of y variables that were included in the call that invoked the WgStripTool window.

StripTool Control Area

Use the following controls to operate the WgStripTool window:

Reverse button Cycle through the data in a reverse direction.
Stop button Freeze strip chart display at current location.
Forward button Cycle through the data in a forward direction.
Mode Select Auto Stop to have WgStripTool stop whenever it reaches the beginning or the end of the data in the y variable(s). Select Continuous to have WgStripTool move through the data in a non-stop manner, pausing only when you click the Stop button. Select Step to have the strip chart proceed only when you click on one of the arrow buttons.
Timer Delay Decrease or increase the rate of display. The number shown to the right of the slider is the number of milliseconds delay between contiguous frames of the strip chart.
X Step Size The amount by which the strip charts are moved forward or back when the strip charts are updated.
X Display Width The range of data displayed in the horizontal direction. A small value for display width has the effect of "zooming in" to view a narrow range of data; a large value for display width has the effect of "zooming out" to view a broader range of data.
X Range A more precise way to specify X Display Width. Click this button to display another dialog box containing text fields where you can type precise values for the minimum and maximum values you wish to have displayed along the x-axis.

This other dialog box is shown in

Figure 2-165

Dismiss Destroy the WgStripTool window and erase it from the screen.

The selections you make in the control area affect all displayed strip charts. This way, you can be assured that the data in one strip chart is in "sync" with the data in any other strip chart.

Figure 2-165 Use this dialog box to precisely control the range of the x-axis in the WgStripTool window. This dialog box is displayed if you click the X Range button in the WgStripTool control area.

Figure 2-166 Use this dialog box to precisely control the range of the x-axis in the WgStripTool window. This dialog box is displayed if you click the X Range button in the WgStripTool control area.

Example

Enter the commands shown below into a file, and compile the procedure with the .RUN command. If the variable parent is defined, WgStripTool is created as a child of parent; otherwise, WgStripTool runs on its own (i.e., in its own event loop).

When you are finished interacting with the WgStripTool window, close it by clicking on the Dismiss button.

PRO Sample_wgstriptool, parent, tool_shell
x = indgen(500)
y1 = sin(x)
y2 = cos(x)
y3 = tan(x)

; Create an independent variable and three dependent variables
; describing sinusoidal curves to use as data for WgStripTool.

IF N_ELEMENTS(parent) NE 0 THEN BEGIN
WgStripTool, x, y1, y2, y3, $
    0, 0, 0, 0, 0, 0, 0, parent, tool_shell

; Create WgStripTool as a child of the widget known as "parent".
; The window of the newly created widget is returned via the
; optional output parameter "tool_shell".

ENDIF ELSE BEGIN
WgStripTool, x, y1, y2, y3

; Create WgStripTool and display it as its own Main window. In other
; words, the WgStripTool window runs on its own (i.e., in its own event
; loop). Notice how the zeroes are not needed as placeholders, since
; the optional parameters "parent" and "tool_shell" are not being used
; in this procedure call.

ENDELSE
END

WgStripTool Procedure

Usage

Input Parameters

Output Parameters

Keywords

Color/Font Keywords

Discussion

Event Handling

Contents of the Window

StripTool Display Area

StripTool Control Area

Example

See Also