NAME ucd cell geometry, version 2 SYNOPSIS: Display and Edit UCD cell structures Type Mapper Input UCD Colormap upstream transform upstream geom Output Geometry field output, edited node position 1D integer 2-vector 3-space irregular, length 1. Parameters: Name Type Choices Color Method choice Cell Number Cell Data Material Id Node Number Node Data Cell Type Face Order X-Coord Y-Coord Z-Coord cos(X Dip) cos(Y Dip) cos(Z Dip) Wire Frame toggle Solid, or Line mode Show XFM Icon toggle Display Transform Guides Apply change Oneshot Send Edit Field upstream Mark Picked Face Toggle special colour of picked cell Drag Model Lines Toggle bend cells on transformations show drag lines toggle show line from pick to transformed Marked Face Hue float color of marked face Target Hue float picked and target sphere color Remove Interior toggle remove interior faces, only show external boundaries Downsize integer 1-20 fraction of model to display Optimize Surface Normal Toggle flat or smooth shade option. Source ucd_cell_geom.c Author: Ian Curington, AVS Inc, Esher, UK < ianc@avs.com > DESCRIPTION [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. Related Modules: ucd_to_geom, ucd_contour Example Network: ( see ucd_cell_geom.net ) GENERATE COLORMAP READ_UCD | | ------------ -------------- | | UCD CELL GEOMETRY | GEOMETRY VIEWER