Easy3D 2.5.3
Tutorial_311_Animation
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/vertex_array_object.h>
29#include <easy3d/renderer/drawable_triangles.h>
30#include <easy3d/util/resource.h>
31#include <easy3d/util/initializer.h>
32
33
34using namespace easy3d;
35
36// This example shows how to map an array buffer for dynamic buffer update (useful for animation).
37
38int main(int argc, char **argv) {
39 // initialize Easy3D.
40 initialize();
41
42 //-------------------------------------------------------------
43
44 // Create the default Easy3D viewer.
45 // Note: a viewer must be created before creating any drawables.
46 Viewer viewer(EXAMPLE_TITLE);
47
48 //-------------------------------------------------------------
49
50 // We use the points and indices of the "bunny".
51 const std::vector<vec3> &points = resource::bunny_vertices;
52 // Each consecutive 3 indices represent a triangle.
53 const std::vector<unsigned int> &indices = resource::bunny_indices;
54
55 //-------------------------------------------------------------
56 // Create a TrianglesDrawable to visualize the surface of the "bunny".
57 auto surface = new TrianglesDrawable("faces");
58
59 // Upload the vertex positions of the surface to the GPU.
60 // The second argument is 'true' for dynamic update of the buffer data.
61 surface->update_vertex_buffer(points, true);
62
63 // Upload the vertex indices of the surface to the GPU. The indices represent how the vertices are connected to
64 // form triangles.
65 surface->update_element_buffer(indices);
66 // Add the drawable to the viewer
67 viewer.add_drawable(surface);
68
69 viewer.fit_screen();
70
71 // allow animation
72 viewer.set_animation(true);
73
74 // Define an animation function to specify how vertex positions are updated.
75 // In this trivial example, we stretch the model along the Z-axis.
76 viewer.animation_func_ = [&](easy3d::Viewer* v) -> bool {
77 (void)v;
78
79 // map the vertex buffer into the client's address space
80 void* pointer = VertexArrayObject::map_buffer(GL_ARRAY_BUFFER, surface->vertex_buffer(), GL_WRITE_ONLY);
81
82 vec3* vertices = reinterpret_cast<vec3*>(pointer);
83 if (!vertices)
84 return false;
85
86 static float total_scale = 1.0f;
87 float scale = 1.01f;
88 if (total_scale > 1.5f) {
89 scale = 1.0f / total_scale;
90 total_scale = 1.0f;
91 }
92 else
93 total_scale *= scale;
94
95 for (std::size_t i=0; i<points.size(); ++i)
96 vertices[i].z *= scale;
97
98 // unmap the vertex buffer
99 VertexArrayObject::unmap_buffer(GL_ARRAY_BUFFER, surface->vertex_buffer());
100
101 viewer.update();
102 return true;
103 };
104
105 // run the viewer
106 return viewer.run();
107}
108
The drawable for rendering a set of triangles, e.g., the surface of a triangular mesh.
Definition: drawable_triangles.h:46
The built-in Easy3D viewer.
Definition: viewer.h:61
bool add_drawable(Drawable *drawable)
Add a drawable to the viewer to be visualized. After a drawable being added to the viewer,...
Definition: viewer.cpp:1302
void fit_screen(const easy3d::Model *model=nullptr)
Moves the camera so that the entire scene or the active model is centered on the screen at a proper s...
Definition: viewer.cpp:1337
std::function< bool(Viewer *viewer)> animation_func_
Function called at an equal interval for animation.
Definition: viewer.h:468
void set_animation(bool b)
Enable/Disable animation.
Definition: viewer.cpp:1193
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