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

NAME

SET EDGE REPRESENTATION PLUS − set an extended edge attribute bundle on a workstation

SYNOPSIS

C Syntax

void
pset_edge_rep_plus ( ws, index, rep )
Pintws;workstation identifier
Pintindex;edge bundle index number
Pedge_bundle_plus∗rep; edge representation pointer

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET EDGE REPRESENTATION PLUS sets an extended edge attribute bundle on a workstation.

C Input Parameters

wsThe identifier of the workstation.

indexThis is an index to the workstation edge bundle table.

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

typedef struct {
Pedge_flagflag;/∗ edge flag ∗/
Pinttype;/∗ edgetype ∗/
Pfloatwidth;/∗ edgewidth scale factor ∗/
Pgcolrcolr;/∗ edge colour ∗/
} Pedge_bundle_plus;

Pedge_flag is defined as:

typedef enum {
PEDGE_OFF,
PEDGE_ON
} Pedge_flag;

The edge type values 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;

Execution

In the edge bundle table of the workstation state list, the given index is associated with the specified parameters.

The edgewidth scale factor is a scale factor applied to nominal edgewidth. During structure traversal, the edgewidth scale factor is multiplied by the nominal edgewidth on a workstation. The result is mapped by the workstation to the nearest available edgewidth.

Edge colour is a general colour, either an indirect or a direct colour in a specified colour model. If an indirect colour is specified and the specified colour index is not available during structure traversal, then colour index one is used.

The extended edge bundle table in the workstation state list has predefined entries taken from the workstation description table. A number of these entries are predefined for every workstation of category OUTPUT or OUTIN. Any table entry, including the predefined entries, may be redefined with this function.

When area defining primitives are displayed during structure traversal, the current edge index in the PHIGS traversal state list refers to an entry in the extended edge bundle table. If the current edge index is not present in the extended edge bundle table, then edge index one is used. The setting of the corresponding Aspect Source Flags(ASFs) determines which aspects in the entry are used.

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

107Ignoring function, the specified edgetype 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

Museum