ModuleBase_IViewer.h

// Copyright (C) 2014-2026  CEA, EDF
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
 
#ifndef ModuleBase_IViewer_H
#define ModuleBase_IViewer_H
 
#include "ModuleBase.h"
 
#include <QObject>
#include <QMap>
#include <AIS_InteractiveContext.hxx>
#include <V3d_View.hxx>
#include <AIS_Trihedron.hxx>
 
class QMouseEvent;
class QKeyEvent;
class QContextMenuEvent;
class ModuleBase_IViewWindow;
#ifdef HAVE_SALOME
class OCCViewer_Fitter;
#else
class AppElements_Fitter;
#endif
 
class MODULEBASE_EXPORT ModuleBase_IViewer : public QObject
{
Q_OBJECT
 public:
  ModuleBase_IViewer(QObject* theParent);
 
  virtual Handle(AIS_InteractiveContext) AISContext() const = 0;
 
  virtual Handle(AIS_Trihedron) trihedron() const = 0;
 
  virtual Handle(V3d_Viewer) v3dViewer() const = 0;
 
  virtual Handle(V3d_View) activeView() const = 0;
 
  virtual QWidget* activeViewPort() const = 0;
 
  virtual void enableSelection(bool isEnabled) = 0;
 
  virtual bool isSelectionEnabled() const = 0;
 
  virtual void enableMultiselection(bool isEnable) = 0;
 
  virtual bool isMultiSelectionEnabled() const = 0;
 
  virtual bool enableDrawMode(bool isEnabled) = 0;
 
  virtual void fitAll() = 0;
 
  virtual void eraseAll() = 0;
 
  virtual void setViewProjection( double theX, double theY, double theZ,
                                  double theTwist ) = 0;
 
  virtual void setViewProjection( double theX, double theY, double theZ,
                                  double theUpX, double theUpY, double theUpZ) = 0;
 
  virtual void addSelectionFilter(const Handle(SelectMgr_Filter)& theFilter) = 0;
 
  virtual void removeSelectionFilter(const Handle(SelectMgr_Filter)& theFilter) = 0;
 
  virtual bool hasSelectionFilter(const Handle(SelectMgr_Filter)& theFilter) = 0;
 
  virtual void update() = 0;
 
  const double Scale(const Handle(V3d_View)& theView)
  {
    if (!myWindowScale.contains(theView))
      myWindowScale.insert(theView, theView->Camera()->Scale());
    return myWindowScale[theView];
  }
 
  void SetScale(const Handle(V3d_View)& theView, const double theVal)
  { myWindowScale[theView] = theVal; }
 
  virtual bool canDragByMouse() const { return true; }
 
  //virtual void Zfitall() = 0;
 
  virtual void updateHighlight() {}
 
  void set2dMode(bool is2d) {
    myIs2dMode = is2d;
  }
 
  bool is2dMode() const {
    return myIs2dMode;
  }
 
  // Methods for color scale management
 
  virtual bool isColorScaleVisible() const = 0;
 
  virtual void setColorScaleShown(bool on) = 0;
 
  // \param theX is X position relative to current view width
  // \param theY is Y position relative to current view height
  virtual void setColorScalePosition(double theX, double theY) = 0;
 
  // \param theW is width relative to current view width
  // \param theh is height relative to current view height
  virtual void setColorScaleSize(double theW, double theH) = 0;
 
  // \param theMin is a minimal value
  // \param theMax is a maximal value
  virtual void setColorScaleRange(double theMin, double theMax) = 0;
 
  // \param theNb is number of intervals
  virtual void setColorScaleIntervals(int theNb) = 0;
 
  // \param theH is number of intervals
  virtual void setColorScaleTextHeigth(int theH) = 0;
 
  // \param theH is number of intervals
  virtual void setColorScaleTextColor(const QColor& theColor) = 0;
 
  // \param theText is a title
  virtual void setColorScaleTitle(const QString& theText) = 0;
 
  typedef std::list<std::pair<std::wstring, std::vector<int> > > TextColor;
 
  virtual void setText(const TextColor& theText, const int theSize) = 0;
 
 
  void showSelectionHighlight() {
    myShowHighlight = true;
  }
 
  void hideSelectionHighlight() {
    myShowHighlight = false;
  }
 
#ifdef HAVE_SALOME
  virtual void setFitter(OCCViewer_Fitter* theFitter) = 0;
  virtual OCCViewer_Fitter* fitter() const = 0;
#else
  virtual void setFitter(AppElements_Fitter* theFitter) = 0;
  virtual AppElements_Fitter* fitter() const = 0;
#endif
 
  static Handle(Prs3d_Drawer) DefaultHighlightDrawer;
 
 
signals:
  void lastViewClosed();
 
  void tryCloseView(ModuleBase_IViewWindow* theWnd);
 
  void deleteView(ModuleBase_IViewWindow* theWnd);
 
  void viewCreated(ModuleBase_IViewWindow* theWnd);
 
  void activated(ModuleBase_IViewWindow* theWnd);
 
  void mousePress(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
 
  void mouseRelease(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
 
  void mouseDoubleClick(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
 
  void mouseMove(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
 
  void keyPress(ModuleBase_IViewWindow* theWnd, QKeyEvent* theEvent);
 
  void keyRelease(ModuleBase_IViewWindow* theWnd, QKeyEvent* theEvent);
 
  void selectionChanged();
 
  void contextMenuRequested(QContextMenuEvent*);
 
  void viewTransformed(int theTransformation);
 
  void trihedronVisibilityChanged(bool theState);
 
  protected:
    QMap<Handle(V3d_View), double> myWindowScale;
 
    bool myIs2dMode;
 
    bool myShowHighlight;
};
 
#endif