For smooth coloring, if the lattice is vector-valued the RGB color is taken from the vector and the datatype determines how the values are mapped into intensities. For byte and long data, the minimum and maximum intensities are mapped from 0 to 255. For short data, the minimum and maximum intensities are mapped from 0 to 65535. For float and double data, the minimum and maximum intensities are mapped from 0.0 to 1.0.
For smooth coloring and single-valued lattices, the colors are mapped from a Colormap if present, or else greyscale is used.
When using texture maps, the coloring is done based on the data values in a single data channel. The texture map is generated by sampling the ColorMap input when present. Otherwise a default set of colors is used. Texture maps may have 2, 4, 8, 16, 32, or 64 colors.
If there are more than three coordinates per lattice node, the extra components will be ignored. If there are fewer than three coordinates per lattice node, the missing components will be padded with zero.
Face normals may be attached to the geometry. This is required if the lattice is to be shaded with the lighting model in the renderer. Otherwise, the color will not be modulated by the lighting.
If a polygonal representation is selected, each rectangle may be created as two or four triangles. Using two triangles ignores the interpolated value of the cell center, with the advantage of lower memory consumption and faster rendering. Using four triangles makes use of the interpolated cell center value and so may yield more accurate rendering of the lattice. The color of the cell center is interpolated from the colors of the corners, rather than interpolating the actual point data, to avoid additional shading artifacts.
If an optional transform is fed in, the lattice nodes will be transformed before being output as geometry.
Additionally, this module has been extended to be collaboratively aware using the COVISA collaborative toolkit (version 1.5). This allows it to be used in single-user mode, or (if connected to a collaborative session using the MServer module) as a collaborative module. In collaborative mode it is able to select its data source, either localy or from the collaborative session.
A full description of the COVISA module suite and API is given in the IRIS Explorer Collaborative User Guide. You are strongly advised to read this guide before using MShareLatToGeom as a collaborative module.
Port: Input
Type: Lattice
Optional: This port is optional
Constraints: 1..2-D
Constraints: -vector
Constraints: byte..double
Lattice to convert into geometry.
Port: Transform
Type: Lattice
Optional: This port is optional
Constraints: 2-D
Constraints: 1-vector
Constraints: float
Optional transformation matrix to be applied to the input lattice.
Port: Colormap
Type: Lattice
Optional: This port is optional
Constraints: 1-D
Constraints: 4-vector
Constraints: float
Optional colormap to be used to map lattice data values to color in
the geometry.
Port: Dimension
Type: Radio Box
Menu Item: 0D
Menu Item: 1D
Menu Item: 2D
Dimension of primitive element in geometry that is produced
(0, 1, or 2D - points, lines or polygons).
Port: Normal Type
Type: Radio Box
Menu Item: No Normals
Menu Item: Face Normals
Controls whether the geometry contains face normals.
Port: Center Points
Type: Radio Box
Menu Item: Ignore Centers
Menu Item: Use Centers
Controls whether to use interpolated cell centers in polygonal rendering.
Port: Color Style
Type: Radio Box
Menu Item: Color Map
Menu Item: Texture Map
Controls the way in which colors are mapped onto the geometry.
In Color Map mode, each vertex is assigned a color according to its data value. The vertex colors are then interpolated between vertices and across faces to give continuous variation of color across the shape.
In Texture Map mode, the colors are assigned to regions of the geometry according to the range of data values at the vertices. This gives solid, distinct bands of color on the shape.
Port: Csize
Type: Slider
If texture mapping is used, the number of color bands is set to 2**n
colors, where n is the value of the Csize widget. This widget is only
visible when texture mapping is in force.
Port: Channel
Type: Slider
If the lattice has more than one data channel, and texture mapping is in
force, then this widget is visible and the lattice is colored according
to the data values in the selected data channel.
Port: Initiate
Type: Button
Makes the module connect to the COVISA Server to be used in
collaborative mode.
Port: Join
Type: Button
DO NOT USE THIS PORT. It is reserved for
communication by underlying Skm commands.
Port: ID
Type: Slider
DO NOT USE THIS PORT. It is reserved for
communication by underlying Skm commands.
Port: Name
Type: Text
DO NOT USE THIS PORT. It is reserved for
communication by underlying Skm commands.
Port: Connection_State
Type: Option Menu
Menu Item: Reconnect
Menu Item: Disconnect
This menu box allows the module to be disconnected
and reconnected from/to the COVISA Server once the
initial connection has been made.
Port: Application
Type: Text
DO NOT USE THIS PORT. It is reserved for
communication by underlying Skm commands.
Port: Data_Source
Type: Option Menu
Menu Item: Local
Menu Item: Remote
When connected to the collaborative session, the user may select
the source of the data that the module uses. When local is selected,
any new incoming data on the "Input" module port is sent into the
collaborative session (as well as being used by the module).
When remote is selected, local data is ignored and processing occurs
using data from the session.
Port: Output
Type: Geometry
Geometry of the outputted shape.
The texture mapped geometry can take longer to render on some architectures. Note that the default behaviour of the Render module is to switch off texturing when the viewpoint or geometry is changing.
Wiring parameters into Join, ID, Name, and Application may interfere with the data communication between COVISA modules and this may lead to unexpected results.
MAdvisor MServer MShareGeom MShareGraph3D MShareLat MShareParam MSharePointer MSharePyr
The IRIS Explorer COVISA collaborative module suite and API was developed at the University of Leeds.
You are referred to the IRIS Explorer Collaborative User Guide for more information.