Name

ppolyline − Draws the 2D form of a straight line. 

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

Syntax

void ppolyline (
  const Ppoint_list   ∗points   /∗ (I) List of points ∗/
)

Data Structures

typedef struct {
    Pint       num_points;   /∗ number of Ppoints in the list ∗/
    Ppoint    ∗points;       /∗ list of points ∗/
} Ppoint_list;
    typedef struct {
        Pfloat    x;    /∗ x coordinate ∗/
        Pfloat    y;    /∗ y coordinate ∗/
    } Ppoint;

Description

ppolyline draws the two-dimensional form of a straight line by connecting the modeling coordinate points in the list of points.  Its z-coordinate value is 0. 

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 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 functions to change these default attributes. 

The ppolyline function specifies the two-dimensional (x and y) 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 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
ppolyline3
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