SET INTERIOR REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

SET INTERIOR REPRESENTATION − define an interior attribute bundle on the workstation.

SYNOPSIS

C Syntax

void
psetintrep ( ws, index, rep )
Pintws;workstation identifier
Pintindex;interior bundle index
Pinterbundl∗rep;interior representation pointer

FORTRAN Syntax

SUBROUTINE psir ( WKID, II, INTS, STYLI, COLI )
INTEGERWKIDworkstation identifier
INTEGERIIinterior index
INTEGERINTSinterior style
INTEGERSTYLIstyle index
INTEGERCOLIcolour index

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET INTERIOR REPRESENTATION defines a bundle of interior attributes for a specified entry in the workstation’s interior bundle table. Depending on the ASF for each of the interior attributes, the bundled attributes may apply to the following primitives:

FILL AREA
FILL AREA 3
FILL AREA SET
FILL AREA SET 3

C Input Parameters

wsThe identifier of the workstation for which the interior representation is being defined.

indexThe interior index of the entry being defined.

repA pointer to a structure containing the attribute values defining the interior representation, defined as follows:

typedef struct {
Pinterstylestyle;/∗ interior style ∗/
Pintindex;/∗ interior style index ∗/
Pintcolour;/∗ interior colour index ∗/
} Pinterbundl;

rep->style is an enumerated value specifying one of the following interior styles:

PHOLLOW“Hollow”
PSOLID“Solid”
PPATTERN“Patterned”
PHATCH“Hatched”
PEMPTY“Empty”

rep->index is the interior style index, which selects from the workstation’s PATTERN or HATCH table. rep->colour is the interior colour index, which selects a colour value from the workstation’s colour table.

FORTRAN Input Parameters

WKIDThe identifier of the workstation for which the interior representation is being defined.

IIThe interior index of the entry being defined.

INTSAn enumerated interior style value, specifying one of the following:

PHOLLO“Hollow”
PSOLID“Solid”
PPATTR“Patterned”
PHATCH“Hatched”
PISEMP“Empty”

STYLI
The interior style index, which selects from the workstation’s PATTERN or HATCH table.

COLIThe interior colour index, which selects a colour value from the workstation’s colour table.

EXECUTION

When SET INTERIOR REPRESENTATION is called, the interior index in the table of defined interior representations on workstation is set to the interior style, interior style index, and interior colour index values.

When area-defining output primitives are displayed, the interior representation specified by the ‘current interior index’ entry in the PHIGS traversal state list provides the interior attributes for which the Aspect Source Flag (ASF) is BUNDLED. For example, when the ‘current interior style ASF’ is set to BUNDLED, the “effective” interior style is the interior style attribute in the interior representation selected by the ‘current interior index’. The ‘current interior index’ is set by SET INTERIOR INDEX elements.

The interior bundle table is numbered from 1.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

100Ignoring function, the bundle index value is less than one

103Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation bundle table

108Ignoring function, the specified interior style is not available on the workstation

112Ignoring function, the pattern index value is less than one

113Ignoring function, the colour index value is less than zero

Museum