MESH Function

Reference Guide > M–N Routines > MESH Function

MESH Function

Defines a polygonal mesh object that can be used by the RENDER function.

Usage

result = MESH(vertex_list, polygon_list)

Input Parameters

vertex_list—A double-precision floating-point array of 3D points; the array's size is 3 * number_of_vertices.

polygon_list—A longword integer 1D array defining the polygons; the array's size is number_of_polygons * number_of_edges.

For more information on these two parameters, see the PV‑WAVE User’s Guide.

Returned Value

result—A structure that defines an object consisting of multiple polygons.

Keywords

Color—A 256-element double-precision floating-point vector containing the color (intensity) coefficients of the object. The default is Color(*)=1.0. For more information, see the PV‑WAVE User’s Guide.

Kamb—A 256-element double-precision floating-point vector containing the ambient (flat shaded) coefficients. The default is Kamb(*)=0.0. For more information, see the PV‑WAVE User’s Guide.

Kdiff—A 256-element double-precision floating-point vector containing the diffuse reflectance coefficients. The default is Kdiff(*)=1.0. For more information, see the PV‑WAVE User’s Guide.

Ktran—A 256-element double-precision floating-point vector containing the specular transmission coefficients. The default is Ktran(*)=0.0. For more information, see the PV‑WAVE User’s Guide.

Materials—A byte array of size number_of_polygons defining the materials list. The purpose of this keyword is similar to that of the Decal keyword for quadric objects. Its use permits the specification of properties for each polygon where each polygon specifies an index into the Color, Kamb, Kdiff, and Ktran property arrays.

For more information, see the PV‑WAVE User’s Guide.

Transform—A 4-by-4 double-precision floating-point array containing the local transformation matrix whose default is the identity matrix. For more information, see the PV‑WAVE User’s Guide.

Discussion

MESH can be used by the RENDER function to render collections of 3D polygons, such as iso-surfaces, or spatial-structural data.

note	Any non-coplanar polygons in a mesh are automatically reduced to triangles by RENDER.

The Transform keyword can be specified to alter the scaling, as well as the orientation and position of the polygons defined by MESH.

Examples

vertices = [[-1.0, -1.0, 1.0],$

           [-1.0,  1.0,  1.0],$

           [ 1.0, 1.0, 1.0],$

           [ 1.0, -1.0, 1.0],$

           [-1.0, -1.0, -1.0],$

           [-1.0, 1.0, -1.0],$

           [ 1.0, 1.0, -1.0],$

           [ 1.0, -1.0, -1.0]]

polygons = [4, 0, 1, 2, 3,$

            4, 4, 5, 1, 0,$

            4, 2, 1, 5, 6,$

            4, 2, 6, 7, 3,$

            4, 0, 3, 7, 4,$

            4, 7, 6, 5, 4]

T3D, /Reset, Rotate=[15, 30, 45]

cube = MESH(vertices, polygons, Transform=!P.T)

WINDOW, Xsize=256, Ysize=256

TV, RENDER(cube)