GPHIGS C FUNCTIONS - QUADRILATERAL MESH WITH DATA

QUADRILATERAL MESH WITH DATA

PQUAD_MESH_DATA

CALL SEQUENCE

void pquad_mesh_data (

Pint	colr_type,	/* colour type	*/
const Pfacet_array	*facet_data,	/* array of facet data (optional)	*/
const Pedge_flag_array	*edge_flags,	/* array of edge flags (optional)	*/
const Pvertex_array	*vertex_data	/* array of vertex data	*/

TYPES

typedef struct {
	Pint_size	dims;	/* facet array dimensions	*/
	Pint	num_data_per_facet;	/* number of data values per facet	*/
	Pcolrv_ptr	facet_colrvs;	/* array of facet colour values	*/
	Pvec3	*facet_norms;	/* array of facet normals	*/
	Pfloat	*facet_data;	/* array of facet data lists	*/
} Pfacet_array;

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;

typedef struct {
	Pint_size	dims;	/* edge flag array dimensions	*/
	Pedge_flag_pair	*edge_flags;	/* array of edge flag pairs	*/
} Pedge_flag_array;

typedef Pedge_flag Pedge_flag_pair[2];

typedef enum {
	PEDGE_OFF,
	PEDGE_ON
} Pedge_flag;

typedef struct {
	Pint_size	dims;	/* dimensions of vertex array	*/
	Pint	num_data_per_vertex;	/* number of data values per vertex	*/
	Ppoint	*vertex_points;	/* array of vertex points	*/
	Pcolrv_ptr	vertex_colrvs;	/* array of vertex colours	*/
	Pvec3	*vertex_norms;	/* array of vertex normals	*/
	Pfloat	*vertex_data;	/* array of vertex data lists	*/
} Pvertex_array;

PHIGS STATE

(PHOP,*,STOP,*)

EFFECT

This function restricts the 3D quadrilateral mesh with data function to 2D (x, y). The z coordinate is set to 0.

The QUADRILATERAL MESH WITH DATA 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 QUADRILATERAL MESH WITH DATA structure element. The values specified in the function are associated with the element.

A NULL value for the facet_data or edge_flags parameters indicates the corresponding optional data is not supplied.

Attributes associated with Quadrilateral Mesh With Data:

INTERIOR STYLE

INTERIOR STYLE INDEX

INTERIOR COLOUR

EDGE FLAG

EDGE TYPE

EDGE WIDTH SCALE FACTOR

EDGE COLOUR

DATA MAPPING METHOD

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,*)
513: Ignoring function, inconsistent edge flag specification