PSEDR(3g) — Subroutines

Name

PSEDR − Defines the attributes of an edge representation.

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

Syntax

PSEDR (WKID, EDI, EDFLAG, EDTYPE, EWIDTH, COLI)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
WKID           Integer        Read       Workstation identifier
EDI            Integer        Read       Edge bundle index
EDFLAG         Integer        Read       Edge flag
EDTYPE         Integer        Read       Edge type
EWIDTH         Real           Read       Edge width scale factor
COLI           Integer        Read       Color index
---------------------------------------------------------------------------

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
EDFLAG                POFF          Edges off. This is the default
                                    value.
                      PON           Edges on.
EDTYPE                PLSOLI        Solid edge. This is the default
                                    value.
                      PLDASH        Dashed edge.
                      PLDOT         Dotted edge.
                      PLDASD        Dashed-dotted edge.
---------------------------------------------------------------------------

Other, nonstandard, edge types are available. See Constants.

Description

PSEDR 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.

Museum

PSEDR(3g) — Subroutines

Name

Syntax

Constants

Description

See Also