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