Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevro_cpyfm()
vrt_cpyfm()                                                             VDI

Syntax

VOID vrt_cpyfm( handle, mode, pxy, src, dest, colors )
WORD handle, mode;
WORD *pxy;
MFDB *src, *dest;
WORD *colors;

Function      vrt_cpyfm() 'blits' a single-plane source form to
              a multiple-plane destination.

Opcode        121

Availability  Supported by all screen drivers.

Parameters    handle specifies a valid workstation handle. mode specifies
              the writing mode (1-4, see vswr_mode() ). pxy, src, and dest
              are defined the same as in vro_cpyfm(). colors points to a 2
              WORD array which specifies the colors to apply to the
              'blitted' image.
              colors[0] is applied to all set bits in the source image and
              colors[1] is applied to all of the cleared bits.

Binding       contrl[0] = 121;
              contrl[1] = 4;
              contrl[3] = 3;
              contrl[6] = handle;
              contrl[7] = (WORD)((LONG)src >> 16);
              contrl[8] = (WORD)src;
              contrl[9] = (WORD)((LONG)dest >> 16);
              contrl[10] = (WORD)dest;

              intin[0] = mode;
              intin[1] = colors[0];
              intin[2] = colors[1];

              ptsin[0] = pxy[0];
              ptsin[1] = pxy[1];
              ptsin[2] = pxy[2];
              ptsin[3] = pxy[3];
              ptsin[4] = pxy[4];
              ptsin[5] = pxy[5];
              ptsin[6] = pxy[6];
              ptsin[7] = pxy[7];

              vdi();

Comments      The source form must be a monoplane form.

See Also      vro_cpyfm()

Group         VDI Raster