mitkDataNode.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 mitkDataNode_h
#define mitkDataNode_h
 
#include <mitkBaseData.h>
#include <mitkDataInteractor.h>
#include <mitkIdentifiable.h>
#include <mitkIPropertyOwner.h>
 
#include <fstream>
#include <iostream>
 
#include <mitkColorProperty.h>
#include <mitkPropertyList.h>
#include <mitkStringProperty.h>
 
#include <mitkGeometry3D.h>
#include <mitkLevelWindow.h>
#include <map>
#include <set>
 
class vtkLinearTransform;
 
namespace mitk
{
  class BaseRenderer;
  class Mapper;
 
  itkEventMacroDeclaration(InteractorChangedEvent, itk::AnyEvent);
 
  class MITKCORE_EXPORT DataNode : public itk::DataObject, public IPropertyOwner
  {
  public:
    typedef mitk::Geometry3D::Pointer Geometry3DPointer;
    typedef std::vector<itk::SmartPointer<Mapper>> MapperVector;
    typedef std::map<std::string, mitk::PropertyList::Pointer> MapOfPropertyLists;
    typedef std::vector<MapOfPropertyLists::key_type> PropertyListKeyNames;
    typedef std::set<std::string> GroupTagList;
 
    mitkClassMacroItkParent(DataNode, itk::DataObject);
    itkFactorylessNewMacro(Self);
 
    // IPropertyProvider
 
    BaseProperty::ConstPointer GetConstProperty(const std::string &propertyKey, const std::string &contextName = "", bool fallBackOnDefaultContext = true) const override;
 
    std::vector<std::string> GetPropertyKeys(const std::string &contextName = "", bool includeDefaultContext = false) const override;
 
    std::vector<std::string> GetPropertyContextNames() const override;
 
    // IPropertyOwner
 
    BaseProperty * GetNonConstProperty(const std::string &propertyKey, const std::string &contextName = "", bool fallBackOnDefaultContext = true) override;
 
    void SetProperty(const std::string &propertyKey, BaseProperty *property, const std::string &contextName = "", bool fallBackOnDefaultContext = false) override;
 
    void RemoveProperty(const std::string &propertyKey, const std::string &contextName = "", bool fallBackOnDefaultContext = false) override;
 
    mitk::Mapper *GetMapper(MapperSlotId id) const;
 
    BaseData *GetData() const;
 
    template <typename T>
    T* GetDataAs() const
    {
      return dynamic_cast<T*>(this->GetData());
    }
 
    vtkLinearTransform *GetVtkTransform(int t = 0) const;
 
    virtual void SetData(mitk::BaseData *baseData);
 
    virtual void SetDataInteractor(const DataInteractor::Pointer interactor);
 
    virtual DataInteractor::Pointer GetDataInteractor() const;
 
    mitk::DataNode &operator=(const DataNode &right);
 
    mitk::DataNode &operator=(BaseData *right);
 
    virtual void SetMapper(MapperSlotId id, mitk::Mapper *mapper);
 
    void UpdateOutputInformation() override;
 
    void SetRequestedRegionToLargestPossibleRegion() override;
 
    bool RequestedRegionIsOutsideOfTheBufferedRegion() override;
 
    bool VerifyRequestedRegion() override;
 
    void SetRequestedRegion(const itk::DataObject *data) override;
 
    void CopyInformation(const itk::DataObject *data) override;
 
    PropertyListKeyNames GetPropertyListNames() const;
 
    void SetProperty(const char *propertyKey, BaseProperty *property, const mitk::BaseRenderer *renderer = nullptr);
 
    void ReplaceProperty(const char *propertyKey, BaseProperty *property, const mitk::BaseRenderer *renderer = nullptr);
 
    void AddProperty(const char *propertyKey,
                     BaseProperty *property,
                     const mitk::BaseRenderer *renderer = nullptr,
                     bool overwrite = false);
 
    mitk::PropertyList *GetPropertyList(const mitk::BaseRenderer *renderer = nullptr) const;
    mitk::PropertyList *GetPropertyList(const std::string &rendererName) const;
 
    void ConcatenatePropertyList(PropertyList *pList, bool replace = false);
 
    mitk::BaseProperty *GetProperty(const char *propertyKey, const mitk::BaseRenderer *renderer = nullptr, bool fallBackOnDataProperties = true) const;
 
    template <typename T>
    bool GetProperty(itk::SmartPointer<T> &property,
                     const char *propertyKey,
                     const mitk::BaseRenderer *renderer = nullptr) const
    {
      property = dynamic_cast<T *>(GetProperty(propertyKey, renderer));
      return property.IsNotNull();
    }
 
    template <typename T>
    bool GetProperty(T *&property, const char *propertyKey, const mitk::BaseRenderer *renderer = nullptr) const
    {
      property = dynamic_cast<T *>(GetProperty(propertyKey, renderer));
      return property != nullptr;
    }
 
    template <typename T>
    bool GetPropertyValue(const char *propertyKey, T &value, const mitk::BaseRenderer *renderer = nullptr) const
    {
      GenericProperty<T> *gp = dynamic_cast<GenericProperty<T> *>(GetProperty(propertyKey, renderer));
      if (gp != nullptr)
      {
        value = gp->GetValue();
        return true;
      }
      return false;
    }
 
    GroupTagList GetGroupTags() const;
 
    bool GetBoolProperty(const char *propertyKey, bool &boolValue, const mitk::BaseRenderer *renderer = nullptr) const;
 
    bool GetIntProperty(const char *propertyKey, int &intValue, const mitk::BaseRenderer *renderer = nullptr) const;
 
    bool GetFloatProperty(const char *propertyKey,
                          float &floatValue,
                          const mitk::BaseRenderer *renderer = nullptr) const;
 
    bool GetDoubleProperty(const char *propertyKey,
                           double &doubleValue,
                           const mitk::BaseRenderer *renderer = nullptr) const;
 
    bool GetStringProperty(const char *propertyKey,
                           std::string &string,
                           const mitk::BaseRenderer *renderer = nullptr) const;
 
    bool GetColor(float rgb[3], const mitk::BaseRenderer *renderer = nullptr, const char *propertyKey = "color") const;
 
    bool GetLevelWindow(mitk::LevelWindow &levelWindow,
                        const mitk::BaseRenderer *renderer = nullptr,
                        const char *propertyKey = "levelwindow") const;
 
    void SetSelected(bool selected, const mitk::BaseRenderer *renderer = nullptr);
 
    bool IsSelected(const mitk::BaseRenderer *renderer = nullptr);
 
    bool GetName(std::string &nodeName,
                 const mitk::BaseRenderer *renderer = nullptr,
                 const char *propertyKey = "name") const
    {
      return GetStringProperty(propertyKey, nodeName, renderer);
    }
 
    virtual std::string GetName() const
    {
      mitk::StringProperty *sp = dynamic_cast<mitk::StringProperty *>(this->GetProperty("name"));
      if (sp == nullptr)
        return "";
      return sp->GetValue();
    }
 
    static std::string NO_NAME_VALUE()
    {
      return "No Name!";
    }
 
    virtual void SetName(const char *name)
    {
      if (name == nullptr)
        return;
 
      auto* data = this->GetData();
 
      if (nullptr != data)
      {
        auto property = data->GetProperty("name");
 
        if (property.IsNotNull())
        {
          auto* stringProperty = dynamic_cast<StringProperty*>(property.GetPointer());
 
          if (nullptr != stringProperty)
          {
            stringProperty->SetValue(name);
            return;
          }
        }
      }
 
      this->SetStringProperty("name", name);
    }
    virtual void SetName(const std::string& name) { this->SetName(name.c_str()); }
    bool GetVisibility(bool &visible, const mitk::BaseRenderer *renderer, const char *propertyKey = "visible") const
    {
      return GetBoolProperty(propertyKey, visible, renderer);
    }
 
    bool GetOpacity(float &opacity, const mitk::BaseRenderer *renderer, const char *propertyKey = "opacity") const;
 
    bool IsOn(const char *propertyKey, const mitk::BaseRenderer *renderer, bool defaultIsOn = true) const
    {
      if (propertyKey == nullptr)
        return defaultIsOn;
      GetBoolProperty(propertyKey, defaultIsOn, renderer);
      return defaultIsOn;
    }
 
    bool IsVisible(const mitk::BaseRenderer *renderer,
                   const char *propertyKey = "visible",
                   bool defaultIsOn = true) const
    {
      return IsOn(propertyKey, renderer, defaultIsOn);
    }
 
    void SetColor(const mitk::Color &color,
                  const mitk::BaseRenderer *renderer = nullptr,
                  const char *propertyKey = "color");
 
    void SetColor(float red,
                  float green,
                  float blue,
                  const mitk::BaseRenderer *renderer = nullptr,
                  const char *propertyKey = "color");
 
    void SetColor(const float rgb[3], const mitk::BaseRenderer *renderer = nullptr, const char *propertyKey = "color");
 
    void SetVisibility(bool visible, const mitk::BaseRenderer *renderer = nullptr, const char *propertyKey = "visible");
 
    void SetOpacity(float opacity, const mitk::BaseRenderer *renderer = nullptr, const char *propertyKey = "opacity");
 
    void SetLevelWindow(mitk::LevelWindow levelWindow,
                        const mitk::BaseRenderer *renderer = nullptr,
                        const char *propertyKey = "levelwindow");
 
    void SetIntProperty(const char *propertyKey, int intValue, const mitk::BaseRenderer *renderer = nullptr);
 
    void SetBoolProperty(const char *propertyKey, bool boolValue, const mitk::BaseRenderer *renderer = nullptr);
 
    void SetFloatProperty(const char *propertyKey, float floatValue, const mitk::BaseRenderer *renderer = nullptr);
 
    void SetDoubleProperty(const char *propertyKey, double doubleValue, const mitk::BaseRenderer *renderer = nullptr);
 
    void SetStringProperty(const char *propertyKey, const char *string, const mitk::BaseRenderer *renderer = nullptr);
 
    itk::ModifiedTimeType GetMTime() const override;
 
    unsigned long GetDataReferenceChangedTime() const { return m_DataReferenceChangedTime.GetMTime(); }
 
  protected:
    DataNode();
 
    ~DataNode() override;
 
    virtual void PropertyListModified(const itk::Object *caller, const itk::EventObject &event);
 
    mutable MapperVector m_Mappers;
 
    BaseData::Pointer m_Data;
 
    PropertyList::Pointer m_PropertyList;
 
    mutable MapOfPropertyLists m_MapOfPropertyLists;
 
    DataInteractor::Pointer m_DataInteractor;
 
    itk::TimeStamp m_DataReferenceChangedTime;
 
    unsigned long m_PropertyListModifiedObserverTag;
  };
 
  MITKCORE_EXPORT std::istream &operator>>(std::istream &i, DataNode::Pointer &dtn);
 
  MITKCORE_EXPORT std::ostream &operator<<(std::ostream &o, DataNode::Pointer &dtn);
} // namespace mitk
 
#endif