GUIHelpers.h

Go to the documentation of this file.

// Copyright (c) 2002-2023, The OpenMS Team -- EKU Tuebingen, ETH Zurich, and FU Berlin
// SPDX-License-Identifier: BSD-3-Clause
//
// --------------------------------------------------------------------------
// $Maintainer: Chris Bielow $
// $Authors: Chris Bielow $
// --------------------------------------------------------------------------
 
#pragma once
 
#include <OpenMS/VISUAL/OpenMS_GUIConfig.h>
#include <OpenMS/DATASTRUCTURES/ListUtils.h>
#include <OpenMS/FORMAT/FileHandler.h>
 
// declare Qt classes OUTSIDE of namespace OpenMS!
class QPainter;
class QPoint;
class QRectF;
class QString; 
class QStringList;
class QWidget;
 
#include <QColor>
#include <QFont>
 
#include <array>
 
namespace OpenMS
{
 
  class FileTypeList;
 
  namespace GUIHelpers
  {        
    OPENMS_GUI_DLLAPI void openFolder(const QString& folder);
 
 
    OPENMS_GUI_DLLAPI QString getSaveFilename(QWidget* parent,
                                              const QString& caption,
                                              const QString& dir,
                                              const FileTypeList& supported_file_types, 
                                              bool add_all_filter,
                                              const FileTypes::Type fallback_extension);
 
 
    OPENMS_GUI_DLLAPI void startTOPPView(const QStringList& args);
 
    OPENMS_GUI_DLLAPI void openURL(const QString& target);
 
    OPENMS_GUI_DLLAPI void drawText(QPainter& painter, const QStringList& text, const QPoint& where, const QColor& col_fg = QColor("invalid"), const QColor& col_bg = QColor("invalid"),
                                   const QFont& font = QFont("Courier"));
 
 
    OPENMS_GUI_DLLAPI QRectF getTextDimension(const QStringList& text, const QFont& font, int& line_spacing);
 
 
    OPENMS_GUI_DLLAPI QPointF nearestPoint(const QPointF& origin, const QList<QPointF>& list);
 
    OPENMS_GUI_DLLAPI QPointF intersectionPoint(const QRectF& rect, const QPointF& p);
 
 
    class OPENMS_GUI_DLLAPI OverlapDetector
    {
    public:
      explicit OverlapDetector(int levels);
 
      size_t placeItem(double x_start, double x_end);
 
    private:
      std::vector<double> rows_; 
    };
 
    class OPENMS_GUI_DLLAPI GUILock
    {
    public:
      GUILock(QWidget* gui);
 
      GUILock(const GUILock& rhs) = delete;
      GUILock(GUILock&& rhs) = delete;
      GUILock& operator=(const GUILock& rhs) = delete;
 
      ~GUILock();
      
      void lock();
      void unlock();
 
    private:
      QWidget* locked_widget_{ nullptr };
      bool currently_locked_{ false };
      bool was_enabled_{ true };
    };
 
    class ColorBrewer
    {
    public:
      struct Distinct
      {
        enum NAMES
        {
          Red,
          Blue,
          Green,
          Brown,
          Purple,
          LightGrey,
          LightGreen,
          LightBlue,
          Cyan,
          Orange,
          Yellow,
          Tan,
          Pink,
          DarkGrey,
          SIZE_OF_NAMES
        };
 
        const std::array<QColor, NAMES::SIZE_OF_NAMES> values = { { Qt::red,
                                                                    Qt::blue,
                                                                    Qt::green,
                                                                    QColor(129, 74, 25) /*brown*/,
                                                                    QColor(129, 38, 192) /*purple*/,
                                                                    Qt::lightGray,
                                                                    QColor(129,197,122) /*lightGreen*/,
                                                                    QColor(157,175,255) /*lightBlue*/,
                                                                    Qt::cyan,
                                                                    QColor(255,146,51) /*orange*/,
                                                                    Qt::yellow,
                                                                    QColor(233,222,187) /*tan*/,
                                                                    QColor(255,205,243) /*pink*/,
                                                                    Qt::darkGray } };
      };
 
      template<class COLOR_CLASS>
      static QColor getColor(uint32_t index)
      {
        // cycle if necessary
        if (index >= COLOR_CLASS::NAMES::SIZE_OF_NAMES) index = index % COLOR_CLASS::NAMES::SIZE_OF_NAMES;
        return COLOR_CLASS().values[index];
      }
    }; // ColorBrewer
 
    OPENMS_GUI_DLLAPI StringList convert(const QStringList& in);
    OPENMS_GUI_DLLAPI QStringList convert(const StringList& in);
 
  }; // GUIHelpers
}