WEMSelectPatches

MLModule

genre	WEMProcessing
status	stable
author	Axel Newe
package	MeVisLab/Standard
dll	MLWEMModules
definition	MLWEMModules.def
see also	WEMDemergePatches
keywords	WEM, patch, select, create, filter

Purpose

The module WEMSelectPatches allows for selecting patches of a WEM and creating new WEM from them.

Usage

Connect a WEM to the input field. Select the parameters described below to define which patches shall be copied to the new WEM.

Click Apply to create the new WEM (or alternatively enable the Auto Apply option).

Hitting the Clear button clears the output WEM (removes all patches).

Details

This module creates a new WEM based on the WEM/patches connected to its input.

Each time the Apply button is clicked, a new WEM is created that consists of all patches from the WEM connected to the input that match the criteria specified in the Selection Settings box.

The input WEM is not altered.

If the option Auto Apply is enabled, all parameter changes automatically trigger the creation of the new WEM.

Hitting the Clear button removes all patches from the output WEM.

Tips

If the Allow only one single output patch option is enabled, the Label and the Description attributes need to be set - otherwise they will be erased (or overwritten with the default - empty - value, respectively).

Windows

Default Panel

Input Fields

inWEM

name: inWEM, type: MLBase

Output Fields

outWEM

name: outWEM, type: MLBase

Parameter Fields

Field Index

Allow only one single output patch: Bool	edgeColor: Color	nodeColor: Color
Apply: Trigger	editable: Bool	nodeNormalsColor: Color
Auto Apply: Bool	elapsedTime: Float	nodeNormalsScale: Float
autoClear: Bool	faceAlphaValue: Float	nodeRenderingMode: Enum
autoUpdate: Bool	faceAmbientColor: Color	pointSize: Float
boundingBoxColor: Color	faceDiffuseColor: Color	removePreviousWEMs: Bool
boundingBoxMode: Enum	faceNormalsColor: Color	Selection Mode: Enum
Clear: Trigger	faceNormalsScale: Float	Selection Value: String
colorMode: Enum	faceShininessValue: Float	show: Bool
Description: String	faceSpecularColor: Color	Status: String
drawBoundingBoxes: Bool	id: Integer	Triangulate Patches: Bool
drawEdges: Bool	Input WEM patches:: Integer	useEdgeColoringMode: Bool
drawFaceNormals: Bool	inWEMValid: Bool	useFaceAmbientColor: Bool
drawFaces: Bool	isProcessing: Bool	useFaceDiffuseColor: Bool
drawNodeNormals: Bool	Label: String	useFaceSpecularColor: Bool
drawNodes: Bool	lineWidth: Float	usePolygonOffset: Bool

Visible Fields

Auto Apply

name: autoApply, type: Bool, default: FALSE

If checked, the module selects the output patch on changing any parameter.

Apply

name: apply, type: Trigger

If pressed, the module selects the output patch(es) on base of the paramters.

Label

name: label, type: String

Sets the label string to the output WEMPatch.

Available only if Allow only one single output patch is checked.

Description

name: description, type: String

Sets the description string to the output WEMPatch.

Available only if Allow only one single output patch is checked.

Selection Mode

name: selectMode, type: Enum, default: Patch Number

Defines which property of the input WEM patches shall be used for selection.

Values:

Title	Name
Patch Number	Patch Number
Patch ID	Patch ID
Primitive Value: LUT	PrimitiveValue: LUT

Selection Value

name: selectValue, type: String

Sets a value to selected the WEMPatch. The use of the value depends on Selection Mode.

Allow only one single output patch

name: singleOutputPatch, type: Bool, default: TRUE

If checked, generally only one (the first, if more than one is available) patch is copied.

In this case it is posssible to edit the attributes of the patch(see Triangulate Patches).

Some options selectable for the Selection Value parameter result in only one patch being copied to the output WEM (e.g. Patch ID), others result in multiple patches being copied (e.g. Primitive Value: LUT).

Triangulate Patches

name: triangulatePatches, type: Bool, default: TRUE

If checked, all patches will be triangulate before adding them to the output WEM.

Remember: some WEM modules support arbitrary polygons, others do not.

Normally, all patches from the input WEM are copied to he output WEM "as they are" (i.e. with the same number and type of faces like in the input WEM).

Available only if Allow only one single output patch is not checked.

Clear

name: clear, type: Trigger

If pressed, the module clears its output.

Status

name: status, type: String

Shows the module's status.

Input WEM patches:

name: inWEMNumPatches, type: Integer, default: 0

Shows the number of input patches.

Hidden Fields

isProcessing

name: isProcessing, type: Bool, default: FALSE

elapsedTime

name: elapsedTime, type: Float, default: 0

id

name: id, type: Integer, default: 0

autoUpdate

name: autoUpdate, type: Bool, default: FALSE

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

colorMode

name: colorMode, type: Enum, default: General

Values:

Title	Name
General	General
Node Colors	Node Colors
LUT Values	LUT Values
LUT Values Integer	LUT Values Integer

drawFaces

name: drawFaces, type: Bool, default: TRUE

useFaceAmbientColor

name: useFaceAmbientColor, type: Bool, default: TRUE

faceAmbientColor

name: faceAmbientColor, type: Color, default: 0.266667008399963 0.266667008399963 0.266667008399963

useFaceDiffuseColor

name: useFaceDiffuseColor, type: Bool, default: TRUE

faceDiffuseColor

name: faceDiffuseColor, type: Color, default: 0.792156994342804 0.792156994342804 0.792156994342804

useFaceSpecularColor

name: useFaceSpecularColor, type: Bool, default: TRUE

faceSpecularColor

name: faceSpecularColor, type: Color, default: 0.0666669979691505 0.0666669979691505 0.0666669979691505

faceAlphaValue

name: faceAlphaValue, type: Float, default: 1

faceShininessValue

name: faceShininessValue, type: Float, default: 1

drawFaceNormals

name: drawFaceNormals, type: Bool, default: FALSE

faceNormalsColor

name: faceNormalsColor, type: Color, default: 1 1 1

faceNormalsScale

name: faceNormalsScale, type: Float, default: 1

drawEdges

name: drawEdges, type: Bool, default: FALSE

edgeColor

name: edgeColor, type: Color, default: 0 0 0

usePolygonOffset

name: usePolygonOffset, type: Bool, default: FALSE

lineWidth

name: lineWidth, type: Float, default: 1

useEdgeColoringMode

name: useEdgeColoringMode, type: Bool, default: FALSE

drawNodes

name: drawNodes, type: Bool, default: FALSE

nodeColor

name: nodeColor, type: Color, default: 1 1 1

drawNodeNormals

name: drawNodeNormals, type: Bool, default: FALSE

nodeNormalsColor

name: nodeNormalsColor, type: Color, default: 1 1 1

nodeNormalsScale

name: nodeNormalsScale, type: Float, default: 1

pointSize

name: pointSize, type: Float, default: 1

nodeRenderingMode

name: nodeRenderingMode, type: Enum, default: Normal

Values:

Title	Name
Normal	Normal
High	High
Extra High	Extra High

drawBoundingBoxes

name: drawBoundingBoxes, type: Bool, default: FALSE

boundingBoxMode

name: boundingBoxMode, type: Enum, default: Axis Aligned

Values:

Title	Name
Axis Aligned	Axis Aligned
Object Aligned	Object Aligned

boundingBoxColor

name: boundingBoxColor, type: Color, default: 1 1 1

inWEMValid

name: inWEMValid, type: Bool, default: FALSE