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

NAME

SET INTERIOR STYLE − create structure element to set the current interior style attribute

SYNOPSIS

C Syntax

void
pset_int_style ( style )
Pint_stylestyle;interior style

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET INTERIOR STYLE creates a structure element containing a value for the current interior style attribute.

When the current interior style Aspect Source Flag (ASF) is set to INDIVIDUAL, the current value of this attribute defines the interior style to be applied to the following output 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

C Input Parameters

All of the following data types are predefined in phigs.h.

styleAn enumerated value specifying one of the following interior styles:

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

Execution

If the current edit mode is INSERT, a SET INTERIOR STYLE element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET INTERIOR STYLE element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

When the SET INTERIOR STYLE element is encountered during traversal, the current interior style entry in the traversal state list is set to the specified interior style.

When the current interior style ASF is set to INDIVIDUAL, area-defining output primitives which follow in the structure network are filled using the current interior style. The interior styles have the following meanings:

HollowNo filling, but draw the bounding polyline using the colour specified by the interior colour index. This is the default style and is also used if an interior style is specified that is not available on the workstation.

SolidFill the interior using the colour specified by the interior colour index.

PatternedFill the interior using the interior style index as an index into the workstation pattern table. See SET PATTERN REPRESENTATION.

HatchedFill the interior using the colour specified by the interior colour index and the interior style index as an index into the workstation table of available hatches. Hatches are predefined; they cannot be defined by the application.

EmptyNo filling, but draw the edges in accordance with the edge flag. FILL AREA and FILL AREA 3 primitives will be invisible, but could still be pickable. See SET EDGE FLAG for more information.

When the current interior style ASF is set to BUNDLED, the interior style is taken from the workstation representation indicated by the current interior index. In this case, the interior style set with SET INTERIOR STYLE has no effect.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum