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 for loading an image asynchronously. The module outputs the entire 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¶: When pressed, the module loads the image.

Cancel¶

name: cancelTask, type: Trigger¶: When pressed, the module cancels the loading.

Status¶

name: status, type: String, persistent: no¶: Shows the current status.

Clear¶

name: clear, type: Trigger¶: When pressed, the module clears the image.

Loading Finished¶

name: loadingFinished, type: Bool, persistent: no¶: Shows whether 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¶: Sets the filename of the image.

Enable Half Resolution¶

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

If checked, half-resolution loading is enabled.

This requires the existence of a dataset with the same filename and the postfix ‘_half.’ The dataset must have half the original image extent in x, y, and z, and it must retain the same data type.

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¶