Easy3D 2.5.3
Tutorial_401_ModelPicker

The source file containing the main() function:

1/********************************************************************
2 * Copyright (C) 2015 Liangliang Nan <liangliang.nan@gmail.com>
3 * https://3d.bk.tudelft.nl/liangliang/
4 *
5 * This file is part of Easy3D. If it is useful in your research/work,
6 * I would be grateful if you show your appreciation by citing it:
7 * ------------------------------------------------------------------
8 * Liangliang Nan.
9 * Easy3D: a lightweight, easy-to-use, and efficient C++ library
10 * for processing and rendering 3D data.
11 * Journal of Open Source Software, 6(64), 3255, 2021.
12 * ------------------------------------------------------------------
13 *
14 * Easy3D is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License Version 3
16 * as published by the Free Software Foundation.
17 *
18 * Easy3D is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License
24 * along with this program. If not, see <http://www.gnu.org/licenses/>.
25 ********************************************************************/
26
27#include "viewer.h"
28#include <easy3d/util/resource.h>
29#include <easy3d/util/initializer.h>
30
31
32using namespace easy3d;
33
34// This example shows how to select a model from a set of models by clicking the mouse.
35
36int main(int argc, char **argv) {
37 // initialize Easy3D.
38 initialize();
39
40 PickerViewer viewer(EXAMPLE_TITLE);
41 viewer.add_model(resource::directory() + "/data/easy3d/easy3d_e.ply");
42 viewer.add_model(resource::directory() + "/data/easy3d/easy3d_a.ply");
43 viewer.add_model(resource::directory() + "/data/easy3d/easy3d_s.ply");
44 viewer.add_model(resource::directory() + "/data/easy3d/easy3d_y.ply");
45 viewer.add_model(resource::directory() + "/data/easy3d/easy3d_3.ply");
46 viewer.add_model(resource::directory() + "/data/easy3d/easy3d_d.ply");
47
48 if (viewer.models().empty()) {
49 LOG(ERROR) << "failed to load model. Please make sure the file exists and format is correct.";
50 return EXIT_FAILURE;
51 }
52
53 // run the viewer
54 return viewer.run();
55}
56
Definition: collider.cpp:182
void initialize(bool use_log_file, bool use_setting_file, const std::string &resource_dir)
Initialization of Easy3D.
Definition: initializer.cpp:35

The header file of the viewer class:

1/********************************************************************
2 * Copyright (C) 2015 Liangliang Nan <liangliang.nan@gmail.com>
3 * https://3d.bk.tudelft.nl/liangliang/
4 *
5 * This file is part of Easy3D. If it is useful in your research/work,
6 * I would be grateful if you show your appreciation by citing it:
7 * ------------------------------------------------------------------
8 * Liangliang Nan.
9 * Easy3D: a lightweight, easy-to-use, and efficient C++ library
10 * for processing and rendering 3D data.
11 * Journal of Open Source Software, 6(64), 3255, 2021.
12 * ------------------------------------------------------------------
13 *
14 * Easy3D is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License Version 3
16 * as published by the Free Software Foundation.
17 *
18 * Easy3D is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License
24 * along with this program. If not, see <http://www.gnu.org/licenses/>.
25 ********************************************************************/
26
27#ifndef EASY3D_TUTORIAL_PICKER_VIEWER_H
28#define EASY3D_TUTORIAL_PICKER_VIEWER_H
29
30#include <easy3d/viewer/viewer.h>
31
32// This class demonstrates how to pick a model using the mouse
33
34namespace easy3d {
35 class Model;
36}
37
38class PickerViewer : public easy3d::Viewer {
39public:
40 explicit PickerViewer(const std::string &title);
41
42protected:
43 bool mouse_press_event(int x, int y, int button, int modifiers) override;
44
45private:
46 void mark(easy3d::Model *model);
47};
48
49
50#endif // EASY3D_TUTORIAL_PICKER_VIEWER_H
The base class of renderable 3D models.
Definition: model.h:49
The built-in Easy3D viewer.
Definition: viewer.h:61

The source file of the viewer class:

1/********************************************************************
2 * Copyright (C) 2015 Liangliang Nan <liangliang.nan@gmail.com>
3 * https://3d.bk.tudelft.nl/liangliang/
4 *
5 * This file is part of Easy3D. If it is useful in your research/work,
6 * I would be grateful if you show your appreciation by citing it:
7 * ------------------------------------------------------------------
8 * Liangliang Nan.
9 * Easy3D: a lightweight, easy-to-use, and efficient C++ library
10 * for processing and rendering 3D data.
11 * Journal of Open Source Software, 6(64), 3255, 2021.
12 * ------------------------------------------------------------------
13 *
14 * Easy3D is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License Version 3
16 * as published by the Free Software Foundation.
17 *
18 * Easy3D is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License
24 * along with this program. If not, see <http://www.gnu.org/licenses/>.
25 ********************************************************************/
26
27#include "viewer.h"
28#include <easy3d/gui/picker_model.h>
29#include <easy3d/core/model.h>
30#include <easy3d/renderer/drawable_triangles.h>
31#include <easy3d/renderer/renderer.h>
32#include <easy3d/util/file_system.h>
33#include <easy3d/util/setting.h>
34
35
36using namespace easy3d;
37
38
39PickerViewer::PickerViewer(const std::string &title)
40 : Viewer(title) {
41 // We always want to look at the front of the easy3d logo.
42 camera()->setViewDirection(vec3(0, 0, -1));
43 camera()->setUpVector(vec3(0, 1, 0));
44
45 usage_string_ =
46 "------------ Picker Viewer usage ---------- \n"
47 "Press the left button to pick/unpick a model\n"
48 "------------------------------------------- \n";
49}
50
51
52bool PickerViewer::mouse_press_event(int x, int y, int button, int modifiers) {
53 ModelPicker picker(camera());
54 auto model = picker.pick(models(), x, y);
55 if (model)
56 mark(model);
57
58 return Viewer::mouse_press_event(x, y, button, modifiers);
59}
60
61
62void PickerViewer::mark(easy3d::Model *model) {
63 for (auto m : models()) {
64 if (m == model)
65 m->renderer()->set_selected(!m->renderer()->is_selected());
66
67 auto faces = m->renderer()->get_triangles_drawable("faces");
68 if (m->renderer()->is_selected())
69 faces->set_uniform_coloring(vec4(1, 0, 0, 1.0f));
70 else
71 faces->set_uniform_coloring(setting::surface_mesh_faces_color);
72 }
73 std::cout << "picked model: " << file_system::simple_name(model->name()) << std::endl;
74 update();
75}
const std::string & name() const
The name of a model.
Definition: model.h:60
Implementation of picking mechanism for set of models.
Definition: picker_model.h:48