manipulated_frame.h

/********************************************************************
 * Copyright (C) 2015 Liangliang Nan <liangliang.nan@gmail.com>
 * https://3d.bk.tudelft.nl/liangliang/
 *
 * This file is part of Easy3D. If it is useful in your research/work,
 * I would be grateful if you show your appreciation by citing it:
 * ------------------------------------------------------------------
 *      Liangliang Nan.
 *      Easy3D: a lightweight, easy-to-use, and efficient C++ library
 *      for processing and rendering 3D data.
 *      Journal of Open Source Software, 6(64), 3255, 2021.
 * ------------------------------------------------------------------
 *
 * Easy3D is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License Version 3
 * as published by the Free Software Foundation.
 *
 * Easy3D 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 this program. If not, see <http://www.gnu.org/licenses/>.
 ********************************************************************/

 
#ifndef EASY3D_RENDERER_MANIPULATED_FRAME_H
#define EASY3D_RENDERER_MANIPULATED_FRAME_H
 
#include <easy3d/renderer/frame.h>
 
 
namespace easy3d {

    class ManipulatedFrame : public Frame
    {
    public:
        ManipulatedFrame();
        ~ManipulatedFrame() override = default;
        ManipulatedFrame(const ManipulatedFrame &mf);
        ManipulatedFrame &operator=(const ManipulatedFrame &mf);
 

    public:
        void setRotationSensitivity(float sensitivity) {
            rotationSensitivity_ = sensitivity;
        }

        void setTranslationSensitivity(float sensitivity) {
            translationSensitivity_ = sensitivity;
        }

        void setWheelSensitivity(float sensitivity) {
            wheelSensitivity_ = sensitivity;
        }

        void setZoomSensitivity(float sensitivity) { zoomSensitivity_ = sensitivity; }
 
    public:
        float rotationSensitivity() const { return rotationSensitivity_; }

        float translationSensitivity() const { return translationSensitivity_; }
        float zoomSensitivity() const { return zoomSensitivity_; }
        float wheelSensitivity() const { return wheelSensitivity_; }

    public:
        virtual void action_start(); 
        virtual void action_end();

        enum ScreenAxis {
            NONE,       
            HORIZONTAL,   
            VERTICAL,   
            ORTHOGONAL    
        };

        virtual void action_rotate(int mouse_x, int mouse_y, int mouse_dx, int mouse_dy, Camera* camera, ScreenAxis axis);
        virtual void action_translate(int mouse_x, int mouse_y, int mouse_dx, int mouse_dy, Camera* camera, ScreenAxis axis);
        virtual void action_zoom(int dy_wheel, Camera* camera);
        // @}
 
    protected:
        /* Returns a quaternion computed according to the mouse motion. Mouse positions
        are projected on a deformed ball, centered on (\p cx,\p cy), viewer size (\p w, \p h).*/
        quat deformedBallQuaternion(int x, int y, int pre_x, int pre_y, float cx, float cy, int w, int h) const;
 
        Constraint *previousConstraint_; // When manipulation is without constraint.
 
        /* Returns a normalized wheel delta, proportional to wheelSensitivity(). */
        float wheelDelta(int wheel_dy) const;
 
    private:
        // Sensitivity
        float rotationSensitivity_;
        float translationSensitivity_;
        float wheelSensitivity_;
        float zoomSensitivity_;
 
    private:
        friend class Viewer;
    };
 
}
 
 
#endif // EASY3D_RENDERER_MANIPULATED_FRAME_H