MeVisLab Toolbox Reference
ml::MultiFileVolumeTools Namespace Reference

Functions

MLMULTI_FILE_VOLUME_EXPORT MultiFileVolumecreateMultiFileVolumeFromDCMTree (DCMTree::Const_TreePtr inputDCMTree, const DICOMCachedIOFileHandle &fileHandle, DicomMessageCollector &dcmMsgCollector)
 Converts inputDCMTree to a MultiFileVolume which is returned if conversion was successful. More...
 

Function Documentation

◆ createMultiFileVolumeFromDCMTree()

MLMULTI_FILE_VOLUME_EXPORT MultiFileVolume* ml::MultiFileVolumeTools::createMultiFileVolumeFromDCMTree ( DCMTree::Const_TreePtr  inputDCMTree,
const DICOMCachedIOFileHandle fileHandle,
DicomMessageCollector dcmMsgCollector 
)

Converts inputDCMTree to a MultiFileVolume which is returned if conversion was successful.

If the inputDCMTree was directly loaded from file then its path should be passed in fileHandle; especially DCMTrees which do not have own pixel data tags (as it is commonly done in MultiFileVolumes) require it, because otherwise the pixel data cannot be read from the created volume.

Parameters
inputDCMTreeThe Dicom tree for which the new MultiFileVolume shall be created. If nullptr then nullptr will be returned.
fileHandleMainly used for logging purposes and in other context as file name proposal; can be empty sometimes, but is strongly recommended to be passed as non-empty string if available.
dcmMsgCollectorCollects error, info and issue messages (typically related to a handle). Returns nullptr on a failed conversion.