BLOCK_MOVE(3G)

NAME

block_move − A frame buffer to frame buffer copy procedure.

SYNOPSIS

C SYNTAX

void block_move(fildes,x_source,y_source,
length_x,length_y,x_dest,y_dest);
int fildes;
float x_source,y_source,x_dest,y_dest;
int length_x,length_y;
void dcblock_move(fildes,x_source,y_source,
length_x,length_y,x_dest,y_dest);
int fildes;
int x_source,y_source,x_dest,y_dest,length_x,length_y;

FORTRAN77 SYNTAX

        subroutine block_move(fildes,x_source,y_source,
        length_x,length_y,x_dest,y_dest)
        integer*4 fildes
        real x_source,y_source,x_dest,y_dest
        integer*4 length_x,length_y

        subroutine dcblock_move(fildes,x_source,y_source,
        length_x,length_y,x_dest,y_dest)
        integer*4 fildes
        integer*4 x_source,y_source
        integer*4 x_dest,y_dest
        integer*4 length_x,length_y

PASCAL SYNTAX

procedure block_move(fildes:integer;x_source,y_source:real;
length_x,length_y:integer;x_dest,y_dest:real);
procedure dcblock_move(fildes:integer;x_source,y_source,
length_x,length_y,x_dest,y_dest:integer);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened.
x_source,y_source
are the coordinates of the upper left corner of the source in Virtual Device Coordinates (block_move) or Device Coordinates (dcblock_move).
x_dest,y_dest
are the coordinates of the upper left corner of destination in Virtual Device Coordinates or Device Coordinates.
length_x,length_y
are the length of the sides of the block to be moved measured in pixels.

DISCUSSION

Block_move copies the source rectangle beginning at location (x_source,y_source) with sides of length_x and length_y to the destination rectangle beginning at location (x_dest,y_dest) with sides of length_x and length_y using the current drawing mode.

     xs,ys     <-lx->
      *-----------------------
      |                      |
   ^ |                      |
   l |    xd,yd     <-lx-> |
   y |      *-----------------------
      |      |                      |
      |      |                      | ^
      |      |                      | l
      -------|                      | y
             |                      |
             |                      |
             |                      |
             ------------------------

If the clip indicator is not CLIP_OFF or the rectangle extends outside the raster limits of the display device, then only the intersection of the source rectangle and the current clip boundaries is combined with the intersection of the destination window and the raster limits.

Only the write enabled planes are affected.

Block_move does not copy between graphic devices.

Museum

Related Articles