MESH Function

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

result = MESH(vertex_list, polygon_list)

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 Vertex Lists and Polygon Lists in Chapter 7 of the PV-WAVE User's Guide.

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

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 section Defining Color and Shading in Chapter 7 of 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 section Ambient Component in Chapter 7 of 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 section Diffuse Component in Chapter 7 of 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 section Transmission Component in Chapter 7 of 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 Defining Object Material Properties in Chapter 7 of 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 section Setting Object and View Transformations in Chapter 7 of the PV-WAVE User's Guide.

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

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

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)
TV, RENDER(cube)

CONE, CYLINDER, RENDER, SPHERE, VOLUME

For more information, see Ray-tracing in Chapter 7 of the PV-WAVE User's Guide.