fg_vbtzcopy()

Win32 DirectX Fastgraph/Light

Prototype

void fg_vbtzcopy (int minx, int maxx, int miny, int maxy, int newx, int newy, int source, int dest);

Sub fg_vbtzcopy (ByVal minx As Long, ByVal maxx As Long, ByVal miny As Long, ByVal maxy As Long, ByVal newx As Long, ByVal newy As Long, ByVal source As Long, ByVal dest As Long)

procedure fg_vbtzcopy (minx, maxx, miny, maxy, newx, newy, source, dest : integer);

Description

The fg_vbtzcopy() function copies a rectangular region from one virtual buffer to another, or to a non-overlapping region in the same virtual buffer, excluding any pixels whose value is zero. As with Fastgraph's other block transfer routines, no clipping is performed.

Parameters

minx is the x coordinate of the source region's left edge.

maxx is the x coordinate of the source region's right edge. It must be greater than or equal to the value of minx.

miny is the y coordinate of the source region's top edge.

maxy is the y coordinate of the source region's bottom edge. It must be greater than or equal to the value of miny.

newx is the x coordinate of the destination region's left edge.

newy is the y coordinate of the destination region's bottom edge.

source is the handle for the virtual buffer containing the source region.

dest is the handle for the virtual buffer for the destination region.

Return value

none

Restrictions

The source and destination virtual buffers must be the same color depth.

If source and dest reference the same virtual buffer, the source and destination regions must not overlap.

When using DirectX, the source and destination virtual buffers must not be locked.

See also

fg_vbcopy(), fg_vbopen(), fg_vbtccopy(), fg_vbtcopy()