manipulatedFrame.h

Go to the documentation of this file.

/****************************************************************************

 This file is part of the QGLViewer library
 Copyright (C) 2002-2004  Gilles Debunne (Gilles.Debunne@imag.fr)
 Version 1.3.5 Release 8. Packaged on Monday December 22, 2003.

 http://www-imagis.imag.fr/Membres/Gilles.Debunne/CODE/QGLViewer

 libQGLViewer is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 libQGLViewer 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 General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with libQGLViewer; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

*****************************************************************************/

#ifndef QGLVIEWER_MANIPULATED_FRAME_H
#define QGLVIEWER_MANIPULATED_FRAME_H

#include <qstring.h>
#include <qtimer.h>
#include <qdatetime.h>

#include "spinningFrame.h"
#include "mouseGrabber.h"

class QGLViewer;

namespace qglviewer {

  class QGLVIEWER_EXPORT ManipulatedFrame : public SpinningFrame, public MouseGrabber
  {
#ifndef DOXYGEN
    friend class Camera;
    friend class ::QGLViewer;
#endif

    Q_OBJECT

  public:
    ManipulatedFrame();
    virtual ~ManipulatedFrame() {};
    
    signals:
    void manipulated();

  public slots:
    void setRotationSensitivity(const float s) { rotSensitivity_ = s; };
    void setTranslationSensitivity(const float s) { transSensitivity_ = s; };

    void setSpinningSensitivity(const float s) { spinningSensitivity_ = s; };
  public:
    float rotationSensitivity() const { return rotSensitivity_; };
    float translationSensitivity() const { return transSensitivity_; };
    float spinningSensitivity() const { return spinningSensitivity_; };
    
  public:
    bool isManipulated() const { return action_ != NO_ACTION; };

  public:
    virtual QDomElement domElement(const QString& name, QDomDocument& doc) const;
    virtual void initFromDOMElement(const QDomElement& de);
    
  protected:
    virtual void mousePressEvent(QMouseEvent* const, Camera* const);
    virtual void mouseReleaseEvent(QMouseEvent* const, Camera* const);
    virtual void mouseMoveEvent(QMouseEvent* const, const Camera* const);
    virtual void wheelEvent(QWheelEvent* const, const Camera* const camera);

    void checkIfGrabsMouse(int x, int y, const Camera* const camera); 

  protected:
    Quaternion quaternionFromDeformedBall(const int x, const int y, const float cx, const float cy, const Camera* const camera);

  public:
    // P o s s i b l e   a c t i o n s
    enum MouseMotion { NO_ACTION,
               ROTATE, ZOOM, TRANSLATE,
               MOVE_FORWARD, LOOK_AROUND, MOVE_BACKWARD,
               SCREEN_ROTATE, SCREEN_ROTATE_BOTTOM,
               SCREEN_TRANSLATE, ZOOM_ON_REGION };
    //#CONNECTION# QGLViewer::setMouseBinding
    
  protected:    
    MouseMotion action_;
    bool withConstraint_;

    virtual void startAction(MouseMotion ma, bool withConstraint=true);
    void computeMouseSpeed(const QMouseEvent* const e);    
    int mouseOriginalDirection(const QMouseEvent* const e);

    // Previous mouse position, used for incremental updates.
    int prevX_,  prevY_;
    // Mouse press position
    int pressX_, pressY_;  
    
  private:
    // Copy constructor and opertor= are declared private and undefined
    // Prevents everyone from trying to use them
    ManipulatedFrame(const ManipulatedFrame& mf);
    ManipulatedFrame& operator=(const ManipulatedFrame& mf);

    // Sensitivity
    float rotSensitivity_;
    float transSensitivity_;
    float spinningSensitivity_;
  
    // Mouse speed and spinning
    QTime last_move_time;
    float mouseSpeed_; 
    int delay_; 

    // Whether the SCREEN_TRANS direction (horizontal or vertical) is fixed or not.
    bool dirIsFixed_;

    // MouseGrabber
    bool keepsGrabbingMouse_;
  };

} // namespace qglviewer

#endif // QGLVIEWER_MANIPULATED_FRAME_H

---