Medical Imaging Interaction Toolkit  2016.11.0
Medical Imaging Interaction Toolkit
mitk::DICOMTagScanner Class Referenceabstract

Abstracts the tag scanning process for a set of DICOM files. More...

#include <mitkDICOMTagScanner.h>

Inheritance diagram for mitk::DICOMTagScanner:
Collaboration diagram for mitk::DICOMTagScanner:

Public Member Functions

 mitkClassMacroItkParent (DICOMTagScanner, itk::Object)
 
virtual void AddTag (const DICOMTag &tag)=0
 Add this tag to the scanning process. More...
 
virtual void AddTags (const DICOMTagList &tags)=0
 Add a list of tags to the scanning process. More...
 
virtual void AddTagPath (const DICOMTagPath &path)=0
 Add this tag path to the scanning process. More...
 
virtual void AddTagPaths (const DICOMTagPathList &paths)=0
 Add a list of tag pathes to the scanning process. More...
 
virtual void SetInputFiles (const StringList &filenames)=0
 Define the list of files to scan. This does not ADD to an internal list, but it replaces the whole list of files. More...
 
virtual void Scan ()=0
 Start the scanning process. Calling Scan() will invalidate previous scans, forgetting all about files and tags from files that have been scanned previously. More...
 
virtual DICOMDatasetAccessingImageFrameList GetFrameInfoList () const =0
 Retrieve a result list for file-by-file tag access. More...
 
virtual DICOMTagCache::Pointer GetScanCache () const =0
 Retrieve Pointer to the complete cache of the scan. More...
 

Protected Member Functions

void PushLocale () const
 Remember current locale on stack, activate "C" locale. "C" locale is required for correct parsing of numbers by itk::ImageSeriesReader. More...
 
void PopLocale () const
 Activate last remembered locale from locale stack "C" locale is required for correct parsing of numbers by itk::ImageSeriesReader. More...
 
 DICOMTagScanner ()
 
virtual ~DICOMTagScanner ()
 

Static Protected Member Functions

static std::string GetActiveLocale ()
 Return active C locale. More...
 

Detailed Description

Abstracts the tag scanning process for a set of DICOM files.

Formerly integrated as a part of DICOMITKSeriesGDCMReader, the tag scanning part has been factored out into DICOMTagScanner classes in order to allow a single scan for multiple reader alternatives. This helps much in the selection process of e.g. DICOMFileReaderSelector.

This is an abstract base class for concrete scanner implementations.

Remarks
When used in a process where multiple classes will access the scan results, care should be taken that all the tags and files of interest are communicated to DICOMTagScanner before requesting the results!

Definition at line 46 of file mitkDICOMTagScanner.h.

Constructor & Destructor Documentation

mitk::DICOMTagScanner::DICOMTagScanner ( )
protected

Definition at line 21 of file mitkDICOMTagScanner.cpp.

mitk::DICOMTagScanner::~DICOMTagScanner ( )
protectedvirtual

Definition at line 26 of file mitkDICOMTagScanner.cpp.

Member Function Documentation

virtual void mitk::DICOMTagScanner::AddTag ( const DICOMTag tag)
pure virtual

Add this tag to the scanning process.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

virtual void mitk::DICOMTagScanner::AddTagPath ( const DICOMTagPath path)
pure virtual

Add this tag path to the scanning process.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

virtual void mitk::DICOMTagScanner::AddTagPaths ( const DICOMTagPathList paths)
pure virtual

Add a list of tag pathes to the scanning process.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

virtual void mitk::DICOMTagScanner::AddTags ( const DICOMTagList tags)
pure virtual

Add a list of tags to the scanning process.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

std::string mitk::DICOMTagScanner::GetActiveLocale ( )
staticprotected

Return active C locale.

Definition at line 73 of file mitkDICOMTagScanner.cpp.

virtual DICOMDatasetAccessingImageFrameList mitk::DICOMTagScanner::GetFrameInfoList ( ) const
pure virtual

Retrieve a result list for file-by-file tag access.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

virtual DICOMTagCache::Pointer mitk::DICOMTagScanner::GetScanCache ( ) const
pure virtual

Retrieve Pointer to the complete cache of the scan.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

mitk::DICOMTagScanner::mitkClassMacroItkParent ( DICOMTagScanner  ,
itk::Object   
)
void mitk::DICOMTagScanner::PopLocale ( ) const
protected

Activate last remembered locale from locale stack "C" locale is required for correct parsing of numbers by itk::ImageSeriesReader.

Definition at line 46 of file mitkDICOMTagScanner.cpp.

References MITK_WARN.

void mitk::DICOMTagScanner::PushLocale ( ) const
protected

Remember current locale on stack, activate "C" locale. "C" locale is required for correct parsing of numbers by itk::ImageSeriesReader.

Definition at line 30 of file mitkDICOMTagScanner.cpp.

virtual void mitk::DICOMTagScanner::Scan ( )
pure virtual

Start the scanning process. Calling Scan() will invalidate previous scans, forgetting all about files and tags from files that have been scanned previously.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.

virtual void mitk::DICOMTagScanner::SetInputFiles ( const StringList filenames)
pure virtual

Define the list of files to scan. This does not ADD to an internal list, but it replaces the whole list of files.

Implemented in mitk::DICOMGDCMTagScanner, and mitk::DICOMDCMTKTagScanner.


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