graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

POLYLINE 3 (PHOP,,STOP,)

Purpose

Use Polyline 3 to create a three-dimensional polyline element and insert it into the open structure following the element pointer or replace the element pointed at by the element pointer with a Polyline 3 structure element, depending on the current edit mode.

This structure element defines a list of three-dimensional points (x, y, z) 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 or less points, then no output is generated. If two contiguous points are the same point, then the graPHIGS API generates a point of one pixel in size.

The graPHIGS API applies polyline attributes to this primitive.

Language Bindings

C

ppolyline3 (point_list)

Input Parameters

const Ppoint_list3 *point_list

List of points in MC.

FORTRAN

PPL3 (n, pxa, pya, pza)

Input Parameters

integer n

Number of points (>=0).

real pxa (n)

x coordinates of points in MC.

real pya (n)

y coordinates of points in MC.

real pza (n)

z coordinates of points in MC.

Errors

5: Function Requires State (PHOP,*,STOP,*)

Related Subroutines

Set Linetype

Set Linewidth Scale Factor

Set Polyline Color Index

Set Polyline Index

POLYLINE 3 (PHOP,*,STOP,*)

C

Input Parameters

FORTRAN

Input Parameters

POLYLINE 3 (PHOP,,STOP,)