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-Filev_fillarea()
vsl_color()
vsl_type()
vsl_udsty()
v_pline()                                                               VDI

Syntax

VOID v_pline( handle, count, pxy )
WORD handle, count;
WORD *pxy;

Function      v_pline() outputs a polyline (group of one or more lines).

Opcode        6

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle. count specifies
              the number of vertices in the line path (2 to plot a single
              line). pxy points to a WORD array with count * 2 elements
              containing the vertices to plot as in (X1, Y1), (X2, Y2),
              etc...

Binding       WORD i;

              contrl[0] = 6;
              contrl[1] = count;
              contrl[3] = 0;
              contrl[6] = handle;

              for(i = 0;i < (count*2);i++)
               ptsin[i] = pxy[i];

              vdi();

Comments      To draw a single point with this function, pxy[2] should
              equal pxy[0], pxy[3] should equal pxy[1], and count should
              be 2.

See Also      v_fillarea(), vsl_color(), vsl_type(), vsl_udsty(),
              vsl_ends()

Group         VDI Output