SET POLYLINE REPRESENTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

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

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

• POLYLINE SET 3 WITH DATA

• NON-UNIFORM B-SPLINE CURVE

• ANNOTATION TEXT RELATIVE (when “connected” style is in use)

• ANNOTATION TEXT RELATIVE 3 (when “connected” style is in use)

• CELL ARRAY (when minimal simulation is performed)

• CELL ARRAY 3 (when minimal simulation is performed)

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 ∗/
Pintcolr_ind;/∗ colour index ∗/
} Pline_bundle;

rep->type is an integer value specifying a linetype; the following line types are defined:

1PLINE_SOLIDSolid
2PLINE_DASHDashed
3PLINE_DOTDotted
4PLINE_DOT_DASHDot-dashed

Support for linetypes is workstation dependent. rep->width is the linewidth scale factor. rep->colr_ind is the 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 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.

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 (that is, 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