**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 [[jvs:cigal:manual:chapter6:r_color|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:**\\
[[jvs:cigal:manual:chapter6:r_bset|R_BSET(6)]],
[[jvs:cigal:manual:chapter6:r_bmove|R_BMOVE(6)]],
[[jvs:cigal:manual:chapter6:r_bdraw|R_BDRAW(6)]],
[[jvs:cigal:manual:chapter6:r_movept|R_MOVEPT(6)]]

[[jvs:cigal|CIGAL Home]], 
[[jvs:cigal:manual|CIGAL Manual]], 
[[jvs:cigal:manual:chapter6|RealTime List]], 
[[jvs:cigal:manual:help|Manual Help]]