ImageComposer

MLModule

genre	Compose
status	stable
author	Wolf Spindler
package	MeVisLab/Standard
dll	MLMiscModules
definition	MLMiscModules.def
see also	SubImage, ConcatenateImages, Replicate
keywords	compose, composition, collection, concatenate, sequentialize, combine

Purpose

The module ImageComposer offers operations to concatenate one image after another to an existing volume in any of the 6 image dimensions or at a user defined position inside or outside another image.

The result image is stored in a virtual volume within the module until it is cleared or the module is deleted.

Details

Since concatenation of images also requires correct concatenation of image properties in all dimension, each non existing image property for the c-, t- or u-dimension is filled up with ML_UNKNOWN codes or a default DateTime setting, respectively.

The image properties are generally given by the first image added to the module. Consecutively added images only change the image extents, the min/max values and the c-, t- and u-dimension information.

Windows

Default Panel

Input Fields

input0

name: input0, type: Image

Output Fields

output0

name: output0, type: Image

Parameter Fields

Field Index

Add: Trigger

Auto Add: Bool

Clear: Trigger

Fill Value: Double

Mode: Enum

User Pos: String

Visible Fields

Mode

name: mode, type: Enum, default: AppendInZ

Defines the dimension in which the input image(s) will be concatenated.

Values:

Title	Name	Description
Append In X	AppendInX
Append In Y	AppendInY
Append In Z	AppendInZ
Append In C	AppendInC
Append In T	AppendInT
Append In U	AppendInU
Write At User Pos	WriteAtUserPos	Appends an image at any position in the six image dimensions defined by the vector User Pos.

Fill Value

name: fillValue, type: Double, default: 0

Sets a fill value that is set to regions where the image extent is not overlapping.

Note that this value is cast to the internal image data type.

Add

name: add, type: Trigger

If pressed, the current input image is concatenated with the output image according to the Mode.

If the input image is not connected, nothing happens.

Auto Add

name: autoAdd, type: Bool, default: FALSE

If checked, the input image is concatenated to the output on each touch of the image input.

Clear

name: clear, type: Trigger

If pressed, the output image is being cleared.

User Pos

name: userPos, type: String, default: 0 0 0 0 0 0

Sets a position to where the input image is added to the output image if Mode is set to WriteAtUserPos.