pset_edge_rep(3g) — Subroutines

Name

pset_edge_rep − Defines the attributes of an edge representation.

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void pset_edge_rep (
Pint                  wsid,   /∗ (I) Workstation identifier ∗/
Pint                  index, /∗ (I) Edge bundle index ∗/
const Pedge_bundle   ∗rep     /∗ (I) Edge representation ∗/
)

Data Structures

typedef struct {
    Pedge_flag   flag;       /∗ edge flag ∗/
    Pint         type;       /∗ edge type ∗/
    Pfloat       width;      /∗ edge width scale factor ∗/
    Pint         colr_ind;   /∗ edge color index ∗/
} Pedge_bundle;
    typedef enum {
        PEDGE_OFF,   /∗ Edges off. This is the default value. ∗/
        PEDGE_ON     /∗ Edges on. ∗/
    } Pedge_flag;

Constants

Data Structure Constants Constant          Description
---------------------------------------------------------------------------
Edge types                PLINE_SOLID       Solid edge. This is the
                                            default value.
                          PLINE_DASH        Dashed edge.
                          PLINE_DOT         Dotted edge.
                          PLINE_DOTDASH     Dashed-dotted edge.
---------------------------------------------------------------------------

Other, nonstandard edge types are available. See Constants.

Description

pset_edge_rep associates the edge index with the edge flag, edge type, edge width scale factor, and edge color index values in the edge bundle table. This table is in the workstation state list of the workstation specified by the workstation identifier.

This function allows you to create or redefine an entry for the workstation edge bundle table. To determine the predefined bundle table entries, which are provided for all workstations of type OUTPUT and OUTIN, and which are derived from the workstation description table, run the program phigs_predef.

The function associates the specified edge index value with the other specified values of edge flag, edge type, edge width scale factor, and edge color index, as described in the following table, to form a table entry:

Argument       Description
--------------------------------------------------------------------------
Edge flag      Enables or disables the ability to draw edges when
               Digital PHIGS displays a fill area set or fill area set 3
               primitive. The specified value can be OFF or ON. When
               the value is OFF, Digital PHIGS does not use the edge
               aspects associated with the specified index; it draws
               the fill area set with only the relevant interior style.
               When the value is ON, Digital PHIGS displays the edge
               aspects defined in the edge representation.
               The edge, or boundary, has higher precedent than the
               interior of the fill area set. However, because the
               boundary drawn for the interior style HOLLOW is
               considered to be part of the interior style, the HOLLOW
               boundary may not be visible when Digital PHIGS draws an
               edge.
Edge types     Specifies the line type Digital PHIGS uses to draw the edge
               (solid, dashed, and so on).
Edge width     Specifies the scale factor to be applied to the
scale factor   workstation’s nominal edge width. Digital PHIGS maps the
               resulting value to the closest value available on the
               workstation.
Edge color     Provides an index into the color table on the specified
index          workstation. Digital PHIGS uses the index value 1 if the
               requested edge color index is not available on the
               workstation.
--------------------------------------------------------------------------

During structure traversal, the following occurs:

•The current edge index in the PHIGS traversal list refers to an entry in the edge bundle table. The values of the corresponding ASFs determine which of the aspects in the entry Digital PHIGS uses.

•Only the magnitude of the edge width scale factor is considered. Digital PHIGS applies the absolute value of the edge width scale factor to the nominal edge width on a workstation. The workstation maps the result to the nearest available edge width.

•If the color entry associated with the edge color index is not defined, Digital PHIGS uses the color values of entry 1.

•If the current edge index in the traversal state list is not present in the edge bundle table, Digital PHIGS uses edge index 1.