WEMImageData

MLModule
genre WEMProcessing
status stable
author Olaf Konrad
package MeVisLab/Standard
dll MLWEMModules
definition MLWEMModules.def
see also SoWEMRenderer, WEMInfo
keywords WEM, image, data, read, out

Purpose

The module WEMImageData sets the image values of a connected ML image to the nodes of a WEM that lies within a connected ML-image.

The module can set either the nodes' LUT values or the nodes' color values, or both.

Usage

Connect a WEM and an ML image to the module.

Details

The image values are set to WEMNodes with nearest neighbor interpolation in contrast to the WEMIsoSurface, which also sets image values to the nodes. In the latter case, the maximum value of a voxel neighborhood is set to the generated node. Nodes that lie outside the connected ML image can either keep their values, or an adjustable default can be set instead.

If the image values are to be set as LUT values, they can additionally be interpolated by a tri-linear interpolation. Note that the image values are stored in a WEMPrimitiveValueList by default under the name of LUT. However, the user is free to choose the PVL the values are going to be written into.

If the image values are to be set as colors directly, the input image must yield an extend in the c-dimension of at least 3. If the input image has a c-extend of only 1 or 2, the image values of the first c-dimension are read and set as RGB values, resulting in shades of grey. In the case that the image values do not range within an interval of [0..1], those values can be scaled. If the image values range within [0..255], set the according Color Scale Value to 255.

Make sure that the SoWEMRenderer that renders the modified WEM is set to display either the LUT values (attach a LUT module as well), or is set to display the nodes' colors.

Windows

Default Panel

../../../Modules/ML/MLWEMModules/mhelp/Images/Screenshots/WEMImageData._default.png

Input Fields

The module takes a WEM and an ML image as inputs.

input0

name: input0, type: Image

inWEM

name: inWEM, type: MLBase

Output Fields

The module's output is a WEM where image values are set as colors or LUT values, or both.

outWEM

name: outWEM, type: MLBase

Parameter Fields

Visible Fields

Auto Apply

name: autoApply, type: Bool, default: TRUE

If checked, the module computes a new output WEM on every parameter change.

Auto Update

name: autoUpdate, type: Bool, default: TRUE

If pressed, the module computes a new output WEM on each change of the input WEM or the input image.

Apply

name: apply, type: Trigger

If pressed, the module computes a new output WEM.

Set (setLutValue)

name: setLutValue, type: Bool, default: TRUE

If checked, the image values are written into the chosen PVL

Set (setColorValue)

name: setColorValue, type: Bool, default: FALSE

If checked, the color of the nodes is modified.

Color Scale Value

name: colorScaleValue, type: Float, default: 1, minimum: 1

Sets a value by that all R,G and B components are divided in order to get the R,G,B values into the range [0..1].

A value of 0 is impossible to set.

Use interpolation

name: useInterpolation, type: Bool, default: FALSE

If checked, the module usse a trilinear image value interpolation.

Set values for outside nodes

name: setDefaultForOutsideNodes, type: Bool, default: FALSE

If checked, the LUT Values is set to nodes that lie outside the ML image, otherwise, the values of outside nodes remain unchanged.

This option works for the setting of LUT values as well as for the setting of node colors (here, the Color is set).

LUT Values

name: defaultValue, type: Float, default: 0

Sets the default LUT value for nodes that lie outside the ML image.

Color

name: defaultColor, type: Color, default: 1 1 1

Sets the default color for nodes that lie outside the ML image.

Use default value list

name: useLUTPrimitiveValueList, type: Bool, default: TRUE

If checked, the image values are written into the default PVL named LUT, else a new PVL is generated and written into by the name provided in the Custom Value List.

Custom Value List

name: customPrimitiveValueList, type: String, default: Image Data

Sets a name for the PVL the image values are written into.

Hidden Fields

isProcessing

name: isProcessing, type: Bool, default: FALSE

elapsedTime

name: elapsedTime, type: Float, default: 0

id

name: id, type: Integer, default: 0

autoClear

name: autoClear, type: Bool, default: FALSE

removePreviousWEMs

name: removePreviousWEMs, type: Bool, default: TRUE

show

name: show, type: Bool, default: TRUE

editable

name: editable, type: Bool, default: TRUE

useFaceDiffuseColor

name: useFaceDiffuseColor, type: Bool, default: TRUE

usePolygonOffset

name: usePolygonOffset, type: Bool, default: FALSE

listenToFinishNotifications

name: listenToFinishNotifications, type: Bool, default: TRUE

forwardRepaintNotifications

name: forwardRepaintNotifications, type: Bool, default: TRUE

forwardSelectionNotifications

name: forwardSelectionNotifications, type: Bool, default: TRUE

progress

name: progress, type: Float, persistent: no

useInputWEMToCreateOutputWEM

name: useInputWEMToCreateOutputWEM, type: Bool, persistent: no

triangulationMode

name: triangulationMode, type: Enum, default: Strip

Values:

Title Name
Center node Center node
Fan Fan
Strip Strip