Name

ppolyline3 − Draws the 3D form of a straight line. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

void ppolyline3 (
  const Ppoint_list3  ∗points   /∗ (I) List of points ∗/
)

Data Structures

typedef struct {
    Pint       num_points;   /∗ number of Ppoint3s in the list ∗/
    Ppoint3   ∗points;       /∗ list of points ∗/
} Ppoint_list3;
    typedef struct {
        Pfloat    x;    /∗ x coordinate ∗/
        Pfloat    y;    /∗ y coordinate ∗/
        Pfloat    z;    /∗ z coordinate ∗/
    } Ppoint3;

Description

ppolyline3 draws the three-dimensional form of a straight line by connecting the modeling coordinate points in the list of points. 

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new polyline 3 element. 

By default, the function generates a solid line of nominal width and in the foreground color dictated by the workstation.  You use the polyline attribute 3 functions to change these default attributes. 

The ppolyline3 function specifies the three-dimensional (x, y, and z) form of the polyline primitive.  A call to the function has the following effects during structure traversal:

•Digital PHIGS generates a straight line by connecting the specified points, starting with the first point and ending with the last point in the list. 

•Digital PHIGS binds the current values of the polyline 3 attributes, as defined in the PHIGS traversal state list, to the polyline primitive. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

padd_names_set
pinq_line_facs
ppolyline
ppolyline_set3_colr
premove_names_set
pset_depth_cue_ind
pset_hlhsr_id
pset_indiv_asf
pset_linetype
pset_linewidth
pset_pick_id
pset_line_colr
pset_line_colr_ind
pset_line_ind
pset_line_shad_method
pset_view_ind