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

NAME

SET LINETYPE − create structure element to set the current linetype attribute

SYNOPSIS

C Syntax

void
pset_linetype ( linetype )
Pintlinetype;linetype

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET LINETYPE creates a structure element containing a value for the current linetype attribute. When the current linetype ASF (Aspect Source Flag) is set to INDIVIDUAL, the attribute defines the linetype to be applied to the following output primitives:

• POLYLINE

• POLYLINE 3

• POLYLINE SET 3 WITH DATA

• NON-UNIFORM B-SPLINE CURVE

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

C Input Parameter

linetype
An integer value specifying a linetype; the following line types are defined:

1PLINE_SOLIDSolid
2PLINE_DASHDashed
3PLINE_DOTDotted
4PLINE_DOT_DASHDot-dashed

Support for linetypes is workstation dependent.

Execution

When the SET LINETYPE element is traversed, the current linetype entry in the PHIGS traversal state list is set to linetype. When the current linetype ASF is set to INDIVIDUAL, line output primitives which follow in the structure network will be drawn with the linetype specified.

When the current linetype ASF is set to BUNDLED, the effective linetype is the linetype attribute in the polyline representation selected by the current polyline index. In this case, the linetype set with SET LINETYPE has no effect.

If the linetype specified is not available on the workstation, linetype 1 (Solid) will be used.

ERRORS

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

Museum