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

GPXPLR - Set Extended Polyline Representation

GPXPLR (wsid, index, id, value)

Purpose

Use GPXPLR to set one field in the specified entry of the workstation's polyline bundle table.

These attribute values are applied during traversal when the appropriate ASF is set to 1=BUNDLED and the current polyline index is set to the specified entry. These attribute values can also be set individually.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Polyline bundle table index (>=1)

id -- specified by user, fullword integer

Polyline group identifier (1=LINETYPE, 2=LINEWIDTH_SCALE_FACTOR, 3=POLYLINE_COLOR )

value -- specified by user, variable data

The value that may be set for each field is expressed in the data format listed below:

Group Identifier 1 - Line type

A fullword integer (>=1) Specifies an index into the workstation's line type table. The table size and specific entries supported is workstation dependent. Use the Inquire Polyline Facilities (GPQPLF) subroutine to determine 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 GPLTR except entry 1)

Group Identifier 2 - Linewidth scale factor

A short floating point number.

Group Identifier 3 - Polyline color

Four fullwords of data with either of the following two formats:
      indexed format                        direct format
      -------------                         -------------
    0 |          1| fullword integer      0 |          2| fullword integer
      |-----------|                         |-----------|
    4 |color index| fullword integer      4 |component 1| short floating-point number
      |-----------|                         |-----------|
    8 |    ignored| fullword integer      8 |component 2| short floating-point number
      |-----------|                         |-----------|
   12 |    ignored| fullword integer     12 |component 3| short floating-point number
      -------------                         -------------

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
96
COLOR PARAMETER OUT OF RANGE FOR CURRENT COLOR MODEL
97
COLOR FORMAT PARAMETER IS INVALID
272
GROUP IDENTIFIER IS INVALID

Related Subroutines

GPASF
Attribute Source Flag Setting
GPCML
Set Color Model
GPLT
Set Linetype
GPLWSC
Set Linewidth Scale Factor
GPPLCD
Set Polyline Color Direct
GPPLCI
Set Polyline Color Index
GPPLI
Set Polyline Index
GPQXLR
Inquire Extended Polyline Representation

RCP code

201345537 (X'0C004A01')


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