pmv(3G)								       pmv(3G)

NAME    [Toc]    [Back]

     pmv, pmvi,	pmvs, pmv2, pmv2i, pmv2s - specifies the first point of	a
     polygon

C SPECIFICATION    [Toc]    [Back]

     void pmv(x, y, z)
     Coord x, y, z;

     void pmvi(x, y, z)
     Icoord x, y, z;

     void pmvs(x, y, z)
     Scoord x, y, z;

     void pmv2(x, y)
     Coord x, y;

     void pmv2i(x, y)
     Icoord x, y;

     void pmv2s(x, y)
     Scoord x, y;

     All of the	above routines are functionally	the same.  They	differ only in
     the type declarations of their parameters and in whether or not they
     assume a two-dimensional or three-dimensional space.

PARAMETERS    [Toc]    [Back]

     x	 expects the x coordinate of the first point if	a polygon.

     y	 expects the y coordinate of the first point of	a polygon.

     z	 expects the z coordinate of the first point of	a polygon.

DESCRIPTION    [Toc]    [Back]

     pmv specifies the starting	point of a polygon.  The next drawing command
     will start	drawing	from this point.  You draw a typical polygon with a
     pmv, a sequence of	pdr, and close it with a pclos.

     Between pmv and pclos, you	can only issue the following Graphics Library
     subroutines:  color, RGBcolor, cpack, lmdef, lmbind pdr, c	family of
     subroutines (for example, c3f), n family of subroutines (for example,
     n3f), and v family	of subroutines (for example, v3f).  Only use lmdef and
     lmbind to respecify materials and their properties.

EXAMPLE    [Toc]    [Back]

     The following sequence draws a square:








									Page 1






pmv(3G)								       pmv(3G)



	  pmv(0.0, 0.0,	0.0);
	  pdr(1.0, 0.0,	0.0);
	  pdr(1.0, 1.0,	0.0);
	  pdr(0.0, 1.0,	0.0);
	  pclos();

SEE ALSO    [Toc]    [Back]

     bgnpolygon, endpolygon, pclos, pdr, v

NOTES    [Toc]    [Back]

     pmv should	not be used in new development.	 Rather, polygons should be
     drawn using the high-performance v	commands, surrounded by	calls to
     bgnpolygon	and endpolygon.

     There can be no more than 256 vertices in a polygon.  Therefore, there
     can be no more than 255 pdr calls between pmv and pclos.


									PPPPaaaaggggeeee 2222