[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPPLR - Set Polyline Representation

GPPLR (wsid, index, ltype, lwidth, color)

Purpose

Use GPPLR to set the given attribute values in the specified entry of the polyline bundle table.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Polyline bundle table index (>=1) Index of polyline bundle table entry to be loaded.

ltype -- specified by user, fullword integer

Specifies an index into the workstation's line type table. The table size and specific entries supported are workstation dependent. Use the Inquire Polyline Facilities (GPQPLF) subroutine to locate the supported line types on your workstation. The default line type table for supported entries is defined with the following line types: (1=SOLID_LINE, 2=DASHED, 3=DOTTED, 4=DASH_DOT, 5=LONG_DASH, 6=DOUBLE_DOT, 7=DASH_DOUBLE_DOT, 8-n=SOLID_LINE Any entry may be changed by the Set Linetype Representation (GPLTR) subroutine except entry 1)

lwidth -- specified by user, short floating-point number

Line width scale factor is specified as a fraction of the nominal width of a line. A line width scale factor of 1.0, which is the default, generates a nominal size line on any workstation. Any other value is mapped to the closest line width available on the workstation.

color -- specified by user, fullword integer

Polyline color index (>=0)

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
35
WORKSTATION HAS ONLY INPUT CAPABILITIES
43
BUNDLE INDEX EXCEEDS WORKSTATION TABLE CAPACITY
60
BUNDLE INDEX VALUE < ONE
63
LINETYPE VALUE < ONE
64
SPECIFIED LINETYPE NOT AVAILABLE ON WORKSTATION
92
COLOR INDEX < ZERO
93
COLOR INDEX VALUE(S) EXCEED WORKSTATION TABLE CAPACITY

Related Subroutines

GPXPLR
Set Extended Polyline Representation

RCP code

201329409 (X'0C000B01')


[ Previous | Next | Contents | Glossary | Home | Search ]