SET POLYLINE REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

SET POLYLINE REPRESENTATION − define a polyline attribute bundle on a workstation

SYNOPSIS

C Syntax

void
psetlinerep ( ws, index, rep )
Pintws;workstation identifier
Pintindex;polyline bundle index
Plnbundl∗rep;polyline representation pointer

FORTRAN Syntax

SUBROUTINE psplr ( WKID, PLI, LTYPE, LWIDTH, COLI )
INTEGERWKIDworkstation identifier
INTEGERPLIpolyline index
INTEGERLTYPElinetype
REALLWIDTHlinewidth scale factor
INTEGERCOLIcolour index

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET POLYLINE REPRESENTATION defines a bundle of polyline attributes for a specified entry in the workstation’s polyline bundle table.

Depending on the ASF for each of the polyline attributes, the bundled attributes may apply to the following primitives:

• POLYLINE

• POLYLINE 3

• GENERALIZED DRAWING PRIMITIVE (Linear Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Linear Primitives)

C Input Parameters

wsThe identifier of the workstation for which the polyline representation is being defined.

indexThe polyline index of the entry being defined.

repA pointer to a structure containing the attribute values defining the polyline representation, defined as follows:

typedef struct {
Pinttype;/∗ line type ∗/
Pfloatwidth;/∗ linewidth scale factor ∗/
Pintcolour;/∗ colour index ∗/
} Plnbundl;

rep->type is 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. See SET LINETYPE (3P) for caveats regarding the Center and Phantom linetypes. rep->width is the linewidth scale factor. rep->colour is the polyline colour index, which selects a colour value from the workstation’s colour table.

FORTRAN Input Parameters

WKIDThe identifier of the workstation for which the polyline representation is being defined.

PLIThe polyline index of the entry being defined.

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. See SET LINETYPE (3P) for caveats regarding the Center and Phantom linetypes.

LWIDTH
The linewidth scale factor.

COLIThe polyline colour index, which selects a colour value from the workstation’s colour table.

Execution

When SET POLYLINE REPRESENTATION is called, the polyline index entry in the table of defined polyline representations on the workstation is set to the linetype, linewidth scale factor, and polyline colour index values.

When polyline output primitives are displayed, the polyline representation specified by the ‘current polyline index’ entry in the PHIGS traversal state list provides the polyline attributes for which the Aspect Source Flag (ASF) is BUNDLED. For example, 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’. The ‘current polyline index’ is set by SET POLYLINE INDEX elements.

The polyline bundle table is numbered from 1.

See GENERALIZED DRAWING PRIMITIVE (3P) and GENERALIZED DRAWING PRIMITIVE 3 (3P) to determine which of the generalized primitives use the polyline attributes.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

100Ignoring function, the bundle index value is less than one

103Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation bundle table

104Ignoring function, the specified line type is not available on the specified workstation

113Ignoring function, the colour index value is less than zero

Museum