|GPDPL2 (npoint, width, pointlist, mdarray)|
Use GPDPL2 to create a two-dimensional, disjoint polyline element and insert it into the open structure following the element pointer or to replace the element pointed at by the element pointer with a two-dimensional, disjoint polyline element depending on the current edit mode.
This structure element defines multiple two-dimensional polylines. Each polyline consists of a number of two-dimensional points (x, y) in Modelling Coordinate (MC) space that the graPHIGS API connects by straight lines starting with the first point in the list and ending with the last point in the list. The z coordinate is assumed to be zero.
If the application specifies less than two points in the list, then the graPHIGS API does not generate any output for that list. If the application specifies two contiguous points as the same point, then the graPHIGS API generates a point of one pixel in size.
The move/draw indicators (mdarray) specify the action required to go from one corresponding point to the next; that is, whether to draw or to move to the next point.
Polyline attributes are applied to this primitive.
GPDPL2 is identified as GDP 1004.
Not all GDPs are supported on all workstations. Use the Inquire List of Generalized Drawing Primitives (GPQGD) subroutine to determine the GDPs supported by an opened workstation. See also the workstation description in The graPHIGS Programming Interface: Technical Reference