blink_frames

Context: sl.chips

Synopsis

Blink between two frames; stop blink mode.

Syntax

blink_frames(id,"frame_id", [duration]);
stop_blink();

Description

id - ChipsId structure containing the value of one of the frames to be blinked or of the window that contains the two frames.
"frame_id" - the id of one of the frames to be blinked.
duration - optional floating point number indicating the time delay in seconds between blinks; default is 3 s.

The blink_frames command blinks between two frames at a set interval. The stop_blink command ends the blink mode. These commands are part of the advanced ChIPS module; refer to "ahelp chips" for information on loading the module.

The frames must be in the same ChIPS window. One of the frames to be blinked is specified in a Chips_id structure; the second is specified as the second argument to the call. Alternately, the window which contains the two frames to blink may be specified. An optional third argument sets the blink rate in seconds.

Blinking is ended by issuing the stop_blink command.

The window display is set to "single" during the blink period, then returned to "placed" (if applicable) when blinking ends. This means the frames will fill the ChIPS window while they are blinked, regardless of their actual dimensions.

Example 1

chips> add_curve([1,2,4,6],[2,4.4,2.8,3],"line.color=green
symbol.color=yellow");
chips> add_frame();
chips> add_curve([10,20,30,40,50,60,70,80],[23,25,27,25,22,19,18,21],
"line.color=coral");
chips> id = ChipsId();
chips> id.frame="frm1";
chips> blink_frames(id,"frm2");
chips> stop_blink();
chips> blink_frames(id,"frm2", 0.25);

Create a window containg three frames with a curve in each of them. A ChipsId is created with the frame id "frm1". The blink_frames command is called with that structure and the frame_id "frm2", blinking the two frames at the default rate of 3 s. The blinking is stopped, then restarted with a blink rate of 0.25 s.

Example 2

chips> add_frame(.1, .1, .5, .5);
chips> add_curve([1,2,4,6],[2,4.4,2.8,3],"line.color=green
symbol.color=yellow");
chips> add_frame(.5, .5, .9, .9);
chips> add_curve([10,20,30,40,50,60,70,80],[23,25,27,25,22,19,18,21],
"line.color=coral");
chips> id = ChipsId();
chips> id.frame="frm1";
chips> blink_frames(id,"frm2", 0.25);
chips> stop_blink();

Create two frames whose dimensions are smaller than the window and place a curve in each frame. The two frames are blinked with a blink rate of 0.25 s. During the blinking, each frame is enlarged to fill the window. When the blinking is stopped, the display reverts to the original frame display mode.

Example 3

chips> add_curve([1,2,4,6],[2,4.4,2.8,3],"line.color=green
symbol.color=yellow");
chips> add_frame();
chips> add_curve([10,20,30,40,50,60,70,80],[23,25,27,25,22,19,18,21],
"line.color=coral");
chips> add_window();
chips> id = ChipsId();
chips> id.window="win1";
chips> id.frame="frm1";
chips> blink_frames(id,"frm2", 1.0);

In this example, the ChipsId is used to specify both the window and one of the frames which should be used in the blink. The blink_frames command affects frames "frm1" and "frm2" in window "win1"; the blink rate is set at 1 s.