graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPXIR - Set Extended Interior Representation

GPXIR (wsid, index, id, value)

Purpose

Use GPXIR to set one field of the specified entry in the workstation's interior bundle table. These attribute values are applied during traversal when the appropriate ASF is set to 1=BUNDLED and the current interior index is set to the specified entry. These attribute values can also be set individually.

The 1=HOLLOW and 5=EMPTY interior styles display nothing for the interior. If the edge flag is set to 1=OFF and the interior style is 5=EMPTY , then the graPHIGS API generates no visual output. The interior is detectable when the graPHIGS API encounters a primitive with with an interior style of 5=EMPTY and the primitive is eligible for picking as determined by its visibility and detectability.

If the edge flag is 1=OFF and the interior style is 1=HOLLOW , then the graPHIGS API draws the boundary (solid line) When the graPHIGS API encounters a primitive with an interior style 1=HOLLOW only the boundary of the primitive is eligible for picking as determined by its visibility and detectability.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Interior bundle table index (>=1)

id -- specified by user, fullword integer

Interior group identifier (1=INTERIOR_STYLE, 2=INTERIOR_STYLE_INDEX, 3=INTERIOR_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 - Interior style

A fullword integer (1=HOLLOW, 2=SOLID, 3=PATTERN, 4=HATCH, 5=EMPTY )

Group Identifier 2 - Interior style index

A fullword integer (>=1) which is an index into the pattern or hatch table depending on the current interior style.

Group Identifier 3 - Interior 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
83: INTERIOR STYLE NOT AVAILABLE ON WORKSTATION
84: INTERIOR STYLE INDEX VALUE < ONE
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
310: INTERIOR STYLE VALUE IS INVALID

Related Subroutines

GPASF: Attribute Source Flag Setting
GPCML: Set Color Model
GPICD: Set Interior Color Direct
GPICI: Set Interior Color Index
GPII: Set Interior Index
GPIS: Set Interior Style
GPISI: Set Interior Style Index
GPQXIR: Inquire Extended Interior Representation

RCP code

201345504 (X'0C004A04')