GPHIGS C FUNCTIONS - POLYLINE SET 3 WITH COLOUR

POLYLINE SET 3 WITH COLOUR

PPOLYLINE_SET3_COLR

CALL SEQUENCE

void ppolyline_set3_colr (

Pint	colr_type	/* colour type	*/
const Pvertex3_set	*vertex_data	/* list of vertex lists	*/

TYPES

#define	PCOLR_INDIRECT	0
#define	PCOLR_RGB	1
#define	PCOLR_CIELUV	2
#define	PCOLR_HSV	3
#define	PCOLR_HLS	4

typedef struct {
	Pint	num_lists;	/* number of vertex list 	*/
	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;	/* list of vertex colours	*/
	Pvec3	*vertex_norms;	/* list of vertex normals	*/
	Pfloat	*vertex_data;	/* list of vertex data lists	*/
} Pvertex3_list;

typedef union {
	Pint	*color_inds;	/* pointer to colour indices	*/
	Pcolr_rep_ptr	colr_reps;	/* pointer to colour representations	*/
} Pcolrv_ptr;

typedef union {
	Prgb	*rgb;	/* pointer to RGB colour values	*/
	Pcieluv	*cieluv;	/* pointer to CIELUV colour values	*/
	Phls	*hls;	/* pointer to HLS colour values	*/
	Phsv	*hsv;	/* pointer to HSV colour values	*/
} Pcolr_rep_ptr;

PHIGS STATE

(PHOP,*,STOP,*)

EFFECT

This function specifies the geometrical characteristics of the polyline set with colour primitive.

The POLYLINE SET 3 WITH COLOUR element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on the edit mode value. Element pointer is updated and points to the POLYLINE SET 3 WITH COLOUR structure element. The values specified in the function are associated with the element.

When an element of this type is interpreted, an unconnected set of polylines is generated. One polyline is defined by each list of vertex data. The current values of the polyline set 3 with colour attributes specified in and stored in the traversal state list are bound to the primitive. Colours can be specified for each vertex. Others data are ignored. When colours are specified, if polyline shading method is NONE, each polyline segment is drawn using the colour of the first vertex of the segment. If polyline shading is COLOUR, a colour interpolation is realized.

A POLYLINE SET 3 WITH COLOUR element containing no vertex points will be placed in the open structure. When such an element is interpreted it will have no visual effect. A polyline set 3 with data primitive containing one or more vertex data lists with less than two vertices will be placed in the open structure. When such an element is interpreted the lists with insufficient data will have no visual effect.

Attributes associated with Polyline With Colour:

LINETYPE

LINEWIDTH SCALE FACTOR

POLYLINE COLOUR

EXTENSION TO THE PHIGS STANDARD

If used in one of the two GPHIGS specific modes NRS or NDDS, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

In NDDS mode, (see BEGIN NON DUPLICATE DATA STORE), the element is stored in the structure but its content is not copied into the CSS. GPHIGS stores only the pointer to the user's data.

See GPHIGS user guide for more details on NRS and NDDS modes.

ERRORS

5: Ignoring function, function requires state (PHOP,*, STOP,*)