WEMSmooth

MLModule

genre	WEMProcessing
author	Olaf Konrad
package	MeVisLab/Standard
dll	MLWEMModules
definition	MLWEMModules.def
see also	SoWEMRenderer
keywords	surface, Laplace

Purpose

The module WEMSmooth smoothes a WEM by applying either a surface smooth (Laplacian), or a smoothing of the surface's normals.

Details

In general, the Smoothing Factor should be adjusted to a value from 0.5 to 0.9. The Num. Smoothing Passes should be adjusted to a value from 20 to 50. With Num. Smoothing Passes, choose a low value of smoothing passes, such as 2 or 5.

If Use normals smoothing is chosen, only the node normals are smoothed; no node's position is modified. This way, you can enhance the overall appearance without modifying the volume or surface area at all. It is recommended to be used as late as possible in the WEM-processing pipeline.

Note that the smoothed normals are stored in the WEM and are used for the visualization, but the normals are recomputed by modules like WEMReducePolygons or WEMSubdivide. So, if a WEMReducePolygon module is used after smoothing, the result of an eventual normal smoothing is lost. In such a case, use another WEMSmooth with only normal smoothing enabled directly before the SoWEMRenderer.

Windows

Default Panel

Input Fields

inWEM

name: inWEM, type: MLBase

Output Fields

outWEM

name: outWEM, type: MLBase

The smoothed WEM.

Parameter Fields

Field Index

Apply: Trigger	isProcessing: Bool	removePreviousWEMs: Bool
Auto Apply: Bool	listenToFinishNotifications: Bool	Smoothing Factor: Float
Auto Update: Bool	listenToRepaintNotifications: Bool	triangulationMode: Enum
autoClear: Bool	listenToSelectionChangedNotifications: Bool	Use border preservation: Bool
elapsedTime: Float	Num. Smoothing Passes (smoothingPassesLaplace): Integer	Use displacement adjustment: Bool
forwardRepaintNotifications: Bool	Num. Smoothing Passes (smoothingPassesNormals): Integer	Use normals smoothing: Bool
forwardSelectionNotifications: Bool	overwriteLabelDescription: Bool	Use surface smoothing: Bool
id: Integer	progress: Float	useInputWEMToCreateOutputWEM: 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 smoothing algorithm is applied on the WEM.

Use surface smoothing

name: useLaplacianSmooth, type: Bool, default: TRUE

If checked, a Laplacian surface smoothing is performed.

Smoothing Factor

name: smoothingFactor, type: Float, default: 0.2, minimum: 0, maximum: 1

Sets a smoothing factor. A value of 0 means no smoothing at all.

Num. Smoothing Passes (smoothingPassesLaplace)

name: smoothingPassesLaplace, type: Integer, default: 10, minimum: 0

Sets the number of smoothing passes for Laplacian surface smoothing.

Use displacement adjustment

name: useDisplacementAdjustment, type: Bool, default: TRUE

If checked, the surrounding of the currently smoothed node is displaced in a way that the overall shrinking effect is diminished.

Use border preservation

name: useBorderPreservation, type: Bool, default: TRUE

If checked, no border nodes' positions or normal are altered.

Use normals smoothing

name: useNormalSmooth, type: Bool, default: FALSE

If checked, a normal smoothing is performed.

Note that the normal smooth is applied after applying an optional surface smoothing.

Num. Smoothing Passes (smoothingPassesNormals)

name: smoothingPassesNormals, type: Integer, default: 2, minimum: 0

Sets the number of smoothing passes for normal smoothing.

Hidden Fields

isProcessing

name: isProcessing, type: Bool, persistent: no

elapsedTime

name: elapsedTime, type: Float, persistent: no

id

name: id, type: Integer, default: 0

autoClear

name: autoClear, type: Bool, default: FALSE

removePreviousWEMs

name: removePreviousWEMs, type: Bool, default: TRUE

overwriteLabelDescription

name: overwriteLabelDescription, type: Bool, default: TRUE

listenToFinishNotifications

name: listenToFinishNotifications, type: Bool, default: TRUE

listenToRepaintNotifications

name: listenToRepaintNotifications, type: Bool, default: TRUE

listenToSelectionChangedNotifications

name: listenToSelectionChangedNotifications, 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