Name

pe_polyline_set3 − Generates a set of unconnected 3D polylines. 

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

Syntax

void pe_polyline_set3 (
  const Pvertex3_set  ∗vertex_data  /∗ (I) List of the vertex list.
                                           Digital PHIGS ignores everything
                                           but the points. ∗/
)

Data Structures

typedef struct {
    Pint             num_lists;  /∗ number of vertex lists ∗/
    Pvertex3_list   ∗vertices;   /∗ list of vertex lists ∗/
} Pvertex3_set;
    typedef struct {
        Pint         num_vertices;        /∗ number of vertices ∗/
        Pint         num_data_per_vertex; /∗ number of data values per
                                             vertex ∗/
        Ppoint3     ∗vertex_points;       /∗ list of vertex points ∗/
        Pcolrv_ptr   vertex_colrvs;       /∗ ignored by Digital PHIGS ∗/
        Pvec3       ∗vertex_norms;        /∗ ignored by Digital PHIGS ∗/
        Pfloat      ∗vertex_data;         /∗ ignored by Digital PHIGS ∗/
    } Pvertex3_list;
        typedef struct {
            Pfloat     x;    /∗ x coordinate ∗/
            Pfloat     y;    /∗ y coordinate ∗/
            Pfloat     z;    /∗ z coordinate ∗/
        } Ppoint3;
        typedef union {
            Pint           ∗colr_inds;  /∗ pointer to color indexes ∗/
            Pcolr_rep_ptr   colr_reps;  /∗ pointer to color
                                           representations ∗/
        } Pcolrv_ptr;
            typedef union {
                Prgb       ∗rgb;       /∗ pointer to RGB color values ∗/
                Pcieluv    ∗cieluv;    /∗ pointer to CIELUV color values ∗/
                Phls       ∗hls;       /∗ pointer to HLS color values ∗/
                Phsv       ∗hsv;       /∗ pointer to HSV color values ∗/
                Pdata      ∗unsupp;    /∗ pointer to unsupported color
                                          values ∗/
            } Pcolr_rep_ptr;
                typedef struct {
                    Pfloat    red;     /∗ red intensity   ∗/
                    Pfloat    green;   /∗ green intensity ∗/
                    Pfloat    blue;    /∗ blue intensity  ∗/
                } Prgb;
                typedef struct {
                    Pfloat    cieluv_x;      /∗ x coefficient ∗/
                    Pfloat    cieluv_y;      /∗ y coefficient ∗/
                    Pfloat    cieluv_y_lum;  /∗ y luminance ∗/
                } Pcieluv;
                typedef struct {
                    Pfloat    hue;        /∗ hue ∗/
                    Pfloat    lightness;  /∗ lightness ∗/
                    Pfloat    satur;      /∗ saturation ∗/
                } Phls;
                typedef struct {
                    Pfloat    hue;    /∗ hue ∗/
                    Pfloat    satur;  /∗ saturation ∗/
                    Pfloat    value;  /∗ value ∗/
                } Phsv;
                typedef struct {
                    size_t   size;   /∗ size of data ∗/
                    void    ∗data;   /∗ pointer to the data ∗/
                } Pdata;
        typedef struct {
            Pfloat   delta_x;   /∗ delta x value ∗/
            Pfloat   delta_y;   /∗ delta y value ∗/
            Pfloat   delta_z;   /∗ delta z value ∗/
        } Pvec3;

Description

pe_polyline_set3 generates an unconnected set of sequences of connected straight lines. 

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 set 3 element. 

A point sequence with fewer than two points is considered degenerate and is treated in an implementation-dependent manner. 

During structure traversal, Digital PHIGS generates an unconnected set of sequences of connected straight lines, starting from the first vertex coordinate point of each sequence and ending at the last vertex coordinate point for each sequence. 

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

Digital PHIGS Version 4.1 does not support this function.

See Also

padd_names_set
pinq_line_facs
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_rend_colr_model
pset_view_ind