Tutorial_405_ObjectManipulation

The source file containing the main() function:

/********************************************************************
 * 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/>.
 ********************************************************************/
 
#include "viewer.h"
#include <easy3d/util/resource.h>
#include <easy3d/util/initializer.h>
 
 
using namespace easy3d;
 
// This example shows how to manipulate a model in the 3D space using the Manipulator class.
 
int main(int argc, char **argv) {
    // initialize Easy3D.
    initialize();
 
    ManipulationViewer viewer(EXAMPLE_TITLE);
    viewer.add_model(resource::directory() + "/data/easy3d/easy3d_e.ply");
    viewer.add_model(resource::directory() + "/data/easy3d/easy3d_a.ply");
    viewer.add_model(resource::directory() + "/data/easy3d/easy3d_s.ply");
    viewer.add_model(resource::directory() + "/data/easy3d/easy3d_y.ply");
    viewer.add_model(resource::directory() + "/data/easy3d/easy3d_3.ply");
    viewer.add_model(resource::directory() + "/data/easy3d/easy3d_d.ply");
 
    if (viewer.models().empty()) {
        LOG(ERROR) << "failed to load the model. Please make sure the file exists and format is correct.";
        return EXIT_FAILURE;
    }
 
    // run the viewer
    return viewer.run();
}
 

The header file of the viewer class:

/********************************************************************
 * 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_TUTORIAL_OBJECT_MANIPULATION_VIEWER_H
#define EASY3D_TUTORIAL_OBJECT_MANIPULATION_VIEWER_H
 
#include <easy3d/viewer/viewer.h>
 
#include <unordered_map>
 
// This class demonstrates how to manipulate an object in the 3D space using the mouse
 
namespace easy3d {
    class Model;
}
 
class ManipulationViewer : public easy3d::Viewer {
public:
    explicit ManipulationViewer(const std::string &title);
 
protected:
    bool mouse_press_event(int x, int y, int button, int modifiers) override;
    bool mouse_drag_event(int x, int y, int dx, int dy, int button, int modifiers) override;
    void draw() const override;
 
private:
    void mark(easy3d::Model *model);
 
private:
    easy3d::Model* selected_model_;
};
 
 
#endif // EASY3D_TUTORIAL_OBJECT_MANIPULATION_VIEWER_H

The source file of the viewer class:

/********************************************************************
 * 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/>.
 ********************************************************************/
 
#include "viewer.h"
#include <easy3d/gui/picker_model.h>
#include <easy3d/core/model.h>
#include <easy3d/renderer/drawable_triangles.h>
#include <easy3d/renderer/renderer.h>
#include <easy3d/renderer/manipulator.h>
#include <easy3d/renderer/manipulated_frame.h>
#include <easy3d/util/file_system.h>
#include <easy3d/util/setting.h>
 
 
using namespace easy3d;
 
 
ManipulationViewer::ManipulationViewer(const std::string &title)
        : Viewer(title), selected_model_(nullptr)
{
    // We always want to look at the front of the easy3d logo.
    camera()->setViewDirection(vec3(0, 0, -1));
    camera()->setUpVector(vec3(0, 1, 0));
 
    usage_string_ =
            "-------------------- Manipulator Viewer usage ---------------------\n"
            "Press the left button to pick/unpick a model.                      \n"
            "When a model is picked, using the mouse to manipulate it:          \n"
            "    - ALT + left button: rotate the model                          \n"
            "    - ALT + right button: translate the model                      \n"
            "------------------------------------------------------------------ \n";
}
 
 
bool ManipulationViewer::mouse_press_event(int x, int y, int button, int modifiers) {
    if (modifiers != MODIF_ALT) {// this is reserved for manipulation
        ModelPicker picker(camera());
        auto model = picker.pick(models(), x, y);
        if (model)
            mark(model);
        return true;
    }
    else
        return Viewer::mouse_press_event(x, y, button, modifiers);
}
 
 
bool ManipulationViewer::mouse_drag_event(int x, int y, int dx, int dy, int button, int modifiers) {
    // control modifier is reserved for zooming on region
    if (modifiers == MODIF_ALT && selected_model_) {
        ManipulatedFrame *frame = selected_model_->manipulator()->frame();
 
        auto axis = ManipulatedFrame::NONE;
        if (pressed_key_ == KEY_X) axis = ManipulatedFrame::HORIZONTAL;
        else if (pressed_key_ == KEY_Y) axis = ManipulatedFrame::VERTICAL;
        else if (pressed_key_ == KEY_O) axis = ManipulatedFrame::ORTHOGONAL;
        switch (button) {
            case BUTTON_LEFT:
                frame->action_rotate(x, y, dx, dy, camera_, axis);
                break;
            case BUTTON_RIGHT:
                frame->action_translate(x, y, dx, dy, camera_, axis);
                break;
            default:
                break;
        }
        return true;
    }
    else
        return Viewer::mouse_drag_event(x, y, dx, dy, button, modifiers);
}
 
 
void ManipulationViewer::mark(easy3d::Model *model) {
    for (auto m : models()) {
        m->renderer()->set_selected(m == model);
        auto faces = m->renderer()->get_triangles_drawable("faces");
        if (m == model)
            faces->set_uniform_coloring(vec4(1, 0, 0, 1.0f));
        else
            faces->set_uniform_coloring(setting::surface_mesh_faces_color);
    }
    std::cout << "picked model: " << file_system::simple_name(model->name()) << std::endl;
 
    selected_model_ = model;
    if (!model->manipulator()) {    // create manipulator if it doesn't exist
        model->set_manipulator(new Manipulator(model));
        model->manipulator()->frame()->modified.connect(this,
                static_cast<void (ManipulationViewer::*)(void) const>(&ManipulationViewer::update));
    }
    update();
}
 
 
void ManipulationViewer::draw() const {
    Viewer::draw();
    for (auto m : models()) {
        if (m->renderer()->is_selected() && m->manipulator())
            m->manipulator()->draw_frame(camera());
    }
}