|GPDPL3 (npoint, width, pointlist, mdarray)|
Use GPDPL3 to create a three-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 three-dimensional, disjoint polyline element depending on the current edit mode.
This structure element defines multiple three-dimensional polylines. Each polyline consists of three-dimensional points (x, y, z) 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.
If the application specifies less than two points, 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 move to the next point.
Polyline attributes are applied to this primitive.
GPDPL3 is identified as GDP 1003.
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