Home Documentation Download Examples Developer

# The mouseGrabber example

`MouseGrabber`s enable complex mouse interaction.

A `MouseGrabber` is an abstract class which defines objects that are sensitive to the mouse. When activated, they grab the mouse events. Possible applications are interactive 2D or 3D GUI, object auto-selection, auto drop-down menu and much more.

`ManipulatedFrame` are indeed `MouseGrabbers` as is illustrated here. Simply hover on a spiral to automatically "select" it. Mouse events will then be grabbed by the associated `ManipulatedFrame`, which can be moved without any key press or GUI interaction. Useful to easily manipulate scene objects. Note that by default, a `ManipulatedFrame` grabs the mouse when the cursor is close enough to its `position()`. You may want to overload the `checkIfGrabsMouse()` function to define a more complex grabbing test.

That's what is done in the `CameraPathPlayer` class, which is associated to a Camera keyFrame paths or position. It is displayed as a text on the left hand side of the window (when its associated path is defined). It reacts to mouse hovering and clicking the text will play (resp. restore) the Camera path (resp. position).

## mouseGrabber.h

    #include <QGLViewer/qglviewer.h>

    class CameraPathPlayer : public qglviewer::MouseGrabber
    {
    public:
      CameraPathPlayer(int nb) : pathNb(nb) {};
      void checkIfGrabsMouse(int x, int y, const qglviewer::Camera* const camera);
      int yPos() { return 25*pathNb; };

    protected:
      void mousePressEvent(QMouseEvent* const, qglviewer::Camera* const camera) { camera->playPath(pathNb); };

    private:
      int pathNb;
    };

    class Spiral
    {
    public:
      void draw() const;
      void setPosition(const qglviewer::Vec& pos) { mf_.setPosition(pos); };

    private:
      qglviewer::ManipulatedFrame mf_;
    };

    class Viewer : public QGLViewer
    {
    protected :
      virtual void init();
      virtual void draw();
      virtual QString helpString() const;

      void displayPlayers();
      void updatePlayers();

    private:
      CameraPathPlayer** player_;
      int nbPlayers_;
    #if QT_VERSION < 0x040000
      QValueVector<Spiral> spiral_;
    #else
      QList<Spiral> spiral_;
    #endif
    };

## mouseGrabber.cpp

    #include "mouseGrabber.h"

    using namespace qglviewer;
    using namespace std;

    void CameraPathPlayer::checkIfGrabsMouse(int x, int y, const Camera* const)
    {
      // Rectangular activation array - May have to be tune depending on your default font size
      setGrabsMouse((x < 80) && (y<yPos()) && ((yPos()-y) < 16));
    }

    void Viewer::displayPlayers()
    {
      for (int i=0; i<nbPlayers_; ++i)
        {
          CameraPathPlayer* cpp = player_[i];
          if (cpp)
    	{
    	  QString s;
    	  if (cpp->grabsMouse())
    	    {
    	      glColor3f(1,1,1);
    	      if (camera()->keyFrameInterpolator(i)->numberOfKeyFrames() > 1)
    		s = "Play path F" + QString::number(i);
    	      else
    		s = "Restore pos F" + QString::number(i);
    	    }
    	  else
    	    {
    	      glColor3f(0.6f, 0.6f, 0.6f);
    	      if (camera()->keyFrameInterpolator(i)->numberOfKeyFrames() > 1)
    		s = "Path F" + QString::number(i);
    	      else
    		s = "Pos F" + QString::number(i);
    	    }
    	  drawText(10, cpp->yPos()-3, s);
    	}
        }
    }

    void Viewer::updatePlayers()
    {
      for (int i=0; i<nbPlayers_; ++i)
        {
          // Check if CameraPathPlayer is still valid
          if ((player_[i]) && (!camera()->keyFrameInterpolator(i)))
    	{
    	  delete player_[i];
    	  player_[i] = NULL;
    	}
          // Or add it if needed
          if ((camera()->keyFrameInterpolator(i)) && (!player_[i]))
    	player_[i] = new CameraPathPlayer(i);
        }
    }

    void Viewer::init()
    {
      // Absolutely needed for MouseGrabber
      setMouseTracking(true);

      // In order to make the manipulatedFrame displacements clearer
      setAxisIsDrawn();

      // Initialize the CameraPathPlayer MouseGrabber array
      nbPlayers_ = 12;
      player_ = new CameraPathPlayer*[nbPlayers_];
      for (int i=0; i<nbPlayers_; ++i)
        player_[i] = NULL;

      // Create a scene with several spirals.
      const int nbSpirals = 7;
      for (int i = -nbSpirals/2; i<=nbSpirals/2; ++i)
        {
          Spiral s;
          s.setPosition(Vec(1.8f*i/nbSpirals, 0.0, 0.0));
          spiral_.push_back(s);
        }

      restoreStateFromFile();

      help();
    }

    void Viewer::draw()
    {
    #if QT_VERSION < 0x040000
      for (QValueVector<Spiral>::const_iterator it=spiral_.begin(), end=spiral_.end(); it != end; ++it)
    #else
      for (QList<Spiral>::const_iterator it=spiral_.begin(), end=spiral_.end(); it != end; ++it)
    #endif
        (*it).draw();

      updatePlayers();
      glDisable(GL_LIGHTING);
      displayPlayers();
      glEnable(GL_LIGHTING);
    }

    QString Viewer::helpString() const
    {
      QString text("<h2>M o u s e G r a b b e r </h2>");
      text += "This example illustrates the use of <i>MouseGrabber</i>, which is an abstract ";
      text += "class for objects that react (usually when the mouse hovers over them).<br><br>";
      text += "Define new camera paths (or positions) using <b>Alt</b>+[<b>F1</b>-<b>F12</b>]. ";
      text += "New <i>MouseGrabbers</i> are then created and displayed in the upper left corner. ";
      text += "Note how they react when the mouse hovers, and click them to play the associated path.<br><br>";
      text += "<i>ManipulatedFrame</i>, such as the ones which define the spirals' positions, are ";
      text += "also <i>MouseGrabbers</i>. When the mouse is close to the spiral center, the <i>ManipulatedFrame</i> ";
      text += "will grab to mouse click (as if the <b>Control</b> key was pressed). This is very convenient ";
      text += "to intuitively move scene objects (such as lights) without any key or GUI interaction.<br><br>";
      text += "Note that <code>setMouseTracking()</code> must be enabled to use <i>MouseGrabbers</i>.";
      return text;
    }

    void Spiral::draw() const
    {
      glPushMatrix();
      glMultMatrixd(mf_.matrix());

      // Draw a spiral
      const float nbSteps = 100.0;
      glBegin(GL_QUAD_STRIP);
      for (float i=0; i<nbSteps; ++i)
        {
          float ratio = i/nbSteps;
          float angle = 21.0*ratio;
          float c = cos(angle);
          float s = sin(angle);
          float r1 = 0.2 - 0.15*ratio;
          float r2 = 0.16 - 0.15*ratio;
          float alt = 0.2f * (ratio - 0.5);
          const float nor = .5;
          const float up = sqrt(1.0-nor*nor);

          if (mf_.grabsMouse())
    	glColor3f(1-ratio, 0.8f , ratio/2.0);
          else
    	glColor3f(1-ratio, 0.2f , ratio);

          glNormal3f(nor*c, up, nor*s);
          glVertex3f(r1*c, alt, r1*s);
          glVertex3f(r2*c, alt+0.01, r2*s);
        }
      glEnd();

      glPopMatrix();
    }

## main.cpp

    #include "mouseGrabber.h"
    #include <qapplication.h>

    int main(int argc, char** argv)
    {
      QApplication application(argc,argv);

      Viewer viewer;

    #if QT_VERSION < 0x040000
      application.setMainWidget(&viewer);
    #else
      viewer.setWindowTitle("mouseGrabber");
    #endif

      viewer.show();

      return application.exec();
    }

Back to the examples main page.

Last modified on Sunday, February 28, 2010.