rpmv(3G)

NAME
     rpmv, rpmvi, rpmvs, rpmv2, rpmv2i, rpmv2s - relative polygon move

C SPECIFICATION
     void rpmv(dx, dy, dz)
     Coord dx, dy, dz;

     void rpmvi(dx, dy, dz)
     Icoord dx, dy, dz;

     void rpmvs(dx, dy, dz)
     Scoord dx, dy, dz;

     void rpmv2(dx, dy)
     Coord dx, dy;

     void rpmv2i(dx, dy)
     Icoord dx, dy;

     void rpmv2s(dx, dy)
     Scoord dx, dy;

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

PARAMETERS
     dx   expects the distance from the x coordinate of the current graphics
          position to the x coordinate of the first point in a polygon.

     dy   expects the distance from the y coordinate of the current graphics
          position to the y coordinate of the first point in a polygon.

     dz   expects the distance from the z coordinate of the current graphics
          position to the z coordinate of the first point in a polygon.

DESCRIPTION
     rpmv is the relative version of pmv.  It specifies a relative move to the
     starting point of a filled polygon, using the current graphics position
     as the origin.  rpmv updates the current graphics position to the new
     point.

     Between rpmv and pclos, you can issue only the following Graphics Library
     subroutines:  color, RGBcolor, c, cpack, n, v, lmdef, and lmbind.  Use
     lmdef and lmbind to respecify only materials and their properties.

SEE ALSO
     bgnpolygon, endpolygon, pclos, rpdr, v
NOTES
     rpmv 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.  Matrix commands pushmatrix, translate, and
     popmatrix should be used to accomplish relative positioning.

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