AsyncMemoryImageLoad¶

MLModule¶

author	`MeVis Medical Solutions AG`
package	`MeVisLab/Standard`
dll	`MLAsyncImageLoaders`
definition	MLAsyncImageLoaders.def
see also	`AsyncMemoryImageFetch`
keywords	`mlimage`, `tiff`, `dicom`, `dcm`, `background`

Purpose¶

The AsyncMemoryImageLoad allows to load an image asynchronously. The module outputs the whole volume filled with the image min value and then loads the data tile-by-tile in an extra background task. The image is already usable/displayable while loading, e.g. on a SoView2D or SoOrthoView2D.

Internally the module uses a ML memory image, so that the data does not get copied/reallocated. This is especially useful if e.g. the MPR or Reformat are used, since they make use of the memory image as well.

The module uses the infrastructure of the ImageLoad module, thus it supports the same file formats as the ImageLoad. Currently mainly dcm/tiff and mlimage formats have been tested.

Output Fields¶

output0¶

name: output0, type: Image¶

Parameter Fields¶

Field Index¶

`Cancel`: `Trigger`	`Loading Finished`: `Bool`	`Update Mode`: `Enum`
`Clear`: `Trigger`	`progress`: `Float`
`Consistent`: `Bool`	`startTaskSynchronous`: `Trigger`
`Enable Half Resolution`: `Bool`	`Status`: `String`
`Filename`: `String`	`taskCanceled`: `Trigger`
`halfResolutionFinished`: `Trigger`	`taskFinished`: `Trigger`
`halfResolutionPostfix`: `String`	`taskRunning`: `Bool`
`Load`: `Trigger`	`taskVerboseLogging`: `Bool`

Visible Fields¶

Load¶

name: startTask, type: Trigger¶: Load the image.

Cancel¶

name: cancelTask, type: Trigger¶: Cancel loading.

Status¶

name: status, type: String, persistent: no¶: The current status.

Clear¶

name: clear, type: Trigger¶: Clear the image.

Loading Finished¶

name: loadingFinished, type: Bool, persistent: no¶: Shows if the image is completely loaded.

Consistent¶

name: consistent, type: Bool, persistent: no¶

Update Mode¶

name: updateMode, type: Enum, default: AutoClear¶

Values:

Title	Name
Auto Update	AutoUpdate
Auto Clear	AutoClear
Off	Off

Filename¶

name: filename, type: String¶: The filename of the image.

Enable Half Resolution¶

name: enableHalfResolution, type: Bool, default: FALSE¶: Enables half resolution loading. This requires that a dataset with the same filename and the postfix ‘_half’ exists. This dataset has to be of half the half the original image extent in x,y and z and needs to have the same datatype.

Hidden Fields¶

startTaskSynchronous¶

name: startTaskSynchronous, type: Trigger¶

taskVerboseLogging¶

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

taskFinished¶

name: taskFinished, type: Trigger¶

taskCanceled¶

name: taskCanceled, type: Trigger¶

taskRunning¶

name: taskRunning, type: Bool, persistent: no¶

progress¶

name: progress, type: Float, persistent: no¶

halfResolutionPostfix¶

name: halfResolutionPostfix, type: String, default: _half¶

halfResolutionFinished¶

name: halfResolutionFinished, type: Trigger¶