SET LINEWIDTH SCALE FACTOR(3P) — SUNPHIGS LIBRARY

NAME

SET LINEWIDTH SCALE FACTOR − create structure element to set the current linewidth scale factor attribute

SYNOPSIS

C Syntax

void
psetlinewidth ( width )
Pfloatwidth;linewidth scale factor

FORTRAN Syntax

SUBROUTINE pslwsc ( LWIDTH )
REALLWIDTHlinewidth scale factor

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET LINEWIDTH SCALE FACTOR create a structure element containing a value for the ‘current linewidth scale factor’ attribute. When the ‘linewidth scale factor ASF’ is set to INDIVIDUAL, this attribute defines the current linewidth to be applied to the output primitives:

•POLYLINE

•POLYLINE 3

•GDPPolyline Set

•GDP 3Polyline Set 3

If the current edit mode is INSERT, a SET LINEWIDTH SCALE FACTOR 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 LINEWIDTH SCALE FACTOR 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

widthA real value specifying the linewidth scale factor.

FORTRAN Input Parameter

LWIDTH
A real value specifying the linewidth scale factor.

Execution

When the SET LINEWIDTH SCALE FACTOR element is traversed, the ‘current linewidth scale factor’ entry in the PHIGS traversal state list is set to linewidth scale factor. When the ‘current linewidth scale factor ASF’ (Aspect Source Flag) is set to INDIVIDUAL, line output primitives which follow in the structure network are drawn using the linewidth scale factor specified.

The width of the line drawn is determined by applying the current linewidth scale factor to the ‘nominal linewidth’ as defined in the workstation description table and this result is then mapped to the nearest linewidth supported on the workstation. Presently, the nominal line width is 1 pixel, and supported linewidths vary by 1 pixel units.

When the ‘current linewidth scale factor ASF’ is set to BUNDLED, the “effective” linewidth scale factor is the linewidth attribute in the polyline representation selected by the ‘current polyline index’. In this case, the linewidth scale factor value set with SET LINEWIDTH SCALE FACTOR will have no effect.

ERRORS

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

Museum