Derived importer to import non DICOM files into DirectDicomImport. More...

#include <mlDirectDicomImportOtherImporter.h>

Inheritance diagram for ml::DirectDicomImportOtherImporter:

Public Member Functions
	DirectDicomImportOtherImporter (DirectDicomImport &ddiOp)
	Constructor using a DirectDicomImport instance associated with.

	~DirectDicomImportOtherImporter () override
	Destructor.

void	appendFields (FieldContainer &fieldContainer) override
	Creates and appends all parameter fields for this importer. To be called in constructor.

void	handleNotification (Field &field) override
	Handles changes of fields added by appendFields.

void	import (const FileListTools::FileList &fileList) override
	Builds MultiFileVolume(s) from files provided by fileList.

Public Member Functions inherited from ml::DirectDicomImportImporterBase
	DirectDicomImportImporterBase (DirectDicomImport &ddiOp)
	Constructor using a DirectDicomImport instance associated with.

	~DirectDicomImportImporterBase () override
	Destructor.

void	updateProgressIndicator (const std::string &info, float percState) override
	Update a progress indicator which shows the message info and the percentage percState.

void	_updateConsole (bool fullUpdate=true) override
	Updates the output console if there is any.

virtual DicomConfigurableMessageFilterBaseRefCountedPtr	getMessageCollector () const
	Privides access to the message collector of the internally referenced DDI instance.

Public Member Functions inherited from ml::ProgressLogger
	ProgressLogger (std::stringstream outputStream=nullptr, NotifyField intCheckField=nullptr, StringField *statusField=nullptr, bool useRichTextCoding=true)
	Default and convenience constructor.

virtual	~ProgressLogger ()
	Destructor.

void	setAutoNewLineTermination (bool on)
	Enable/disable automatic newline termination of logged messages.

bool	isAutoNewLineTerminationOn () const
	Returns enabled/disabled automatic newline termination of logged messages.

virtual bool	messageHook (const ProgressLogger &, MLMessageType, const std::string , const std::string , MLErrorCode , const std::string , unsigned int *)
	All logging methods pass their function arguments through this hook which allows to collect all messages sent to the ProgressLogger.

void	logAnyMessage (std::string msg, unsigned int formatFlags=NoFlags)
	Log any string into the console.

void	logFatalError (const std::string &func, MLErrorCode err, const std::string &reason)
	Logs a fatal error, an error, warning or information to the defined output stream/console.

void	logError (const std::string &func, MLErrorCode err, const std::string &reason)
	See logFatalError() for details.

void	logWarning (const std::string &func, MLErrorCode err, const std::string &reason)
	See logFatalError() for details.

void	logInfo (const std::string &func, const std::string &reason="")
	Same as logFatalError, logError, and logWarning, but logging only information without error.

void	logFullFatalError (const std::string &func, MLErrorCode err, const std::string &reason)
	Logs a fatal error, an error, warning or information to the defined output stream/console and sends the information also to the MeVisLab error handler.

void	logFullError (const std::string &func, MLErrorCode err, const std::string &reason)
	See logFullFatalError() for details.

void	logFullWarning (const std::string &func, MLErrorCode err, const std::string &reason)
	See logFullFatalError() for details.

void	logFullInfo (const std::string &func, const std::string &reason)
	Same as logFullFatalError, logFullError, and logFullWarning, but logging only information without error.

bool	getRichTextCodingFlag () const
	If enabled (the default) then outputs newlines are always converted to hyper/rich text line separators ( ) and different message types get different colors; if false then contents they are always converted to normal newline characters and rich/hypertext color statements are not inserted.

void	setRichTextCodingFlag (bool useRichTextCoding)
	See getRichTextCodingFlag() for details.

bool	getUpdateProgressDuringInterruptChecksFlag () const
	If enabled then progress updates are performed on each interrupt check; this is useful to enable the busy cursor together with interrupt checks.

void	setUpdateProgressDuringInterruptChecksFlag (bool callUpdateProgressDuringInterruptChecks)
	See getUpdateProgressDuringInterruptChecksFlag() for details.

void	setStatusUpdateTimeIntervalInSeconds (double checkIntervalInSeconds)
	Sets a time interval which is used to avoid that too many Module::updateProgress() calls are performed to update the user interfaces (which usually are very expensive); default is 1 second.

double	getStatusUpdateTimeIntervalInSeconds () const
	Returns the currently set Module::updateProgress() call time interval when status fields are updated.

void	setCheckTimeIntervalInSeconds (double checkIntervalInSeconds)
	Sets a time interval which is used to avoid that too many interruption checks are performed which usually are very expensive, default is 1 second.

double	getCheckTimeIntervalInSeconds () const
	Returns the currently set interrupt check time interval.

void	setInterruptCheckFunction (InterruptCheckFunc checkFunc, void *userData)
	Set a function which actually does a check for interrupts and its user data.

InterruptCheckFunc	getInterruptCheckFunction () const
	Returns the currently set function for interrupt checks.

void *	getInterruptCheckFunctionUserData () const
	Returns the currently set user data pointer for interrupt checks.

void	setInterruptCheckField (NotifyField *interruptField=nullptr)
	Set a NotifyField which shall be checked for button presses which mean interruptions; ignored if nullptr.

NotifyField *	getInterruptCheckField () const
	Return the currently set NotifyField pointer which shall be checked for button presses; default is nullptr.

void	setStatusField (StringField *statusField)
	Set a StringField which always shall be updated with all logged messages; ignored if nullptr.

StringField *	getStatusField () const
	Return the currently set StringField pointer which is updated on logged messages; default is nullptr.

virtual bool	wasInterrupted ()
	If the interruption flag is already set then immediately true is returned.

virtual bool	getInterruptedFlag () const
	Returns current state of interruption flag (but does not check for interruption).

virtual void	setInterruptedFlag (bool wasInterrupted)
	Sets current state of interruption flag (but does not check for interruption).

virtual bool	orToInterruptedFlag (bool wasInterrupted)
	Update interruption flag by ORing the passed flag to the internal flag and then returning the flag (but does not check for interruption).

void	setHadFlags (bool hadFlag)
	Sets all had*Flags to hadFlag.

void	setFatalErrorMessagePrefix (const std::string &msg)
	Set/get prefixes for messages.

void	setErrorMessagePrefix (const std::string &msg)

void	setWarningMessagePrefix (const std::string &msg)

void	setInfoMessagePrefix (const std::string &msg)

std::string	getFatalErrorMessagePrefix () const

std::string	getErrorMessagePrefix () const

std::string	getWarningMessagePrefix () const

std::string	getInfoMessagePrefix () const

bool	hadFatalError () const
	Returns true if any fatal error, error, warning or info was logged; can be reset with corresponding setHad*Flag().

bool	hadError () const

bool	hadWarning () const

bool	hadInfo () const

void	setHadFatalErrorFlag (bool hadFatalErrorFlag)
	Sets the state of the corresponding _had* member; used to clear recent logging states.

void	setHadErrorFlag (bool hadErrorFlag)

void	setHadWarningFlag (bool hadWarningFlag)

void	setHadInfoFlag (bool hadInfoFlag)

Protected Member Functions
virtual void	_determineProperties (const FileListTools::FileList &fileList, std::vector< _FilePropHelper > &filePropVec, float progressStart, float progressEnd)
	Determine a vector of image properties and file names of loadable files.

virtual void	_propertySort (std::vector< _FilePropHelper > &filePropVec)
	Sort filePropVec according image extent and file name given by the vector entries.

virtual size_t	_composeAndAppendVolumes (const std::vector< _FilePropHelper > &filePropVec, const FileListTools::FileList &fileList, DicomMessageCollector &dcmMsgCollector)
	Compose same sized images with same voxel type of entries in filePropVec to volumes and append those volume to the volume list; all other images are appended as single volumes.

virtual void	_postProcessVolumes (size_t lastNumVolumesToProcess)
	Some settings can be set up best after full composition of the volumes, for example storing the image meta data in MultiFileVolume options; this function processes the most recent lastNumVolumesToProcess in _getOutVolumeList().

virtual void	_appendMetaData (ImagePropertyExtensionContainer &imgPropContainer, const std::string &metaData, const std::string &fileName)
	Append tag dump (and file name for entry when it's created) to an ImagePropertyExtension entry.

virtual void	_appendNewDirectVolumeReferenceFromFilePropHelper (const _FilePropHelper &fileProp, const FileListTools::FileList &fileList, DicomMessageCollector &dcmMsgCollector)
	Creates and append a new DirectDicomVolumeReference with settings from a _FilePropHelper.

Protected Member Functions inherited from ml::DirectDicomImportImporterBase
virtual MultiFileVolumeList &	_getOutVolumeList ()
	Modifiable list of DirectDicomImportVolumeReferences to which new volumes are going to be appended during the import process.

Protected Member Functions inherited from ml::ProgressLogger
std::string	_doAutoNewLineTerminate (const std::string &msg) const
	Helper to terminate msg with newline at end according.

virtual bool	_isStopPressed () const
	Checks for interruption with currently set _checkFunc or _interruptCheckField or returns false if not available.

Additional Inherited Members
Public Types inherited from ml::ProgressLogger
enum	FormatFlags { NoFlags = 0 , Bold = 1 , Green = 2 , Yellow = 4 , Red = 8 , Blue = 16 }
	Enumerator describing some formatting flags. More...

typedef bool(*	InterruptCheckFunc) (void *userData)
	Function type to check to for an interruption.

Static Public Member Functions inherited from ml::ProgressLogger
static bool	isPressedField (NotifyField *fieldToCheck)
	Convenience implementation of an interrupt check function if user of this class does not want to implement his own check callback but only wants to check a NotifyField for presses.

Static Protected Member Functions inherited from ml::ProgressLogger
static void	_updateProgressIndicatorCB (void *userData, const std::string &info, float state)
	Static callback version to update a progress indicator about the current import state.

Detailed Description

Derived importer to import non DICOM files into DirectDicomImport.

Definition at line 29 of file mlDirectDicomImportOtherImporter.h.

Constructor & Destructor Documentation

◆ DirectDicomImportOtherImporter()

ml::DirectDicomImportOtherImporter::DirectDicomImportOtherImporter ( DirectDicomImport & ddiOp )

Constructor using a DirectDicomImport instance associated with.

◆ ~DirectDicomImportOtherImporter()

ml::DirectDicomImportOtherImporter::~DirectDicomImportOtherImporter ( )

override

Destructor.

Member Function Documentation

◆ _appendMetaData()

virtual void ml::DirectDicomImportOtherImporter::_appendMetaData	(	ImagePropertyExtensionContainer &	imgPropContainer,
		const std::string &	metaData,
		const std::string &	fileName )

protectedvirtual

Append tag dump (and file name for entry when it's created) to an ImagePropertyExtension entry.

Parameters

imgPropContainer	The container to which the entry is added if it still does not exist, otherwise the first StringImagePropertyExtension will be used.
metaData	The meta data string to be set in first entry or to be appended if the extension already exists.
fileName	The file name to be set if the extension entry is not found and created.

◆ _appendNewDirectVolumeReferenceFromFilePropHelper()

virtual void ml::DirectDicomImportOtherImporter::_appendNewDirectVolumeReferenceFromFilePropHelper	(	const _FilePropHelper &	fileProp,
		const FileListTools::FileList &	fileList,
		DicomMessageCollector &	dcmMsgCollector )

protectedvirtual

Creates and append a new DirectDicomVolumeReference with settings from a _FilePropHelper.

Parameters

fileProp	The file property providing basic information (such as file name, image properties, format etc.) used to initialize the newly created and appended VolumeReference.
fileList	The list of files and their properties from which the volume was/is created.
dcmMsgCollector	Collects error, info and issue messages (typically related to a handle).

◆ _composeAndAppendVolumes()

virtual size_t ml::DirectDicomImportOtherImporter::_composeAndAppendVolumes	(	const std::vector< _FilePropHelper > &	filePropVec,
		const FileListTools::FileList &	fileList,
		DicomMessageCollector &	dcmMsgCollector )

protectedvirtual

Compose same sized images with same voxel type of entries in filePropVec to volumes and append those volume to the volume list; all other images are appended as single volumes.

Parameters

filePropVec	The vector of file properties whose elements shall be composed to groups of same sized volumes.
fileList	The list of files and their properties from which the volume was/is created.
dcmMsgCollector	Collects error, info and issue messages (typically related to a handle).

Returns: The number of newly added MultiFileVolumes.

◆ _determineProperties()

virtual void ml::DirectDicomImportOtherImporter::_determineProperties	(	const FileListTools::FileList &	fileList,
		std::vector< _FilePropHelper > &	filePropVec,
		float	progressStart,
		float	progressEnd )

protectedvirtual

Determine a vector of image properties and file names of loadable files.

Parameters

fileList	ImageVector containing all files potentially including suppressed and DICOM files.
filePropVec	A vector of image properties together with file names first cleared and then filled with image properties and file names of loadable files.
progressStart	Start of the display range of the progress indicator.
progressEnd	End of the display range of the progress indicator.

◆ _postProcessVolumes()

virtual void ml::DirectDicomImportOtherImporter::_postProcessVolumes ( size_t lastNumVolumesToProcess )

protectedvirtual

Some settings can be set up best after full composition of the volumes, for example storing the image meta data in MultiFileVolume options; this function processes the most recent lastNumVolumesToProcess in _getOutVolumeList().

If std::string::npos is passed then all volumes will be post processed.

◆ _propertySort()

virtual void ml::DirectDicomImportOtherImporter::_propertySort ( std::vector< _FilePropHelper > & filePropVec )

protectedvirtual

Sort filePropVec according image extent and file name given by the vector entries.

◆ appendFields()

void ml::DirectDicomImportOtherImporter::appendFields ( FieldContainer & fieldContainer )

overridevirtual

Creates and appends all parameter fields for this importer. To be called in constructor.

Reimplemented from ml::DirectDicomImportImporterBase.

◆ handleNotification()

void ml::DirectDicomImportOtherImporter::handleNotification ( Field & field )

overridevirtual

Handles changes of fields added by appendFields.

Reimplemented from ml::DirectDicomImportImporterBase.

◆ import()

void ml::DirectDicomImportOtherImporter::import ( const FileListTools::FileList & fileList )

overridevirtual

Builds MultiFileVolume(s) from files provided by fileList.

Parameters

fileList Manager for a map of file names associated with filter attributes. after import with perhaps updated file attributes.

Implements ml::DirectDicomImportImporterBase.

The documentation for this class was generated from the following file:

FMEstable/ReleaseMeVis/Projects/DICOM/MLDirectDicomImport/Sources/mlDirectDicomImportOtherImporter.h

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DirectDicomImportOtherImporter()

◆ ~DirectDicomImportOtherImporter()

Member Function Documentation

◆ _appendMetaData()

◆ _appendNewDirectVolumeReferenceFromFilePropHelper()

◆ _composeAndAppendVolumes()

◆ _determineProperties()

◆ _postProcessVolumes()

◆ _propertySort()

◆ appendFields()

◆ handleNotification()

◆ import()