SaveImage

MacroModule
genre GUI
author MeVis Medical Solutions AG
package MeVisLab/Standard
definition dialogs.def
see also ImageSave, OpenImage, MakeName
keywords dicom, tiff, file, dialog

Purpose

The module SaveImage is specifically designed as a modal save image dialog inside an application, but it can also be used to save images within a network.

The dialog displays a list of files related to the input image and allows to select the target file from this list. Alternatively, the additional list entry NEW FILE can be selected to save the image into a new file with an automatically generated filename. A confirmation dialog is displayed before replacing an existing file.

Usage

Select an existing file from the list of related files in order to replace this file with the new image, or alternatively select the entry << NEW FILE >> in order to save the image as a new file.

The selected or automatically generated filename is displayed in the Filename field below the file list. Select the file format to be used from the Format pop-up menu and edit the file comment in the Comment field.

Press Options… to open a dialog with additional file format options for the DICOM and Tiff file formats.

Press Save to save the file to the current filename. If a file with this name already exists, a confirmation dialog is displayed. If the image could be successfully saved, the dialog is closed, otherwise an error message is displayed in the Status field. Press Cancel to close the dialog without saving the image.

Details

The set of files related to the source file is determined by removing the file format extension (e.g. .tif or .dcm) and an extension of the form .mlab### or .result### (where ### is a string of digits) from the source name. All files in the source path directory that begin with this base name are listed in the file list. The source path/base name is displayed above the list.

Windows

Default Panel

../../../Modules/Macros/Dialogs/mhelp/Images/Screenshots/SaveImage._default.png

Input Fields

inImage

name: inImage, type: Image, deprecated name: inputImage

Parameter Fields

Field Index

Comment: String progress: Float tiffTileY: Integer
dicomDerived: Bool result: Enum tiffTileYAuto: Bool
dicomMetaHeader: Bool Source Path: String  
dicomWindowCenter: Integer sourceName: String  
dicomWindowWidth: Integer Status: String  
Filename: String tiffCompression: Enum  
Format: Enum tiffTileX: Integer  
hideCancel: Bool tiffTileXAuto: Bool  

Visible Fields

Format

name: format, type: Enum, default: DICOMTIFF

Defines the target file format.

Values:

Title Name Deprecated Name
Tiff TIFF  
Raw RAW  
Quocmesh QUOCMESH  
Pnm PNM  
Png PNG  
Jpg JPG  
Dicom DICOM  
Bmp BMP  
Analyze Analyze  
DICOM/TIFF DICOMTIFF DICOM/TIFF

Comment

name: comment, type: String, default: MeVisLab

Sets a comment string that is saved with the image.

Source Path

name: pathBase, type: String

Shows a base path of files related to the source image file, derived from the source name

Filename

name: filename, type: String

Sets the file name.

Status

name: status, type: String, persistent: no

Shows status information.

Hidden Fields

sourceName

name: sourceName, type: String

progress

name: progress, type: Float, persistent: no

result

name: result, type: Enum, default: None

Values:

Title Name Deprecated Name
None None NONE
Cancel Cancel CANCEL
Success Success SUCCESS
Error Error ERROR

dicomMetaHeader

name: dicomMetaHeader, type: Bool, default: TRUE

dicomDerived

name: dicomDerived, type: Bool, default: TRUE

dicomWindowCenter

name: dicomWindowCenter, type: Integer, default: 0

dicomWindowWidth

name: dicomWindowWidth, type: Integer, default: 0

tiffCompression

name: tiffCompression, type: Enum, default: None

Values:

Title Name
None None
Packbits Packbits
Lzw LZW

tiffTileX

name: tiffTileX, type: Integer, default: 128

tiffTileY

name: tiffTileY, type: Integer, default: 128

tiffTileXAuto

name: tiffTileXAuto, type: Bool, default: TRUE

tiffTileYAuto

name: tiffTileYAuto, type: Bool, default: TRUE

hideCancel

name: hideCancel, type: Bool, default: FALSE