mitkDICOMReaderConfigurator.h

Go to the documentation of this file.

/*============================================================================

The Medical Imaging Interaction Toolkit (MITK)

Copyright (c) German Cancer Research Center (DKFZ)
All rights reserved.

Use of this source code is governed by a 3-clause BSD license that can be
found in the LICENSE file.

============================================================================*/

#ifndef mitkDICOMReaderConfigurator_h
#define mitkDICOMReaderConfigurator_h

#include "mitkClassicDICOMSeriesReader.h"
#include "mitkDICOMTagBasedSorter.h"

// to put into private implementation
#include "tinyxml.h"

namespace mitk
{

class MITKDICOMREADER_EXPORT DICOMReaderConfigurator : public itk::LightObject
{
  public:

    mitkClassMacroItkParent( DICOMReaderConfigurator, itk::LightObject );
    itkNewMacro( DICOMReaderConfigurator );

    DICOMFileReader::Pointer CreateFromConfigFile(const std::string& filename) const;
    DICOMFileReader::Pointer CreateFromUTF8ConfigString(const std::string& xmlContents) const;

    std::string CreateConfigStringFromReader(DICOMFileReader::ConstPointer reader) const;

  protected:

    DICOMReaderConfigurator();
    ~DICOMReaderConfigurator() override;

  private:

    DICOMFileReader::Pointer CreateFromTiXmlDocument(TiXmlDocument& doc) const;
    DICOMTag tagFromXMLElement(TiXmlElement*) const;
    std::string requiredStringAttribute(TiXmlElement* xmlElement, const std::string& key) const;
    unsigned int hexStringToUInt(const std::string& s) const;

    ThreeDnTDICOMSeriesReader::Pointer ConfigureThreeDnTDICOMSeriesReader(ThreeDnTDICOMSeriesReader::Pointer reader, TiXmlElement*) const;
    DICOMITKSeriesGDCMReader::Pointer ConfigureDICOMITKSeriesGDCMReader(DICOMITKSeriesGDCMReader::Pointer reader, TiXmlElement*) const;
    void ConfigureCommonPropertiesOfDICOMITKSeriesGDCMReader(DICOMITKSeriesGDCMReader::Pointer reader, TiXmlElement* element) const;
    void ConfigureCommonPropertiesOfThreeDnTDICOMSeriesReader(ThreeDnTDICOMSeriesReader::Pointer reader, TiXmlElement* element) const;

    DICOMSortCriterion::Pointer CreateDICOMSortByTag(TiXmlElement* xmlElement, DICOMSortCriterion::Pointer secondaryCriterion) const;
    DICOMSortCriterion::Pointer CreateSortByImagePositionPatient(TiXmlElement* xmlElement, DICOMSortCriterion::Pointer secondaryCriterion) const;

    mitk::DICOMTagBasedSorter::Pointer CreateDICOMTagBasedSorter(TiXmlElement* element) const;

    TiXmlElement* CreateConfigStringFromReader(const DICOMITKSeriesGDCMReader* reader) const;
    TiXmlElement* CreateConfigStringFromReader(const ThreeDnTDICOMSeriesReader* reader) const;
    TiXmlElement* CreateConfigStringFromReader(const ClassicDICOMSeriesReader* reader) const;

    TiXmlElement* CreateConfigStringFromDICOMDatasetSorter(const DICOMTagBasedSorter* sorter) const;

    TiXmlElement* CreateConfigStringFromDICOMTag(const DICOMTag& tag) const;

    TiXmlElement* CreateDICOMFileReaderTag(const DICOMFileReader* reader) const;
    const char* toString(bool) const;
    std::string toHexString(unsigned int i) const;

    bool QueryBooleanAttribute(const TiXmlElement* element, const char* attributeName, bool defaultValue) const;
 };

} // namespace

#endif // mitkDICOMReaderConfigurator_h