WEMModify¶

MLModule¶

genre	`WEMProcessing`
status	`stable`
authors	`Bart De Dobbelaer`, `Olaf Konrad`
package	`MeVisLab/Standard`
dll	`MLWEMModules`
definition	MLWEMModules.def
see also	`WEMInfo`
keywords	`WEM`, `scale`, `translate`, `mirror`, `triangulate`, `color`, `lutValue`

Purpose¶

The module WEMModify modifies nodes and/or faces.

Node modifications consist of scaling, translating, rotating and centering the WEM. Additionally, the internal nodes' RGBA colors and the internal LUT values can be modified.

Face modifications include mirroring and triangulation.

Usage¶

Simply connect any WEM to the input of the WEMModify module and select appropriate parameters to be modified.

The module can work on all WEMPatches of the input WEM or on just a (manual) selection of patches.

Details¶

The Use Transform Matrix flag enables an input matrix that is multiplied to each WEMNode straight forward. If Use Transform Matrix is enabled, scale, rotation and translation are disabled and vice versa.

Windows¶

Default Panel¶

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

Input Fields¶

inWEM¶

name: inWEM, type: MLBase¶: The WEM to be modified.

Output Fields¶

outWEM¶

name: outWEM, type: MLBase¶: Either the modified copy of the input WEM or the modified original WEM.

Parameter Fields¶

Field Index¶

`Alpha`: `Float`	`isProcessing`: `Bool`	`Set node color`: `Bool`
`Apply`: `Trigger`	`Label`: `String`	`show`: `Bool`
`Auto Apply`: `Bool`	`listenToFinishNotifications`: `Bool`	`To Max`: `Float`
`Auto Update`: `Bool`	`Mirror Faces`: `Bool`	`To Min`: `Float`
`autoClear`: `Bool`	`Mode`: `Enum`	`Transform Matrix`: `Matrix`
`Center`: `Bool`	`Modify Attributes`: `Bool`	`Translate`: `Vector3`
`Clamp value (clampNodeMinValue)`: `Bool`	`modifyFieldsValid`: `Bool`	`Triangulate Faces`: `Bool`
`Clamp value (clampNodeMaxValue)`: `Bool`	`Node (LUT) Value Mode`: `Enum`	`Use Copy`: `Bool`
`Close Boundaries`: `Bool`	`Node Color`: `Color`	`Use Transform Matrix`: `Bool`
`Description`: `String`	`progress`: `Float`	`useFaceDiffuseColor`: `Bool`
`editable`: `Bool`	`removePreviousWEMs`: `Bool`	`useInputWEMToCreateOutputWEM`: `Bool`
`elapsedTime`: `Float`	`Rotation`: `Vector4`	`usePolygonOffset`: `Bool`
`forwardRepaintNotifications`: `Bool`	`Scale`: `Vector3`	`Value`: `Float`
`forwardSelectionNotifications`: `Bool`	`selectedWEMs`: `String`	`WEMs`: `String`
`id`: `Integer`	`Set node alpha`: `Bool`

Visible Fields¶

Auto Apply¶

name: autoApply, type: Bool, default: TRUE¶: If checked, all parameter changes take immediately effect.

Auto Update¶

name: autoUpdate, type: Bool, default: TRUE¶: If checked, an update of the input WEM leads to a new computation.

Apply¶

name: apply, type: Trigger¶: If pressed, the module computes anew.

Label¶

name: label, type: String¶: Sets the new label for selected WEMPatches if Modify Attributes is checked.

Description¶

name: description, type: String¶: Sets the new description for selected WEMPatches if Modify Attributes is checked.

Node Color¶

name: nodeColor, type: Color, default: 1 1 1¶: Sets the color that is set to all nodes if Set node color is checked.

Use Copy¶

name: copyInputWEMs, type: Bool, default: FALSE¶: If checked, the module will copy the input WEM and modify that copy. Otherwise, the module works directly on the input WEM.

Mode¶

name: triangulationMode, type: Enum, default: Strip¶

Defines a triangulation mode.

If the selected WEMPatch(es) yield non-triangular faces, the module triangulates those faces if Triangulate Faces is checked.

Values:

Title	Name
Center node	Center node
Fan	Fan
Strip	Strip

Modify Attributes¶

name: modifyAttributes, type: Bool, default: FALSE¶: If checked, the module allows for a modification of the label and the description of selected WEMPatches.

Scale¶

name: scale, type: Vector3, default: 1 1 1¶: Sets a scaling vector to scale all nodes of the 3D mesh with.

Translate¶

name: translate, type: Vector3, default: 0 0 0¶: Sets a translation vector to translate all nodes of the 3D mesh by.

Center¶

name: center, type: Bool, default: FALSE¶

If checked, the WEM is centered around coordinate (0,0,0).

This allows for a more natural rotation while viewing.

Rotation¶

name: rotation, type: Vector4, default: 0 0 1 0¶: Sets a rotation to rotate all nodes of the 3D mesh.

Transform Matrix¶

name: transformMatrix, type: Matrix, default: 1 0 0 0, 0 1 0 0, 0 0 1 0, 0 0 0 1¶: Sets a matrix that is multiplied to each WEM node's position of the 3D mesh.

Use Transform Matrix¶

name: useTransformMatrix, type: Bool, default: FALSE¶: If checked, the multiplication of the transformation matrix is applied directly to the mesh.

Mirror Faces¶

name: mirrorFaces, type: Bool, default: FALSE¶: If checked, all faces are mirrored, leading the surface to be inside-out.

Triangulate Faces¶

name: triangulateFaces, type: Bool, default: FALSE¶

If checked, all non-triangle faces are triangulated, resulting a triangle-only mesh.

The module uses the Mode.

Close Boundaries¶

name: closeBoundaries, type: Bool, default: FALSE¶: If checked, the module tries to close holes in a WEMPatch by a triangulation scheme.

Set node color¶

name: setNodeColor, type: Bool, default: FALSE¶: If checked, all nodes' internal colors are set to the Node Color value.

Set node alpha¶

name: setNodeAlpha, type: Bool, default: FALSE¶: If checked, all nodes' alpha values are set to the Alpha value.

Alpha¶

name: nodeAlpha, type: Float, default: 1, minimum: 0, maximum: 1¶: Sets the alpha value that is set to all nodes if the Set node alpha is checked.

Node (LUT) Value Mode¶

name: nodeValueMode, type: Enum, default: None¶

Defines if and how the nodes' internal PVL LUT is modified.

Note that a clamping of these values occurs after modifying the value.