QmitkMxNMultiWidget.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 QmitkMxNMultiWidget_h
#define QmitkMxNMultiWidget_h
 
#include <MitkQtWidgetsExports.h>
 
// qt widgets module
#include <QmitkAbstractMultiWidget.h>
#include <QmitkSynchronizedNodeSelectionWidget.h>
#include <QmitkSynchronizedWidgetConnector.h>
 
#include <nlohmann/json.hpp>
 
#include <map>
#include <set>
#include <string>
#include <utility>
#include <vector>
 
class QSplitter;
 
class MITKQTWIDGETS_EXPORT QmitkMxNMultiWidget : public QmitkAbstractMultiWidget
{
  Q_OBJECT
 
public:
 
  QmitkMxNMultiWidget(QWidget* parent = nullptr,
                      Qt::WindowFlags f = {},
                      const QString& multiWidgetName = "mxn");
 
  ~QmitkMxNMultiWidget();
 
  void InitializeMultiWidget() override;
 
  void Synchronize(bool synchronized) override;
 
  QmitkRenderWindow* GetRenderWindow(const QString& widgetName) const override;
  QmitkRenderWindow* GetRenderWindow(const mitk::AnatomicalPlane& orientation) const override;
 
  void SetActiveRenderWindowWidget(RenderWindowWidgetPointer activeRenderWindowWidget) override;
 
  void InitializeViews(const mitk::TimeGeometry* geometry, bool resetCamera) override;
 
  void SetInteractionReferenceGeometry(const mitk::TimeGeometry* referenceGeometry) override;
 
  bool HasCoupledRenderWindows() const override;
 
  void SetSelectedPosition(const mitk::Point3D& newPosition, const QString& widgetName) override;
  const mitk::Point3D GetSelectedPosition(const QString& widgetName) const override;
 
  void SetCrosshairVisibility(bool visible) override;
  bool GetCrosshairVisibility() const override;
  void SetCrosshairGap(unsigned int gapSize) override;
 
  void ResetCrosshair() override;
 
  void SetWidgetPlaneMode(int userMode) override;
 
  mitk::SliceNavigationController* GetTimeNavigationController();
 
  void EnableCrosshair();
  void DisableCrosshair();
 
  using GroupSyncIndexType = int;
 
  void AddSynchronizationGroup(const GroupSyncIndexType index, const std::string& name = std::string());
 
  void SetSynchronizationGroup(QmitkSynchronizedNodeSelectionWidget* synchronizedWidget, const GroupSyncIndexType index);
 
  GroupSyncIndexType NextFreeSyncGroupIndex() const;
 
  RenderWindowWidgetPointer CreateRenderWindowWidget(const QString& id);
 
  nlohmann::json SerializeLayout() const;
 
  struct WindowDescriptor
  {
    QString id;              // canonical fully-qualified window id
    QString displayName;     // optional human-readable label, empty when absent
    QString viewDirection;   // "axial" | "sagittal" | "coronal" | "original"
    QString selectionGroup;  // links.selection group label
  };
 
  std::vector<WindowDescriptor> ListWindowDescriptors() const;
 
  void ApplyLayout(const nlohmann::json& doc);
 
public Q_SLOTS:
 
  // mouse events
  void wheelEvent(QWheelEvent* e) override;
  void mousePressEvent(QMouseEvent* e) override;
  void moveEvent(QMoveEvent* e) override;
 
  void LoadLayout(const nlohmann::json* jsonData);
 
  void SaveLayout(std::ostream* outStream);
 
  void SetDataBasedLayout(const QmitkAbstractNodeSelectionWidget::NodeList& nodes);
 
  void OnCreateNewSyncGroupRequested(QmitkSynchronizedNodeSelectionWidget* synchronizedWidget);
 
Q_SIGNALS:
 
  void WheelMoved(QWheelEvent *);
  void Moved();
  void UpdateUtilityWidgetViewPlanes();
  void LayoutChanged();
  void SyncGroupAdded(const GroupSyncIndexType index);
 
protected:
 
  QmitkSynchronizedWidgetConnector* GetSyncGroupConnector(const GroupSyncIndexType index) const;
 
  std::size_t GetSyncGroupCount() const;
 
private:
 
  void SetLayoutImpl() override;
  void SetInteractionSchemeImpl() override { }
 
  void ValidateIdsForThisEditor(const nlohmann::json& doc) const;
 
  QmitkAbstractMultiWidget::RenderWindowWidgetPointer CreateRenderWindowWidget();
 
  QmitkAbstractMultiWidget::RenderWindowWidgetPointer GetWindowFromIndex(size_t index);
 
  nlohmann::json SerializeSplitter(const QSplitter* splitter,
                                   const std::map<GroupSyncIndexType, std::string>& groupNames) const;
 
  WindowDescriptor MakeWindowDescriptor(const QmitkRenderWindowWidget* cell) const;
 
  QSplitter* BuildSplitterFromJsonV2(const nlohmann::json& splitNode,
                                     const std::map<std::string, GroupSyncIndexType>& nameToInt,
                                     QSplitter* parentSplitter);
 
  void SeedAndNormalizeGroups(
    const std::vector<std::pair<std::string, std::string>>& seedingOrder,
    const std::map<std::string, GroupSyncIndexType>& nameToInt);
 
  void TearDownAllCells();
 
  void RollBackToSingleDefaultCell();
 
  std::map < GroupSyncIndexType, std::unique_ptr<QmitkSynchronizedWidgetConnector> > m_SynchronizedWidgetConnectors;
 
  std::map<GroupSyncIndexType, std::string> m_GroupNameByIndex;
 
  std::string m_LayoutName;
 
  bool m_CrosshairVisibility;
 
};
 
#endif