GPHIGS F77 FUNCTIONS - QUADRILATERAL MESH 3 WITH DATA

QUADRILATERAL MESH 3 WITH DATA

PQM3D

CALL SEQUENCE

CALL PQM3D	(FFLAG, EFLAG, VFLAG, CTYPE, NCC, NC, NR, FCOLI, FCOLR, FNXA, FNYA, FNZA, FDLEN, FDATA, 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,PFND,PFCND)
INTEGER EFLAG: Data per edge data flag (PENO,PEVF)
INTEGER VFLAG: Data per vertex data flag
: (PCD,PCDC,PCDN,PCDD,PCDCN,PCDCD,PCDND,PCDCND)
INTEGER CTYPE: Colour type
INTEGER NCC: Number of components of colour value
INTEGER NC,NR: Number of columns, number of rows
INTEGER FCOLI((NP-1)*(NR-1)): Facet colour indices
REAL FCOLR(NCC*(NC-1)*(NR-1)): Facet colour values
REAL FNXA((NC-1)*(NR-1))
REAL FNYA((NC-1)*(NR-1)),
REAL FNZA((NC-1)*(NR-1)): Facet normal data (MC)
INTEGER FDLEN: Length of application-specific data list per facet
REAL FDATA
(FDLEN*(NC-1)*(NR-1)): Facet application-specific data
INTEGER EDATA (2*NC*NR): Edge data
REAL PXA(NC*NR)
REAL PYA(NC*NR)
REAL PZA(NC*NR): Coordinates of points (MC)
INTEGER VCOLI (NC*NR): Vertex colour indices
REAL VCOLR(NCC*NC*NR): Vertex colour values
REAL VNXA(NC*NR)
REAL VNYA(NC*NR)
REAL VNZA(NC*NR): Vertex normal data (MC)
INTEGER VDLEN: Length of application-specific data list per vertex
REAL VDATA (VDLEN*NC*NR): Vertex application-specific data

PHIGS STATE

(PHOP,*,STOP,*)

EFFECT

This function specifies the 3D characteristics of the quadrilateral mesh with data primitive .

The QUADRILATERAL MESH 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 QUADRILATERAL MESH 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 mesh of (M -1) x (N -1) connected quadrilaterals is generated, where the mesh is defined by a two-dimensional M x N array of vertex data, The data in each set of four neighbouring array elements defines a quadrilateral. The current values of the quadrilateral mesh 3 with data attributes specified in and stored in the traversal state list are bound to the primitive.

The set of quadrilaterals need not be coplanar. Individual quadrilaterals in the mesh may be non-planar, in which case they are rendered in a workstation dependent way that preserves the edges and ensures that the displayed geometry of the primitive is invariant under transformation. The method used to generate and/or decompose the quadrilateral mesh is workstation dependent.

A QUADRILATERAL MESH 3 WITH DATA element containing less than two vertex data elements in either array dimension will be placed in the open structure. When such an element is interpreted it will have no visual effect.

The array of edge visibility flags consists of a flag for each edge of the quadrilateral mesh. The edge visibility flags, if specified, are arranged in a three-dimensional M x N x 2 array. For i ranging from 1 to M, and j ranging from 1 to N, the (i,j,1) array element specifies the edge flag for the edge between the vertices i, j and i + 1, j, and the (i, j, 2) array element specifies the edge flag for the edge between the vertices i, j and i, j + 1. For those array elements corresponding to i > M or j + 1 > N the edge flag entry in the array is not used. If edge visibility flags are specified, an edge will only be displayed when the edge flag aspect is ON.

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 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