Module: Tetra Grid View ()

Description:

The Tetra Grid View module is a powerful tool for visualizing labeled tetrahedral volume grids, e.g., tetrahedral patient models. Views on various sub-grids can be specified, e.g., a view on a sub-grid corresponding to one of the tissue compartments of a patient model. The module maintains an internal buffer which contains all currently visible tetrahedra. Tetrahedra belonging to a particular compartment can be selected and added to the buffer. Selected tetrahedra are displayed using a red wireframe. Having been added to the buffer they are displayed in their associated colors. The selection can be restricted by means of an adjustable selection box. In addition, individual tetrahedra can be removed from the buffer by Ctrl-clicking on one of their faces, but notice that the viewer must be in interactive mode for this. Similarly, a simple click on a face adds the tetrahedra in front of it to the buffer.

Note: Neither Transparency nor Clipping Plane allow displaying grid cells inside the volume.

Connections:

Data [required]
The labeled Tetra Grid to be visualized.

ColorField [optional]
Arbitrary scalar field which is mapped onto the grid volume using pseudo-coloring.

Colormap [optional]
The colormap is used for pseudo-coloring the grid volume.

Texture [optional]
The texture field must be an HxUniformColorField3 2D slice. When connected, the texture is mapped onto the surface geometry along the texture normal axis. A transformation can be applied to the data to change the texture projection axis and texture coordinates scale. Note that texture projection override pseudo-color mode.

ROI [optional]
Optional connection to an object providing a region-of-interest, e.g., ROI Box. Only triangles inside this region will be visualized.

Ports:

Draw Style

This port is inherited from the View Base class and therefore the description will be found there. In contrast to other modules derived from the View Base class this module does not provide the possibility to consider vertex and direct normals. The triangles will always be drawn flat.

Colormap

This port becomes visible only if a scalar field has been connected to the ColorField port. For further details see section Colormap.

Texture wrap

Wrap mode used for the texture projection on the surface. There are two wrap modes: Repeat: The texture is repeated outside its 0-1 texture coordinate range. Clamp: Clamps texture coordinates to lie within 0-1 range. This port is hidden if there is nothing connected to the Texture connection port.

Buffer

This port lets you add and remove highlighted triangles (being displayed in red wireframe) to an internal buffer. For a further description and for the functionality of each of the port buttons see View Base.

Materials

This port provides a menu where all materials of the input grid are listed. If you choose a material, all tetrahedra of that material are selected and displayed using a red wireframe model. You may crop the selection domain by turning the viewer into interactive mode and moving the green handles of the bounding box to a position of your choice. Only the tetrahedra inside the bounding box can be added to the buffer.

Color mode

Here you may choose among several color modes. For details see the module Surface View.

Commands:

getSelectedTetra
Displays a run-length encoded list of all currently selected tetrahedra. The list consists of pairs of integer numbers. The first number is the index of a selected tetrahedron. The second value denotes the number of subsequent selected tetrahedra.

setSelectedTetra <list>
Adds some tetrahedra to the internal buffer so that they become visible. The argument is a run-length encoded list like the one displayed by getSelectedTetra.

setSelectAllNew {0|1}
If set to 1 all tetrahedra are selected when a new data set has been connected to the Data port. Useful in a project together with Time Series Control.