SET EDGETYPE(3P) — SUNPHIGS LIBRARY

NAME

SET EDGETYPE − create a structure element to set the current edgetype attribute

SYNOPSIS

C Syntax

void
psetedgetype ( edgetype )
Pintedgetype;edgetype

FORTRAN Syntax

SUBROUTINE psedt ( EDTYPE )
INTEGEREDTYPEedgetype

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET EDGETYPE creates a structure element structure containing a value for the current edgetype attribute.

When the current edgetype Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute defines the edgetype to be applied to the following output primitives:

• FILL AREA SET

• FILL AREA SET 3

• GENERALIZED DRAWING PRIMITIVE (Fill Area Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Fill Area Primitives)

C Input Parameter

edgetype
An integer value specifying one of the following edge types:

1PLN_SOLIDSolid
2PLN_DASHDashed
3PLN_DOTDotted
4PLN_DOTDASHDot-dashed
0PLN_LONGDASHLong-dashed
-1PLN_DOTDASHDOTDot-dashed-dot-dotted
-2PLN_CENTERCenter (Long-short Dashed)
-3PLN_PHANTOMPhantom (Long-short-short Dashed)

Support for edgetypes is workstation dependent.

FORTRAN Input Parameter

EDTYPE
The edgetype specifies one of the following:

1PLSOLISolid
2PLDASHDashed
3PLDOTDotted
4PLDASDDot-dashed
0PLNLONGDASHLong-dashed
-1PLNDOTDASHDOTDot-dashed-dot-dotted
-2PLNCENTERCenter (Long-short Dashed)
-3PLNPHANTOMPhantom (Long-short-short Dashed)

Support for edgetypes is workstation dependent.

Execution

If the current edit mode is INSERT, a SET EDGETYPE 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 EDGETYPE 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 EDGETYPE element is traversed, the current edgetype entry in the PHIGS traversal state list is set to edgetype. When the edge flag attribute is set to ON, and the current edgetype ASF is set to INDIVIDUAL, the edges of the fill area set output primitives which follow in the structure network will be drawn with the edgetype specified. See GENERALIZED DRAWING PRIMITIVE and GENERALIZED DRAWING PRIMITIVE 3 to determine which of the generalized primitives use the fill area set attributes.

If the edge flag is set to OFF, these primitives are drawn without edges and only the interior fill is displayed. If the edge flag is OFF and the interior style is Empty, the primitive will not be visible.

When the edge flag is ON and the current edgetype ASF is set to BUNDLED, the edgetype will be taken from the workstation’s representation indicated by the current edge index. In this case, the edgetype set with SET EDGETYPE has no effect.

If the edgetype specified is not available on the workstation to which the structure is posted, edgetype 1 (Solid) will be used.

The Center and Phantom edgetypes are intended to support Line Conventions and Lettering standards ANSI Y14.2M - 1979 and ISO DIS 128. (Center lines are used to represent axes of symmetrical parts and features, bold circles, and paths of motion. Phantom lines are used to indicate alternate positions of moving parts, adjacent positions of related parts, and repeated detail.) The length of the long dashes are intended to vary in length, depending on the length of the line. Both center lines and phantom lines should start and end with long dashes. Very short center lines may be unbroken. Even when these edgetypes are supported by a workstation, it is workstation dependent whether the long dash lengths are adjusted in this way. No workstation type presently varies the long dash lengths.

ERRORS

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

Museum