graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPXER - Set Extended Edge Representation

GPXER (wsid, index, id, value)

Purpose

Use GPXER to set one field of the specified entry in the workstation's edge bundle table. These attribute values are applied during traversal when the appropriate ASF is set to 1=BUNDLED and the current edge 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

Edge bundle table index (>=1)

id -- specified by user, fullword integer

Edge group identifier (1=OFF, 2=ON, 3=GEOMETRY_ONLY )

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 - Edge flag

A fullword integer (1=OFF, 2=ON, 3=GEOMETRY_ONLY )

Group Identifier 2 - Edge line type

A fullword integer. Specifies an index into the workstation's edge line type table. The table size and specified entries supported are workstation dependent. Use the Inquire Edge Facilities (GPQEF) subroutine to determine the supported edge line types on your workstation. The default edge 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 ) (>=1) Any entry may be changed by GPLTR except entry 1)

Group Identifier 3 - Edge linewidth scale factor

A short floating-point number.

Group Identifier 4 - Edge 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
311: EDGE FLAG VALUE IS INVALID

Related Subroutines

GPASF: Attribute Source Flag Setting
GPCML: Set Color Model
GPECD: Set Edge Color Direct
GPECI: Set Edge Color Index
GPEI: Set Edge Index
GPELT: Set Edge Linetype
GPESC: Set Edge Scale Factor
GPQEF: Inquire Edge Facilities
GPQXER: Inquire Extended Edge Representation

RCP code

201345541 (X'0C004A05')