block_move(3G)

NAME

block_move, dcblock_move, intblock_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,length_x,length_y,x_dest,y_dest;

void intblock_move(fildes,x_source,y_source,length_x,length_y,x_dest,
y_dest);
int fildes,x_source,y_source,length_x,length_y,x_dest,y_dest;

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,x_dest,y_dest,length_x,length_y

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

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);

procedure intblock_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 , intblock_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.

Integer operations are only available when using the INT_XFORM gopen mode. When in INT_XFORM mode, floating point operations are not available for that fildes. Floating point operations are the default, or can be specified with FLOAT_XFORM mode. For a list of integer operations, floating point operations and common operations see the starbase.3g manual page.

Museum

Related Articles