NAME

mkpnt - make a basic picture of points

SYNOPSIS

#include <mpict_p.h>

PICT mkpntl (mode, npnt, xcoord, ycoord)
int mode, npnt, xcoord[], ycoord[];

PICT mkpntv (mode, npnt, xycoord)
int mode, npnt, xycoord[][2];

DESCRIPTION

mkpnt builds a basic picture of points.

npnt is the number of points in the basic picture.

for mkpntl, the arrays xcoord and ycoord provide the (x,y) coordinates that describe the relative positions of points. For mkpntv each (x,y) coordinate pair is a vector element(i.e., a row) of the two-dimensional array xycoord e.g.:

xycoord[][2] = {{x0,y0},{x1,y1},...}

If the value of mode is RC (for relative chaining) then mkpnt interprets the first point as an offset from an arbitrary origin and each remaing point as an offset from the preceding point. If mode is RO (for relative origin) then each point is interpreted as an offset from an arbitrary origin.

mkpnt returns a PICT, a pointer to a picture structure that can be used as an argument to mkpic(3U) , mkpar(3U) , or mktop(3U) to build complex pictures.

SEE ALSO

mkpic(3U) , mkpar(3U) , mktop(3U)

DIAGNOSTICS

mkpnt prints an error message and returns EOP for the following reasons: