BLOCK_MOVE(3G)

NAME

block_move − 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,x_source,y_source
integer*4 x_dest,y_dest,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);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

x_source,y_source Coordinates of upper left corner of the source in Virtual Device Coordinates (block_move) or Device Coordinates (dcblock_move).

x_dest,y_dest Coordinates of upper left corner of destination in Virtual Device Coordinates or Device Coordinates.

length_x,length_y Length (in pixels) of the horizontal and vertical sides of the block being moved.

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.

If the clip indicator is not CLIP_OFF, or if the rectangle extends outside the raster limits of the display device, the block copy is limited to the intersection of the source rectangle and the current clip boundaries combined with the intersection of the destination window and the raster limits.

Only write enabled planes are affected.

On multi-bank graphics devices, block copy occurs only in the current bank set by bank_switch. If shade_mode is CMAP_FULL, the block move is performed on all displayed graphics banks, simultaneously.

Block_move does not copy between graphics devices.

Museum

Related Articles