POLYMARKER 3

PPOLYMARKER3

CALL SEQUENCE

void ppolymarker3(

const Ppoint_list3	*point_list	/* array of points	*/

)

TYPES

typedef struct {
	Pint	num_points;	/* number of Ppoint3s in the list	*/
	Ppoint3	*points;	/* list of points	*/
} Ppoint_list3;

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
	Pfloat 	z;	/* z coordinate	*/
} Ppoint3;

PHIGS STATE

EFFECT

This function specifies the 3D geometrical characteristics of the polymarker primitive.

The POLYMARKER 3 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 POLYMARKER 3 structure element. The values specified in the function are associated with the element.

When an element of this type is interpreted, a series of symbols is drawn at the coordinates of the points. The current polymarker attributes defined in the PHIGS traversal state list are applied to the polymarker.

Attributes associated with Polymarker:

MARKER TYPE

MARKER SIZE SCALE FACTOR

POLYMARKER 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 on 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,*)

SEE ALSO

open structure, open pipe (ext), begin non duplicate data storage (ext), set polymarker index, set marker type, set marker size scale factor, set polymarker colour, set polymarker colour index, polymarker, inquire current element content, inquire current element type and size