SET INTERIOR REPRESENTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

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

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 Aspect Source Flag (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

• NON-UNIFORM B-SPLINE SURFACE

• FILL AREA SET 3 WITH DATA

• QUADRILATERAL MESH 3 WITH DATA

• TRIANGLE STRIP 3 WITH DATA

• SET OF FILL AREA SET 3 WITH DATA

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 Pint_bundle structure containing the interior representation attributes. Pint_bundle is defined as:

typedef struct {
Pint_stylestyle;/∗ interior style ∗/
Pintstyle_ind;/∗ interior style index ∗/
Pintcolr_ind;/∗ interior colour index ∗/
} Pint_bundle;

style is an enumerated value specifying one of the following interior styles. Pint_style is defined as:

typedef enum {
PSTYLE_HOLLOW,Hollow
PSTYLE_SOLID,Solid
PSTYLE_PAT,Patterned
PSTYLE_HATCH,Hatched
PSTYLE_EMPTY,Empty
} Pint_style;

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

colr_ind is the 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 the 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 traversal state list provides the interior attributes for which the 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 (in other words, 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