Synopsis
Creates a set of contour regions and maps texture patterns onto them.
Input Ports
Parameters
Output Ports
Description
The contour_texture module creates a set of contour regions and maps textures onto them.The module computes the contour regions as uniformly spaced values, based on the values of the number of contours, min level, and max level parameters. If the input mesh is 2D, the contour regions are isovolumes bounded by two isolines; if the mesh is 3D, the regions are isovolumes bounded by two isosurfaces.
The module applies the input images to the contours on a one-to-one basis; that is, it applies the first (0th) image to the first contour, the second image to the second contour, and so forth. (Note that the in_images[] array is indexed beginning with 0.)
By default, the module creates as many contour regions as there are images in the in_image[] array; however, the number of contour regions to be created can be set manually. If c represents the number of contour regions and i represents the number of input images, then:
If there are more contour regions than input images, the images are applied to the first i contour regions and the remaining contour regions are white.
If there are more input images than contour regions, only the first c images are applied to the contours.
Note: The contour_texture module does not generate vertex normals by default. For more details, Vertex normal generation.
Input Ports
in_field
A 2D or 3D mesh plus node data to contour. A 2D mesh produces isolines and a 3D mesh produces isosurfaces. At least one component must be scalar.
in_image
An array of images to apply as textures to the contour regions.
ui_parent
A port to connect to a user interface object that contains the module's widgets. By default, it is connected to the default user interface object in the application in which the module is instanced. (This default connection is not drawn.)
Parameters
contour component
The specific component of the input field to contour. The default is the first (0th) component. The selected component must be scalar, otherwise the module returns the following error:
iso: first component is not scalar
If node-data labels are present, the module displays them.
number of contours
The number of contour regions to produce. The default is the number of images in the in_image[] array.
min level
max level
The minimum and maximum isoline/isosurface values between which to extract data. The module extracts from the selected contour component all data values in this range. The default is 0.0.
The data type of the UIslider used to set these values is converted automatically to the data type of the node data.
Output Ports
out_fld
An unstructured mesh plus node data that contains the textured contour regions. The mesh is an unstructured mesh of cell type Line (2D) or Tri (3D) that represents the contour volume and the node data is the values within the volume. The surface values are interpolated along the isosurface or isoline.
out_obj
A renderable object version of the textured contour regions.
File
v/modules.v
See Also