move_frame

Synopsis

Moves the frame to a new location.

move_frame( [ChipsId,] xval, yval [,mode] )

Description

• ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
• xval - new x location or the difference to move in x
• yval - new y location or the difference to move in y
• mode - reposition using absolute (0) or delta (1) values

The move_frame command moves the frame to a new position. The new location may be specified as an absolute position (default) or as relative offsets from the original location. The move_frame command cannot specify (xval,yval) that moves the frame outside of the window.

The following coordinate systems may be used to move a frame: PIXEL or WINDOW_NORM. The system is specified by setting the coord_sys field of the optional ChipsId structure which may be passed into the move_frame routine. If a ChipsId is not provided, the window normalized coordinate system is used.

This command is equivalent to calling the move command with 'chips_frame' specified as the object.

Example 1

chips> move_frame(.5,.5)

Move the current frame to the center of the window in window normalized coordinates.

Example 2

chips> id=ChipsId()
chips> id.coord_sys=PIXEL
chips> move_frame(id,-20,0,1)

Adjust the position by 20 pixels to the left in the x direction. Do not move it in the y direction.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

frames

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

utilities

erase, get_object_count