next_frame

Context: frames

Synopsis

Cycles forward and backward through the frames in a window.

Syntax

next_frame([id])
prev_frame([id]);

Description

id - ChipsId structure containing the value of one of the frames or of the window which contains the frames.

The next_frame and prev_frame commands cycle forward and backward through the frames in a window. These commands only work when the display mode is set to "single"; see "ahelp view_single_frame".

The frames are displayed in the order they were created by default. The order of frames can be changed by the arrange_frames command ("ahelp arrange_frames") .

Example 1

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> add_frame(.1, .5, .5, .9)
chips> add_curve([.5,2,4,6],[1,4,4,2.5], "line.color=blue")
chips> view_single_frame()
chips> next_frame()
chips> next_frame()
chips> prev_frame()
chips> prev_frame()
chips> view_placed_frame()

Create a window containg three frames with a curve in each of them. The frame mode is set to single frame for the current window; the last frame created is displayed in the window. The next_frame and prev_frame commands are used to cycle through the frames. Finally, the frame mode is set to "placed", showing the frames in their original locations.

Example 2

chips> id = ChipsId()
chips> id.window="win2"
chips> next_frame(id)

A ChipsId object may be used to set the display mode of a window other than the current one. In this example, the next frame of "win2" is displayed.