The IDLgrTessellator::Tessellate function method performs the actual tessellation.

Syntax


Result = Obj->[IDLgrTessellator::]Tessellate( Vertices, Poly [, AUXDATA=variable] [, /QUIET] )

Return Value


Returns 1, and the contents of Vertices and Poly are set to the results of the tessellation. Returns 0 if tessellation fails.

Arguments


If the tessellation succeeds, IDLgrTessellator::Tessellate returns 1 and the contents of Vertices and Poly are set to the results of the tessellation. If the tessellation fails, the function returns 0.

Vertices

A 2x n array if all the input polygons were 2-D. A 3x n array if all the input polygons were 3-D.

Poly

An array of polygon descriptions. A polygon description is an integer or long word array of the form: [n, i0, i1, ..., in-1], where n is the number of vertices that define the polygon, and i0..in-1 are indices into the X, Y, and Z arguments that represent the polygon vertices.

Note: On output, the Vertices array can be used as the value of the DATA property, and the Poly array can be used as the value of the POLYGON property, of an IDLgrPolygon object.

Keywords


AUXDATA

Set this keyword to a named variable that receives the auxiliary data associated with each vertex returned in the Vertices argument. The data is an [m, n] array where m is the number of per-vertex auxiliary data items specified in the call(s) to the AddPolygon method, and n is the number of vertices returned in the Vertices argument. The type of the returned auxiliary data is the same as the type of the data supplied with the AUXDATA keyword in the last call to AddPolygon.

QUIET

Set this keyword to suppress warning and error message generation due to tessellation errors. !ERROR_STATE is not updated in the case of the return value being ‘0’ when the QUIET keyword is specified.

Version History


5.0

Introduced

5.6

Added AUXDATA keyword