[version 2, March 93]
This module draws geometric representation of UCD structures
showing CELL data, CELL Material ID, or Cell Number Sequence,
Node Number Sequence, scalar Node data, Cell topology type,
Face order, node positions, or face dip, by color.
It shows all cells in either
solid or wire frame, (unlike ucd_to_geom)
and colors the model directly, without
using and external module such as ucd_contour or ucd_cell_colors.
It allows picking and moving nodes within the model,
and has transformation icons, drag lines, and position markers
to aid position editing. The edit information is available in
a small field, containing new x-y-z node position, node number,
and cell number. Exterior faces only may be displayed with the
remove interior option. Downsize will subsample the structure
and only display a fraction of cells, for faster interaction.
The color range is defined by the colormap hi-low, and
DOES NOT autonormalize to the input UCD range, so allows
user refinement of the colormap.
The "Dip" option allows pseudo-color of surface angle or
curvature away from each axis.
This is a major update from version 1.0.
This module colours each cell ONE color, without color interpolation,
showing a single scalar quantity. If your cell data is n-vector,
this module will only color the first one, so use ucd_extract to
get the one you want. It will color the cells based on
[1] the linear cell number, or cell_id tag. It maps this range onto the
color input map.
[2] cell scalar data. Use the "upper" and "lower" colormap dials
to set the color to value mapping.
[3] material id numbers. It maps the max material id to cover the
input color map range.
[4] node number, from 1 to num_nodes using full colormap.
[5] node data, similar to the standard ucd_to_geom,
except the "upper" and "lower" colormap dials
control the range.
[6] Cell type, maps integer cell type, one of
pt, line, tri, quad, tet, pyr, prism, hex,
accross color map.
[7] Face Order, maps each face of each cell onto colormap,
in face order.
[8] X-Y-Z Coord, colors the nodes by distance, along individual
axes, with the colormap hi-low indicating model distance.
[9] cos(X Dip), computes the surface tilt angle away from
the specified axis, and colors the surface by the
cosine of this angle. The typical colormap range for
this should be within (-1, 1). This allows false color
of surface curvature.
The transformation editing features allow node and cell picking,
and return the node and cell id for external use. The node
of any cell may be moved, and optionally drag the edges of
the cell with it. A reference icon shows the transformation
being applied to the node, and auto-resets on a new pick.
The transform modes can be hidden, if you just want to use
the module as a display only device. In this case, do
not wire anything into the upstream ports.
The remove interior feature is basically the same as
the external face mode in ucd_to_geom, but does the
wire frame mode as well. This is on by default to
save the number of polygons displayed.
The Optimize Surface Normals feature is to create smoothly
shaded curved surfaces. When on, this will try to
share nodes where possible, and generate averaged
surface normals per vertex. This can take a little longer
than the default (off).
The (off) mode simply assumes no shared nodes, and
flat facet normals, and no node connectivity information
is computed. This is the very fastest mode for geometry
creation, but will not shade smoothly, and will make
a larger polytristrip.
/* removed due to loss of generality
This module also has a direct SHADED/WIRE_FRAME toggle control,
just to save time going to the viewer panel.
*/
This module is not like the standard ucd_to_geom,
in that it:
- does not cache information about the ucd structure
in between invocations,
- does not have a color array input from ucd_legend,
rather it colors directly with a colormap input,
- does not have "explode materials" mode
- does not have "shrink" function
- does not cache geometry for fast animation
This module is intended as a source example for other UCD module
developers.