Topic       : Pure C Library Documentation
Author      : John Kormylo
Version     : LIB.HYP 1.0
Subject     : Documentation/Pure C Library
Nodes       : 1309
Index Size  : 32068
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : en
@default    : 
@help       : Help
@options    : +g -i -s +x +z -t4
@width      : 75
View Ref-File[ vrt_cpyfm ]

#include <vdi.h>

void vrt_cpyfm( int handle, int wr_mode, int *pxyarray,
                MFDB *psrcMFDB, MFDB *pdesMFDB, int *color_index );

  <handle> is the VDI Handle.
  <wr_mode> is the writing mode:
            MD_REPLACE - replace foreground and background
            MD_TRANS   - replace foreground only
            MD_XOR     - change foreground to reverse video of old image
            MD_ERASE   - replace background only
  <pxyarray> is an 8 entry int array of VDI Coordinates:
             [0] = left (or right) x coordinate of source rectangle.
             [1] = lower (or upper) y coordinate of source rectangle.
             [2] = right (or left) x coordinate of source rectangle.
             [3] = upper (or lower) y coordinate of source rectangle.
             [4] = left (or right) x coordinate of dest rectangle.
             [5] = lower (or upper) y coordinate of dest rectangle.
             [6] = right (or left) x coordinate of dest rectangle.
             [7] = upper (or lower) y coordinate of dest rectangle.
  <psrcMFDB> points to the source Memory Form Definition Block.
  <pdesMFDB> points to the destination Memory Form Definition Block.
  <color_index> is a 2 entry int array of color indexes:
                [0] = foreground color.
                [1] = background color.


Function copies a 1 bit plane source raster to a color destination
raster using the foreground and background colors in <color_index>.

One selects the physical device to be the destination by setting the
corresponding MFDB fd_addr to NULL.

If the source and destination rectangles are not the same size, VDI
will use the size from the source and only the upper left corner of
the destination.

VDI Opcode 121

See also VDI Raster and Bit Planes.