graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPL2 - Polyline 2

GPPL2 (npoint, width, pointlist)

Purpose

Use GPPL2 to create a two-dimensional 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 Polyline 2 structure element depending on the current edit mode.

This structure element defines a list of two-dimensional points (x, y) (the z coordinate is assumed to be zero) that the graPHIGS API is to connect by straight lines starting with the first point and ending with the last point.

If the application specifies one point or less, then no output is generated. If the application specifies two contiguous points as the same point, then the graPHIGS API generates a point of one pixel in size.

Polyline attributes are applied to this primitive.

Parameters

npoint -- specified by user, fullword integer

Number of points (>=0)

width -- specified by user, fullword integer

Number of fullwords between subsequent x values (>=2)

pointlist -- specified by user, array of short floating-point numbers (MC)

Array of points specified in row order.

The input array contains a list of points in which subsequent x values are separated by width fullwords.

Error Codes

5: FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
100: NUMBER OF POINTS < ZERO
557: WIDTH PARAMETER < MINIMUM ALLOWED

Related Subroutines

GPLT: Set Linetype
GPLWSC: Set Linewidth Scale Factor
GPPLCD: Set Polyline Color Direct
GPPLCI: Set Polyline Color Index
GPPLET: Set Polyline End Type
GPPLI: Set Polyline Index

RCP code

201328130 (X'0C000602')