graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPM2 - Polymarker 2

GPPM2 (npoint, width, pointlist)

Purpose

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

This structure element defines a list of two-dimensional points (x, y) that the graPHIGS API identifies by markers and renders in Device Coordinate (DC) space parallel to the display surface.

If the primitive does not specify any points, it is ignored.

Polymarker 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

GPMSSC: Set Marker Size Scale Factor
GPMT: Set Marker Type
GPPMCD: Set Polymarker Color Direct
GPPMCI: Set Polymarker Color Index
GPPMI: Set Polymarker Index

RCP code

201328132 (X'0C000604')