SET EXTENDED EDGE REPRESENTATION(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

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

SYNOPSIS

C Syntax

void
psetextedgerep ( wsid, index, rep )
Pintwsid;workstation identifier
Pintindex;edge bundle index number
Pextedgebundl∗rep;pointer to extended edge representation

FORTRAN Syntax

SUBROUTINE pseer ( WKID, INDEX, EFLAG, ETYPE, EWIDTH, COLMOD, IECOLR, ECOLR )
INTEGERWKIDworkstation identifier
INTEGERINDEXedge bundle index
INTEGEREFLAGedge flag (PON/POFF)
INTEGERETYPEedge type
REALEWIDTHedge width scale factor
INTEGERCOLMODcolour model
INTEGERIECOLRindirect colour index
REALECOLR(3)direct colour value

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

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

This is a SunPHIGS Extension function based on PHIGS+ and is not part of the PHIGS standard.

C Input Parameters

All of the following data types are predefined in phigs.h.

wsidThe identifier of the workstation.

indexThis is an index to the workstation edge bundle table.

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

typedef struct {
Pedgefflag;/∗ edge flag ∗/
Pinttype;/∗ edgetype ∗/
Pfloatscale;/∗ edgewidth scale factor ∗/
Pgcolrcolour;/∗ edge colour ∗/
} Pextedgebundl;

Pedgef is defined as:

typedef enum {
PEDGE_OFF,
PEDGE_ON
} Pedgef;
The edge type values are:
1PLN_SOLIDSolid
2PLN_DASHDashed
3PLN_DOT Dotted
4PLN_DOTDASHDot-dashed
0PLN_LONGDASHLong-dashed
-1PLN_DOTDASHDOTDot-dashed-dot-dotted
-2PLN_CENTERCenter (long-short dashed)
-3PLN_PHANTOMPhantom (long-short-short dashed)

Pgcolr is defined as:

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

FORTRAN Input Parameters

All of the following data types are predefined in phigs77.h.

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

INDEX
The index into the specified workstation edge bundle table.

EFLAG
The edge flag. Predefined values are:

0POFF
1PON

ETYPE
The edge type. Predefined values are:

1PLSOLISolid
2PLDASHDashed
3PLDOTDotted
4PLDASDDot-dashed
0PLNLONGDASHLong-dashed
-1PLNDOTDASHDOTDot-dashed-dot-dotted
-2PLNCENTERCenter (long-short dashed)
-3PLNPHANTOMPhantom (long-short-short dashed)

EWIDTH
The edge width scale factor.

COLMOD
The colour model which determines the type of colour to be used. The valid values for COLMOD are:

0PINDIRColour Index Specified
1PRGBRed, Green, and Blue
2PCIECIE Colour Model
3PHSVHue, Saturation, and Value
4PHLSHue, Lightness, and Saturation

IECOLR
An integer index into the workstation colour table for determining the edge colour. This value is only used if COLMOD is equal to PINDIR.

ECOLR(3)
An array of reals containing the edge colour. This array is not used if COLMOD is equal to PINDIR.

ECOLR(1) = Red, Hue, etc.
ECOLR(2) = Green, Saturation, Lightness, etc.
ECOLR(3) = Blue, Value, Saturation, etc.

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 (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

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