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

NAME

SET POLYLINE REPRESENTATION PLUS − set an extended polyline attribute bundle on a workstation

SYNOPSIS

C Syntax

void
pset_line_rep_plus ( ws, index, rep )
Pintws;workstation identifier
Pintindex;polyline bundle index
Pline_bundle_plus∗rep; extended polyline representation pointer

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET POLYLINE REPRESENTATION PLUS sets a bundle of extended polyline attributes for a specified entry in a workstation extended polyline bundle table.

C Input Parameters

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

indexThe index of the entry being set.

repA pointer to a Pline_bundle_plus structure. Pline_bundle_plus is defined as:

typedef struct {
Pinttype;/∗ line type ∗/
Pfloatwidth;/∗ linewidth scale factor ∗/
Pgcolrcolr;/∗ polyline colour ∗/
Pintshad_meth;/∗ polyline shading method ∗/
Pintapprox_type;/∗ curve approximation criteria ∗/
Pfloatapprox_val;/∗ curve approximation criteria ∗/
} Pline_bundle_plus;

Constants defined for linetype are:

1PLINE_SOLIDSolid
2PLINE_DASHDashed
3PLINE_DOT Dotted
4PLINE_DOT_DASHDot-dashed

Pgcolr is defined as:

typedef struct {
Pinttype;/∗ indirect, RGB, CIE, HSV, HLS ∗/
union {
     Pintind;/∗ index in workstation colour bundle table ∗/
     struct {
          Pfloatx;/∗ red, hue, etc. ∗/
          Pfloaty;/∗ green, saturation, lightness, etc. ∗/
          Pfloatz;/∗ blue, value, saturation, etc. ∗/
     } general;
} val;
} Pgcolr;

Constants defined for colour type are:

0PINDIRECTIndirect
1PMODEL_RGBRed, Green, and Blue
2PMODEL_CIELUVCIE
3PMODEL_HSVHue, Saturation, and Value
4PMODEL_HLSHue, Lightness, and Saturation

The ind member of the val union is used for type PINDIRECT. The general member is used for the other types. Constants defined for polyline shading method are:

1PSD_NONENo Shading
2PSD_COLOURColour Interpolation Shading
3PSD_DOT_PRODUCT
4PSD_NORMAL

Constants defined for curve approximation type are:

1PCURV_WS_DEP
2PCURV_CONSTANT_PARAMETRIC_BETWEEN_KNOTS
3PCURV_CHORDAL_SIZE_WC
4PCURV_CHORDAL_SIZE_NPC
5PCURV_CHORDAL_SIZE_DC
6PCURV_CHORDAL_DEVIATION_WC
7PCURV_CHORDAL_DEVIATION_NPC
8PCURV_CHORDAL_DEVIATION_DC

See SET CURVE APPROXIMATION CRITERIA for a description of the meaning of these constants and their use of the curve approximation value.

Execution

SET POLYLINE REPRESENTATION PLUS sets the specified extended polyline bundle table entry in the specified workstation state list. The extended polyline bundle table contains bundled entries of the PHIGS and PHIGS Extension polyline attributes. SET POLYLINE REPRESENTATION PLUS sets the individual entries of this table. During traversal, the attribute values of these bundles are used when the corresponding aspect source flag in the workstation state list is set to BUNDLED.

The PHIGS polyline bundle table is a portion of the extended table. The function SET POLYLINE REPRESENTATION sets the following attributes in the extended table: linetype, linewidth scale factor, and colour index (colour type of Indirect is assumed).

During structure traversal the current polyline index refers to an entry in the workstation extended polyline bundle table. Depending on the settings of the aspect source flags, the contents of that bundle table entry are used to determine the attributes associated with output primitives that use the extended polyline bundle table. These primitives are:

POLYLINE
POLYLINE 3
POLYLINE SET 3 WITH DATA
NON-UNIFORM B-SPLINE CURVE
GDP
(Linear Primitives)
GDP3
(Linear Primitives)
CELL ARRAY (When Performing Minimal Simulation)
CELL ARRAY 3
(When Performing Minimal Simulation)

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 linetype is not available on the specified workstation

110Ignoring function, the specified colour model is not available on the workstation

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

122Ignoring function, the specified polyline shading method is not available on the workstation

136Ignoring function, one of the components of the colour specification is out of range

127Ignoring function, the specified approximation criteria type is not available on the specified workstation

128Ignoring function, the specified parametric surface characteristics type is not available on the specified workstation

138Ignoring function, one or more of the fields in the specified data record is inconsistent with the specified type

Museum