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-Filevq_cellarray()
v_cellarray()                                                           VDI

Syntax

VOID v_cellarray( handle, pxy, rowlen, elements, num_rows, wrmode,
                  colarray )
WORD handle;
WORD *pxy;
WORD rowlen, elements, num_rows, wrmode;
WORD *colarray;

Function      v_cellarray() outputs an array of colored cells.

Opcode        10

Availability  Not supported by any current drivers.

Parameters    handle specifies a valid workstation handle.
              pxy points to a WORD array with 4 entries specifying a VDI
                 format rectangle giving the extent of the array to output.
              rowlen specifies the length of each color array row.
              elements specifies the total number of color array elements.
              num_rows specifies the number of rows in the color array.
              wrmode specifies a valid writing mode (1-4) and
              colarray points to an array of WORDs
                 (num_rows * elements) long.

Binding       WORD i;
              intin[i] = colarray[i]
              contrl[0] = 10;
              contrl[1] = 2;
              contrl[3] = num_rows * elements;
              contrl[6] = handle;
              contrl[7] = rowlen;
              contrl[8] = elements;
              contrl[9] = num_rows;
              contrl[10] = wrt_mode;

              for(i = 0;i < (num_rows * elements);i++)
               intin[i] = colarray;

              ptsin[0] = pxy[0];
              ptsin[1] = pxy[1];
              ptsin[2] = pxy[2];
              ptsin[3] = pxy[3];

              vdi();

Caveats       This function is not guaranteed available in any driver and
              should therefore be avoided unless you are sure the driver
              you are utilizing understands it.

See Also      vq_cellarray()

Group         VDI Output