fg_vbtcopy()

Win32 DirectX Fastgraph/Light

Prototype

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

Sub fg_vbtcopy (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 color As Long, ByVal source As Long, ByVal dest As Long)

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

Description

The fg_vbtcopy() 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 matches the specified transparent color. 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.

color is the transparent color. For 256-color virtual buffers, it is a color index between 0 and 255. For direct color virtual buffers, it is an fg_maprgb() encoded color value.

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_vbtzcopy()