GPHIGS C FUNCTIONS - FILL AREA SET

FILL AREA SET

PFILL_AREA_SET

CALL SEQUENCE

void pfill_area_set(

const Ppoint_list_list	*point_list_list	/* list of point lists	*/

TYPES

typedef struct {
	Pint	num_point_lists;	/* number of point lists	*/
	Ppoint_list	*point_lists;	/* list of point lists	*/
} Ppoint_list_list;

typedef struct {
	Pint	num_points;	/* number of Ppoint in the list	*/
	Ppoint	*points;	/* list of points	*/
} Ppoint_list;

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
} Ppoint;

PHIGS STATE

(PHOP, *, STOP, *).

EFFECT

This function restricts the 3D fill area set function to 2D (x, y). The z coordinate is set to 0.

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

A set of closed polygons is generated when this function is interpreted. These polygons must be coplanar. The current attributes of the fill area set (interior and edge), defined in the PHIGS traversal state list are applied to the primitive. The FILL AREA SET function containing a polygon with less than three edges or where the points list is empty, will be stored in the open structure but will not have a visual effect when interpreted. The fill area set edges are not necessarily displayed. The existence or appearance of the edges is controlled by the attributes.

The filling rule of intersecting subpolygons is device dependent. See the GPHIGS user guide for more details on polygons with holes.

Attributes associated with Fill Area Set:

INTERIOR STYLE

INTERIOR STYLE INDEX

INTERIOR COLOUR

EDGE FLAG

EDGE TYPE

EDGE WIDTH SCALE FACTOR

EDGE 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,*)