POLYLINE SET 3

PXPOLYLINE_SET3

CALL SEQUENCE

void pxpolyline_set3 (

Ppoint_list_list3	*lines	/*list of polylines, specified in MC	*/

)

EFFECT

Depending on the edit mode, a Polyline Set 3 element is inserted into the open structure after the current element or replaces the current element. The newly inserted element becomes the current element.

At structure traversal time, each polyline in the set is rendered by sequentially connecting the points with straight lines, starting from the first point and ending with the last point of the polyline. The polylines are rendered using the current polyline attributes.

Polyline attributes and their corresponding ASFs (aspect source flags) are:

Polyline attributes are taken from:

• the PHIGS state list if the corresponding ASFs are Individual, and the structure is non-retained
• the traversal state list if the corresponding ASFs are Individual, and the structure is retained
• the workstation bundle table if the corresponding ASFs are Bundled.

The polyline bundle index specifies which workstation polyline bundle is used.

For further information on specifying polyline attributes, see the references.

Performance Considerations

Polyline sets are useful because GPHIGS can process them more quickly than the equivalent number of separate polylines. They are stored in the structure database more quickly, and they are rendered more quickly. If you have several small polylines which all have the same attributes, it is more efficient to specify them as a polyline set.

Degenerate Polylines and Polyline Sets

A polyline set with zero or fewer polylines is inserted into the open structure but not displayed. A polyline with fewer than two vertices is not displayed.

ERRORS

5

Ignoring function, function requires either the state STNOP or the state STOP.

SEE ALSO

Line type, see pset_linetype

Line width scale factor, see pset_linewidth

Polyline, see ppolyline, ppolyline3

Polyline set, see pxpolyline_set

Polyline bundle definition, see pset_line_rep, pset_line_rep_plus

Polyline bundle index, see pset_line_ind

Polyline color, see pset_line_colr, pset_line_colr_ind

Polyline extension, see pxcircular_arc

Inquire polyline bundle definition, see pinq_line_rep, pinq_line_rep_plus

Inquire polyline bundle index, see pinq_list_line_inds

Inquire polyline facilities, see pinq_line_facs