User Tools

Site Tools


jvs:cigal:manual:chapter6:r_bput

CIGAL Reference Manual, Chapter 6 (RealTime): r_bput

r_bput -- Move a screen rectangle to an X-Y position

usage: r_bput opflg eflag ltime Point Box Flag

R_BPUT is a REALTIME operator. It moves a rectangular region of the screen image to a new location specified by POINT (a short integer array with 2 elements, which are interpreted as the new X and Y coordinates). The size and position of the starting region are specified by the BOX argument (a short integer array specifying 4 values: left, top, right, bottom). Regions no longer occupied by the rectangle are filled with the current background color (see R_COLOR(6)).

The FLAG argument is a bitflag that provides the following options:

        1 - center the rectangle at the POINT, otherwise the upper left corner
                of the rectangle is placed at POINT

        2 - treat the X,Y values in POINT as relative offsets

        4 - treat the X,Y values in POINT as relative offsets, but reverse the
            direction of motion (i.e., treat POINT as -X,-Y)

When R_BPUT is done the coordinates in the BOX array are updated to reflect the new position of the rectangle.

See Also:
R_BSET(6), R_BMOVE(6), R_BDRAW(6), R_MOVEPT(6)

CIGAL Home, CIGAL Manual, RealTime List, Manual Help

jvs/cigal/manual/chapter6/r_bput.txt · Last modified: 2023/02/23 18:43 (external edit)