mitkRenderingController.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 mitkRenderingController_h
#define mitkRenderingController_h
 
#include <mitkDataStorageBridge.h>
#include <mitkRenderWindowBridge.h>
#include <mitkStorageThreadDispatcherBase.h>
#include <httplib.h>
 
#include <functional>
#include <mutex>
#include <optional>
#include <utility>
 
#include <MitkRESTAPIExports.h>
 
namespace mitk
{
 
  class MITKRESTAPI_EXPORT RenderingController
  {
  public:
    explicit RenderingController(DataStorageBridge& bridge);
 
    void SetDispatcher(StorageThreadDispatcherBase* dispatcher);
 
    void SetRenderWindowBridge(RenderWindowBridge* bridge);
 
    void HandlePOST_update(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePOST_reinit(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_selectedPosition(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_selectedPosition(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_selectedTime(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_selectedTime(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_editors(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiInfo(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiWindows(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiWindow(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiCamera(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_stdmultiCamera(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiSelectedSlice(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_stdmultiSelectedSlice(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiScreenshot(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_stdmultiWindowScreenshot(const httplib::Request& req, httplib::Response& res) const;
 
    // ---- MxN editor handlers ----
 
    void HandleGET_mxnInfo(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnWindows(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnWindow(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnLayout(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_mxnLayout(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnCamera(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_mxnCamera(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnSelectedSlice(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_mxnSelectedSlice(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnSelectedPosition(const httplib::Request& req, httplib::Response& res) const;
 
    void HandlePUT_mxnSelectedPosition(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnScreenshot(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_mxnWindowScreenshot(const httplib::Request& req, httplib::Response& res) const;
 
    void HandleGET_screenshot(const httplib::Request& req, httplib::Response& res) const;
 
  private:
    void Dispatch(std::function<void()> task) const;
 
    void SendErrorResponse(httplib::Response& res, int status, const nlohmann::json& error) const;
 
    static std::pair<int, nlohmann::json> MapBridgeException(
      const std::exception& e, const std::string& instance);
 
    static bool IsValidStdMultiWindowId(const std::string& id);
 
    static bool IsStdMulti3dWindow(const std::string& id);
 
    static std::string ReadRequiredPathParam(const httplib::Request& req,
                                             const std::string& key);
 
    DataStorageBridge& m_Bridge;
    RenderWindowBridge* m_RenderWindowBridge = nullptr;
    WeakPointer<StorageThreadDispatcherBase> m_Dispatcher;
    mutable std::mutex m_DispatcherMutex;
  };
}
 
#endif