Easy3D 2.5.3
Tutorial_602_ConvexPartition
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/renderer/camera.h>
29#include <easy3d/core/surface_mesh.h>
30#include <easy3d/renderer/drawable_points.h>
31#include <easy3d/renderer/drawable_lines.h>
32#include <easy3d/renderer/renderer.h>
33#include <easy3d/algo/polygon_partition.h>
34#include <easy3d/util/initializer.h>
35
36
37using namespace easy3d;
38
39
40// This example shows how to partition a polygon (free of self-intersection) with an arbitrary number of holes into
41// a set of convex polygons using the PolygonPartition class of Easy3D.
42//
43// Note: For complex unknown structures that have self-intersection, you need to use the CSG operators provided in
44// easy3d/algo/tessellator.h to obtain simply polygons (free of self-intersection) first.
45
46
47int main(int argc, char** argv) {
48 // initialize Easy3D.
49 initialize();
50
51 // create the default Easy3D viewer.
52 // (a viewer must be created before creating any drawables).
53 Viewer viewer(EXAMPLE_TITLE);
54 viewer.camera()->setUpVector(vec3(0, 1, 0));
55 viewer.camera()->setViewDirection(vec3(0, 0, -1));
56
57 // the vertices of the polygon (including the holes).
58 std::vector<vec2> points = {
59 vec2( 0, 0), // 0: start of outer contour, in counterclockwise order
60 vec2(500, 0), // 1
61 vec2(500, 700), // 2
62 vec2( 0, 700), // 3
63 vec2(100, 100), // 4: start of 1st hole, also in counterclockwise order
64 vec2(400, 100), // 5
65 vec2(400, 300), // 6
66 vec2(100, 300), // 7
67 vec2(100, 400), // 8: start of 2nd hole, also in counterclockwise order
68 vec2(400, 400), // 9
69 vec2(400, 600), // 10
70 vec2(100, 600), // 11
71 };
72
73 // the outer contour represented by the vertex indices. Note: must be in counterclockwise order.
74 std::vector<PolygonPartition::Polygon> polygons = {
75 {0, 1, 2, 3} // outer contour
76 };
77
78 // the interior contours representing holes. Note: hole vertices must be in clockwise order.
79 std::vector<PolygonPartition::Polygon> holes = {
80 {7, 6, 5, 4}, // {4, 5, 6, 7} won't work
81 {11, 10, 9, 8}, // {8, 9, 10, 11} won't work
82 };
83
84 // convex partition
85 std::vector<PolygonPartition::Polygon> parts;
86 if (!PolygonPartition::apply(points, polygons, holes, parts))
87 return EXIT_FAILURE;
88
89 //--------------------------------------------------------
90
91 // Visualizing the result.
92 // we create a mesh to store the resulted convex polygons.
93 SurfaceMesh* mesh = new SurfaceMesh;
94 for (const auto& p : points)
95 mesh->add_vertex({p.x, p.y, 0});
96 for (const auto& poly : parts) {
97 std::vector<SurfaceMesh::Vertex> vts;
98 for (const auto& id : poly)
99 vts.push_back(SurfaceMesh::Vertex(static_cast<int>(id)));
100 mesh->add_face(vts);
101 }
102 // add the mesh to the viewer.
103 viewer.add_model(mesh);
104
105 // show the vertices
106 mesh->renderer()->get_points_drawable("vertices")->set_visible(true);
107 mesh->renderer()->get_points_drawable("vertices")->set_impostor_type(easy3d::PointsDrawable::SPHERE);
108 mesh->renderer()->get_points_drawable("vertices")->set_point_size(12);
109 // show the edges
110 mesh->renderer()->get_lines_drawable("edges")->set_visible(true);
111 // also show the borders
112 mesh->renderer()->get_lines_drawable("borders")->set_visible(true);
113
114 // run the viewer
115 return viewer.run();
116}
void setUpVector(const vec3 &up, bool noMove=true) const
Definition: camera.cpp:837
void setViewDirection(const vec3 &direction) const
Definition: camera.cpp:879
Renderer * renderer()
Gets the renderer of this model.
Definition: model.h:94
LinesDrawable * get_lines_drawable(const std::string &name) const
Definition: renderer.cpp:295
PointsDrawable * get_points_drawable(const std::string &name) const
Definition: renderer.cpp:286
A halfedge data structure for polygonal meshes of 2-manifold.
Definition: surface_mesh.h:52
Face add_face(const std::vector< Vertex > &vertices)
Definition: surface_mesh.cpp:518
Vertex add_vertex(const vec3 &p)
add a new vertex with position p
Definition: surface_mesh.h:1034
The built-in Easy3D viewer.
Definition: viewer.h:61
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
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
Definition: surface_mesh.h:104