VRS - The Virtual Rendering System

version 3.3

spacemousenavigation.h

Go to the documentation of this file.

/******************************************************************************
* VRS - The Virtual Rendering System
* Copyright (C) 2000-2009 Computer Graphics Systems Group at the 
* Hasso-Plattner-Institute (HPI), Potsdam, Germany.
*
* 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 FreeSoftware Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA, 02111-1307, USA.
******************************************************************************/

#ifndef VRS_SPACEMOUSENAVIGATION_H
#define VRS_SPACEMOUSENAVIGATION_H

#include <vrs/config.h>
#include <vrs/sg/interactiontechnique.h>

namespace VRS {

    class VRS_CORE_API SpaceMouseNavigation :
        public VRS::InteractionTechnique
    {
    public:
        VRS_TYPEINFO(SpaceMouseNavigation, VRS::InteractionTechnique);
                
                //  The default values for the configuration are the default paramters in the setter methods below.
                SpaceMouseNavigation();

                void setMaxRotationSpeed(double speed = 180.);
                double getMaxRotationSpeed() const;

                void setMaxPitchRotationSpeed(double speed = 90.);
                double getMaxPitchRotationSpeed() const;

                void setVisualFlowSpeed(double screensPerSecond = 1.4, double fov = 60.0);    
                void setRelativeSpeed(double unitsPerSecond);    
                void setConstantSpeed(double unitsPerSecond);

                bool constantSpeed() const;

                double getVisualFlowSpeed(double fov) const;
                double getRelativeSpeed() const;
                double getConstantSpeed() const;

                void setHeightFactor(double factor = 4.0);
                double getHeightFactor() const;

                // overridden methods (not important for configuring this object) ---------------------------------

                virtual bool checkEventRelevance(SO<VRS::Event> event) const;

                virtual void onEvent(SO<VRS::Event> e);

                virtual void onTimer(SO<VRS::TimeEvent> event, double secondsSinceLastTimeEvent);

    private:
                VRS::Vector translation_;
                VRS::Vector rotation_;
        bool m_valuesAppliedOnTimer;

                double maxXRotationSpeed_;
                double maxYRotationSpeed_;

                double relativeSpeed_;    // horizontal movement speed in unitsPerSecond for the height of 1.0
                double constantSpeed_;    // height-independent horizontal movement speed
                bool useConstantSpeed_;   // true: horizontal movement speed = constantSpeed_, false: = height * relativeSpeed_
                double heightFactor_;     // when increasing height, the value is multiplied with heightFactor_ once per second

    public:
        static VRS::Vector polar2Cartesian(const VRS::Vector& v);
        
        static VRS::Vector cartesian2Polar(const VRS::Vector& v);
        
            static double visualFlow2horizontalMovement(double screens, double fov = 45.0);
        
        static double horizontalMovement2visualFlow(double units, double fov = 45.0);
        };

} // namespace VRS

#endif // VRS_SPACEMOUSENAVIGATION_H

---

Generated on Thu May 24 06:00:15 2012 by Doxygen 1.5.6

© 2001-2010 Hasso-Plattner-Institut | Impressum | Contact