pset_line_rep(3g) — Subroutines

Name

pset_line_rep − Defines the attributes of a polyline representation.

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

Syntax

void pset_line_rep (
Pint                  wsid,    /∗ (I) Workstation identifier ∗/
Pint                  index,   /∗ (I) Polyline index ∗/
const Pline_bundle   ∗rep      /∗ (I) Polyline representation ∗/
)

Data Structures

typedef struct {
    Pint      type;      /∗ line type ∗/
    Pfloat    width;     /∗ line width scale factor ∗/
    Pint      colr_ind; /∗ color index ∗/
} Pline_bundle;

Constants

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

Other, nonstandard line types are available. See Constants.

Description

pset_line_rep associates the polyline index with the line type, line width scale factor, and polyline color index values in the polyline bundle table on the workstation specified by the workstation identifier. A call to this function allows you to create or redefine an entry for the workstation polyline 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.

During structure traversal, the following occurs:

•When Digital PHIGS displays polyline and polyline 3 primitives, the current polyline index entry in the PHIGS traversal state list refers to an entry in the polyline bundle table.

•If Digital PHIGS cannot find the current polyline index value in the polyline bundle table on the specified workstation, it uses polyline index value 1.

•Digital PHIGS binds aspects to the primitives, as directed by the values of the corresponding ASFs (BUNDLED or INDIVIDUAL).