RasterFunctions

MLModule

genre	Draw
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	MLMiscModules
definition	MLMiscModules.def
see also	Draw3D, Raster, Mask
keywords	set, voxelization, draw, implicit, mask, object

Purpose

The module RasterFunctions generates a list of raster functions.

These functions can be used in various contexts, especially when a function is rasterized into an image with the Raster module.

Usage

There are three list modes, which result in three different ways of working with the module. Have a look at the field List Mode for information about the usage.

Windows

Default Panel

Input Fields

inputXMarkerList

name: inputXMarkerList, type: XMarkerList(MLBase)

A XMarkerList.

For accessing this object via scripting see the Scripting Reference: MLXMarkerListWrapper.

Output Fields

outputFunction

name: outputFunction, type: RasterFunctionList(MLBase)

A list of raster functions. Can be rasterized into an image using the Raster module.

Parameter Fields

Field Index

Apply: Trigger	Rotation: Rotation
Apply Mode: Enum	Rotation Mode: Enum
Clear: Trigger	Scale: Vector3
Fill Value: Double	Scale XMode: Enum
Fill Value Mode: Enum	Scale YMode: Enum
Function: Enum	Scale ZMode: Enum
Function List Size: Integer	Transform: Matrix
List Mode: Enum	Translation: Vector3

Visible Fields

Function

name: function, type: Enum, default: Box, deprecated name: Function

Defines the function type.

Values:

Title	Name	Description
Fill	Fill	This fills all points
Box	Box	This fills all points in a box
Sphere	Sphere	This fills all points in a sphere
Cylinder	Cylinder	This fills all points in a cylinder
Clip Plane	ClipPlane	This fills all points in a half-space
Wedge	Wedge	This fills all points in a wedge
Open Wedge	OpenWedge	This fills all points in an open wedge
Cone	Cone	This fills all points in a cone
Open Cone	OpenCone	This fills all points in an open cone
Half Sphere	HalfSphere	This fills all points in a half sphere
Quarter Sphere	QuarterSphere	This fills all points in a quarter sphere
Eighth Sphere	EighthSphere	This fills all points in an eighth sphere
Slab	Slab	This fills all points in a slab

List Mode

name: listMode, type: Enum, default: Single

Defines how many functions are generated.

Values:

Title	Name	Description
Single	Single	Exactly one function is added to the list. All properties for the function have to be defined manually. This corresponds to the behavior of the original implementation of this module.
Append	Append	Create a function list by adding an arbitrary number of functions manually. All properties for the function have to be defined manually and can be changed for every entry. If Apply Mode is set to ‘autoApply’, this can be used to draw for example.
From XMarker List	FromXMarkerList	Create a function list based on the inputXMarkerList. The function properties may be defined manually or derived from marker properties (see Scale XMode, Scale YMode, Scale ZMode, Fill Value Mode, and Rotation Mode).

Scale XMode

name: scaleXMode, type: Enum, default: Manual

Defines how the scaling of the function in x-direction is determined.

It can either be derived from marker properties or set manually using the fields below. The field is only used if the list is generated based on the input XMarkerList.

Values:

Title	Name	Description
Manual	Manual	Defined by the first component of the Scale field.
Type	Type	Defined by the marker’s type.
Index	Index	Defined by the marker’s index.
Id	Id	Defined by the marker’s ID.
Vector Length	VectorLength	Defined by the length of the marker vector.
Vector X	VectorX	Defined by the x-coordinate of the marker’s vector.
Vector Y	VectorY	Defined by the y-coordinate of the marker’s vector.
Vector Z	VectorZ	Defined by the z-coordinate of the marker’s vector.
Position X	PositionX	Defined by the x-coordinate of the marker’s position.
Position Y	PositionY	Defined by the y-coordinate of the marker’s position.
Position Z	PositionZ	Defined by the z-coordinate of the marker’s position.
Position C	PositionC	Defined by the c-coordinate of the marker’s position.
Position T	PositionT	Defined by the t-coordinate of the marker’s position.
Position U	PositionU	Defined by the u-coordinate of the marker’s position.

Scale YMode

name: scaleYMode, type: Enum, default: Manual

Defines how the scaling of the function in y-direction is determined.

It can either be derived from marker properties or set manually using the fields below. The field is only used if the list is generated based on the input XMarkerList.

Values:

Title	Name	Description
Manual	Manual	Defined by the second component of the Scale field.
Type	Type	Defined by the marker’s type.
Index	Index	Defined by the marker’s index.
Id	Id	Defined by the marker’s ID.
Vector Length	VectorLength	Defined by the length of the marker’s vector.
Vector X	VectorX	Defined by the x-coordinate of the marker’s vector.
Vector Y	VectorY	Defined by the y-coordinate of the marker’s vector.
Vector Z	VectorZ	Defined by the z-coordinate of the marker’s vector.
Position X	PositionX	Defined by the x-coordinate of the marker’s position.
Position Y	PositionY	Defined by the y-coordinate of the marker’s position.
Position Z	PositionZ	Defined by the z-coordinate of the marker’s position.
Position C	PositionC	Defined by the c-coordinate of the marker’s position.
Position T	PositionT	Defined by the t-coordinate of the marker’s position.
Position U	PositionU	Defined by the u-coordinate of the marker’s position.

Scale ZMode

name: scaleZMode, type: Enum, default: Manual

Defines how the scaling of the function in z-direction is determined.

It can either be derived from marker properties or set manually using the fields below. The field is only used if the list is generated based on the input XMarkerList.

Values:

Title	Name	Description
Manual	Manual	Defined by the third component of the Scale field.
Type	Type	Defined by the marker’s type.
Index	Index	Defined by the marker’s index.
Id	Id	Defined by the marker’s ID.
Vector Length	VectorLength	Defined by the length of the marker’s vector.
Vector X	VectorX	Defined by the x-coordinate of the marker’s vector.
Vector Y	VectorY	Defined by the y-coordinate of the marker’s vector.
Vector Z	VectorZ	Defined by the z-coordinate of the marker’s vector.
Position X	PositionX	Defined by the x-coordinate of the marker’s position.
Position Y	PositionY	Defined by the y-coordinate of the marker’s position.
Position Z	PositionZ	Defined by the z-coordinate of the marker’s position.
Position C	PositionC	Defined by the c-coordinate of the marker’s position.
Position T	PositionT	Defined by the t-coordinate of the marker’s position.
Position U	PositionU	Defined by the u-coordinate of the marker’s position.

Fill Value Mode

name: valueMode, type: Enum, default: Manual

Defines the fill mode.

Values:

Title	Name	Description
Manual	Manual	Defined by the Fill Value field.
Type	Type	Defined by the marker’s type.
Index	Index	Defined by the marker’s index.
Id	Id	Defined by the marker’s ID.
Vector Length	VectorLength	Defined by the length of the marker vector.
Vector X	VectorX	Defined by the x-coordinate of the marker’s vector.
Vector Y	VectorY	Defined by the y-coordinate of the marker’s vector.
Vector Z	VectorZ	Defined by the z-coordinate of the marker’s vector.
Position X	PositionX	Defined by the x-coordinate of the marker’s position.
Position Y	PositionY	Defined by the y-coordinate of the marker’s position.
Position Z	PositionZ	Defined by the z-coordinate of the marker’s position.
Position C	PositionC	Defined by the x-coordinate of the marker’s position.
Position T	PositionT	Defined by the t-coordinate of the marker’s position.
Position U	PositionU	Defined by the u-coordinate of the marker’s position.

Rotation Mode

name: rotationMode, type: Enum, default: Manual

Defines how the rotation of the function’s coordinate system is determined.

It can either be rotated such that one of the positive or negative local axes of the functions coordinate system is aligned with the marker vector or set manually using the rotation field. The field is only used if the list is generated based on the input XMarkerList.

Values:

Title	Name	Description
Manual	Manual	Defined by the Rotation field.
Align Positive XTo Vector	AlignPositiveXToVector	Set rotation such, that the local positive x-axis of the function is aligned to the marker’s vector.
Align Negative XTo Vector	AlignNegativeXToVector	Set rotation such, that the local negative x-axis of the function is aligned to the marker’s vector.
Align Positive YTo Vector	AlignPositiveYToVector	Set rotation such, that the local positive y-axis of the function is aligned to the marker’s vector.
Align Negative YTo Vector	AlignNegativeYToVector	Set rotation such, that the local negative y-axis of the function is aligned to the marker’s vector.
Align Positive ZTo Vector	AlignPositiveZToVector	Set rotation such, that the local positive z-axis of the function is aligned to the marker’s vector.
Align Negative ZTo Vector	AlignNegativeZToVector	Set rotation such, that the local negative z-axis of the function is aligned to the marker’s vector.

Transform

name: transform, type: Matrix, default: 1 0 0 0, 0 1 0 0, 0 0 1 0, 0 0 0 1, deprecated name: Transform

Sets a transformation as a 4x4 transformation matrix string.

Translation

name: translation, type: Vector3, default: 0 0 0, deprecated name: Translation

Sets a translation.

Rotation

name: rotation, type: Rotation, default: 0 0 1 0, deprecated name: Rotation

Sets a rotation.

Scale

name: scale, type: Vector3, default: 1 1 1, deprecated name: Scale

Sets a scale factor vector.

Fill Value

name: fillValue, type: Double, default: 1

Sets a fill value.

Function List Size

name: functionListSize, type: Integer, persistent: no

Shows the size of the current raster function list.

Clear

name: clear, type: Trigger

When pressed, the list is cleared.

Apply

name: apply, type: Trigger

When pressed, the output is updated.

Apply Mode

name: applyMode, type: Enum, default: AutoApply

Defines the behavior of the module on changes of any field (including inputXMarkerList).

Values:

Title	Name	Description
Auto Clear	AutoClear	Clear the list.
Auto Apply	AutoApply	Update.
Off	Off	Do nothing.