FILL AREA SET 3 WITH DATA

PFAS3D

CALL PFAS3D	(FFLAG, EFLAG, VFLAG, CTYPE, NCC, FCOLI, FCOLR, FNXA, FNYA, FNZA, FDLEN, FDATA, NPL, IXA, EDATA, PXA, PYA, PZA, VCOLI, VCOLR, VNXA, VNYA, VNZA, VDLEN, VDATA)

INPUT PARAMETERS

INTEGER FFLAG

Data per facet data flag

(PFNO,PFC,PFN,PFD,PFCN,PFCD,PFCD,PCDND,PFCND)

INTEGER EFLAG

Data per edge data flag

(PENO,PEVF)

INTEGER VFLAG

Data per vertex data flag

(PCD,PCDC,PCDN,PCDD,PCDCN,PCDND,PCDCND)

INTEGER CTYPE

Colour type

INTEGER NCC

Number of components of colour value

INTEGER FCOLI

Facet colour index

REAL FCOLR (NCC)

Facet colour values

REAL FNXA,FNYA,FNZA

Facet normal data (MC)

INTEGER FDLEN

Length of application-specific data list per facet

REAL FDATA (FDLEN)

Facet application-specific data

INTEGER NPL

Number of points lists

INTEGER IXA(NPL)

Array of end indices for point lists

INTEGER EDATA (IXA(NPL))

Edge data

REAL PXA (IXA(NPL))

REAL PYA(IXA(NPL))

REAL PZA(IXA(NPL))

Coordinates of points(MC)

INTEGER VCOLI(IXA(NPL))

Vertex colour indices

REAL VCOLR (NCC*IXA(NPL))

Vertex colour values

REAL VNXA(IXA(NPL))

REAL VNYA(IXA(NPL))

REAL VNZA(IXA(NPL))

Vertex normal data (MC)

INTEGER VDLEN

Length of application-specific data list per vertex

REAL VDATA(VDLEN*IXA(NPL))

Vertex application-specific data

PHIGS STATE

EFFECT

This function specifies the 3D characteristics of the fill area set with data function.

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

When an element of this type is interpreted, a set of polygonal areas made up of a collection of subareas is generated. A subarea is defined by a single list of vertex data. Each subarea is implicitly closed. The current values of the fill area set 3 with data attributes specified in and stored in the traversal state list are bound to the primitive.

A fill area set 3 with data element containing no lists of vertex data or one or more subareas with less than three vertices will be placed in the open structure. When such an element is encountered it will have no visual effect. A fill area set 3 with data element containing non-coplanar vertex coordinates is treated in an workstation dependent manner.

The lists of edge visibility flags consist of a flag for each edge of the fill area set. If edge visibility flags are specified there must be as many lists of edge visibility flags as there are lists of vertices, and corresponding lists must have the same length. Hence, the first entry of the first list of edge visibility flags corresponds to the edge between the first two vertices of the first vertex list. The last entry of each list of edge visibility flags corresponds to the edge from the last vertex of the corresponding vertex list to the first vertex of that list. If edge visibility flags are specified, an edge will only be displayed when the edge flag aspect is ON.

Attributes associated with Fill Area Set 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 NRS mode, 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.

ERRORS

5

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

513

Ignoring function, inconsistent edge flag specification

SEE ALSO

open structure, open pipe (ext), set interior index, set interior style, set interior style index, set interior colour, set interior colour index, set edge flag, set edgetype, set edgewidth scale factor, set edge colour, set edge colour index, fill area set with data, fill area set 3, inquire current element content, inquire current element type and size, set data mapping representation