view_single_frame

Synopsis

Sets the window display to single frame mode.

view_single_frame([id])

Description

• id - an optional ChipsId structure containing values to modify the currency state for the command.

The view_single_frame command sets the display of the specified window to single frame mode. This is a viewing command, and does not affect the original size or location of the frames.

Frames can be of any size up to and including the size of the window that contains them. When one or more frames are created in a window, and one or more are smaller than the window, they are shown "placed" in the locations specified by the user. The user can cause each frame to be viewed in the entire window using the view_single_frame command. Each frame will now fill the entire window when viewed.

While in this mode, frames can be cycled through using the next_frame and prev_frame commands.

The view_placed_frame command ("ahelp view_placed_frame") can be used to view the frame in the original size and position.

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> next_frame()
chips> next_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 command is 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> view_single_frame(id)

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

See Also

frames

add_frame, arrange_frames, blink_frames, current_frame, delete_frame, display_frame, get_frame, hide_frame, move_frame, next_frame, reposition_frame, set_frame, tile, view_placed_frame

utilities

erase, get_object_count