SET LINETYPE(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psetlinetype ( linetype )
Pintlinetype;linetype

FORTRAN Syntax

SUBROUTINE psln ( LTYPE )
INTEGERLTYPElinetype

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET LINETYPE create a structure element containing a value for the ‘current linetype’ attribute. When the ‘current linetype ASF’ is set to INDIVIDUAL, this attribute defines the linetype to be applied to the output primitives

• POLYLINE

•POLYLINE 3

•GDP(linear primitives)

•GDP 3(linear primitives)

If the current edit mode is INSERT, 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, 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:

ValueLinetypeMeaning
1PLN_SOLID“Solid”
2PLN_DASH“Dashed”
3PLN_DOT“Dotted”
4PLN_DOTDASH“Dot-dashed”
0PLN_LONGDASH“Long-dashed”
-1PLN_DOTDASHDOT“Dot-dashed-dot-dotted”
-2PLN_CENTER“Center” (long-short dashed)
-3PLN_PHANTOM“Phantom” (long-short-short dashed)

Support for linetypes is workstation dependent.

FORTRAN Input Parameter

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

ValueLinetypeMeaning
1PLSOLI“Solid”
2PLDASH“Dashed”
3PLDOT“Dotted”
4PLDASD“Dot-dashed”
0PLNLONGDASH“Long-dashed”
-1PLNDOTDASHDOT“Dot-dashed-dot-dotted”
-2PLNCENTER“Center” (long-short dashed)
-3PLNPHANTOM“Phantom” (long-short-short 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’ (Aspect Source Flag) is set to INDIVIDUAL, line output primitives which follow in the structure network will be drawn with the linetype specified. See GENERALIZED DRAWING PRIMITIVE (3P) and GENERALIZED DRAWING PRIMITIVE 3 (3P) to determine which of the generalized primitives use the polyline attributes.

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.

The “Center” and “Phantom” linetypes 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 linetypes 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