SET LINEWIDTH SCALE FACTOR(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pset_linewidth ( width )
Pfloatwidth;linewidth scale factor

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET LINEWIDTH SCALE FACTOR creates 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

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.

Execution

When the SET LINEWIDTH SCALE FACTOR element is traversed, the current linewidth scale factor entry in the 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 that 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.

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