Easy3D 2.5.3
Tutorial_701_Cloud_NormalEstimation
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 <easy3d/viewer/viewer.h>
28#include <easy3d/core/model.h>
29#include <easy3d/renderer/drawable_points.h>
30#include <easy3d/renderer/renderer.h>
31#include <easy3d/renderer/camera.h>
32#include <easy3d/algo/point_cloud_normals.h>
33#include <easy3d/util/resource.h>
34#include <easy3d/util/initializer.h>
35
36
37using namespace easy3d;
38
39// This example shows how to
40// - estimate normal information of a point cloud.
41// - re-orient the normals.
42
43bool estimate(Viewer* viewer, Model* model) {
44 if (!viewer || !model)
45 return false;
46
47 auto cloud = dynamic_cast<PointCloud *>(model);
48 if (PointCloudNormals::estimate(cloud)) {
49 auto normals = cloud->get_vertex_property<vec3>("v:normal");
50 auto drawable = cloud->renderer()->get_points_drawable("vertices");
51 // Upload the vertex normals to the GPU.
52 drawable->update_normal_buffer(normals.vector());
53 viewer->update();
54 return true;
55 }
56 else
57 return false;
58}
59
60bool reorient(Viewer* viewer, Model* model) {
61 if (!viewer || !model)
62 return false;
63
64 auto cloud = dynamic_cast<PointCloud *>(model);
65 auto normals = cloud->get_vertex_property<vec3>("v:normal");
66 if (!normals) {
67 LOG(WARNING) << "normal information does not exist";
68 return false;
69 }
70
71 if (PointCloudNormals::reorient(cloud)) {
72 auto drawable = cloud->renderer()->get_points_drawable("vertices");
73 // Upload the vertex normals to the GPU.
74 drawable->update_normal_buffer(normals.vector());
75 viewer->update();
76 return true;
77 }
78 else
79 return false;
80}
81
82int main(int argc, char **argv) {
83 // initialize Easy3D.
84 initialize();
85
86 const std::string file = resource::directory() + "/data/bunny.bin";
87
88 // create the viewer.
89 Viewer viewer(EXAMPLE_TITLE);
90
91 Model *model = viewer.add_model(file, true);
92 if (!model) {
93 LOG(ERROR) << "failed to load model. Please make sure the file exists and format is correct.";
94 return EXIT_FAILURE;
95 }
96 // to view the bunny from its front
97 viewer.camera()->setUpVector(vec3(0, 1, 0));
98 viewer.camera()->setViewDirection(vec3(1, 0, 0));
99
100 // setup rendering parameters
101 auto drawable = model->renderer()->get_points_drawable("vertices");
102 drawable->set_uniform_coloring(vec4(0.6f, 0.6f, 1.0f, 1.0f));
103 drawable->set_point_size(3.0f);
104 drawable->set_lighting_two_sides(false);
105
106 // usage
107 viewer.set_usage("Ctrl + e: estimate normals\n"
108 "Ctrl + r: reorient normals");
109 // set up the functions to be executed and their corresponding shortcuts
110 viewer.bind(estimate, model, Viewer::KEY_E, Viewer::MODIF_CTRL);
111 viewer.bind(reorient, model, Viewer::KEY_R, Viewer::MODIF_CTRL);
112
113 // run the viewer
114 return viewer.run();
115}
116
void setUpVector(const vec3 &up, bool noMove=true) const
Definition: camera.cpp:837
void setViewDirection(const vec3 &direction) const
Definition: camera.cpp:879
The base class of renderable 3D models.
Definition: model.h:49
Renderer * renderer()
Gets the renderer of this model.
Definition: model.h:94
A data structure for point clouds.
Definition: point_cloud.h:45
VertexProperty< T > get_vertex_property(const std::string &name) const
get the vertex property named name of type T. returns an invalid VertexProperty if the property does ...
Definition: point_cloud.h:340
PointsDrawable * get_points_drawable(const std::string &name) const
Definition: renderer.cpp:286
void set_uniform_coloring(const vec4 &color)
Definition: state.cpp:89
The built-in Easy3D viewer.
Definition: viewer.h:61
void bind(const Function &func, Model *model, Key key, Modifier modifier=MODIF_NONE)
Bind a function that will be triggered by the shortcut 'modifier + key'.
Definition: viewer.h:460
virtual Model * add_model(const std::string &file_name, bool create_default_drawables=true)
Add a model from a file to the viewer to be visualized. On success, the viewer will be in charge of t...
Definition: viewer.cpp:1204
Camera * camera()
Returns the camera used by the viewer. See Camera.
Definition: viewer.h:177
int run(bool see_all=true)
Run the viewer.
Definition: viewer.cpp:1090
void update() const
Update the display (i.e., repaint).
Definition: viewer.cpp:631
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