Easy3D 2.5.3
Tutorial_305_Texture
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_triangles.h>
31#include <easy3d/renderer/texture_manager.h>
32#include <easy3d/renderer/renderer.h>
33#include <easy3d/util/resource.h>
34#include <easy3d/util/initializer.h>
35
36
37using namespace easy3d;
38
39
40// This example shows how to
41// - create a texture from an image;
42// - render a textured quad using a texture.
43
44
45int main(int argc, char **argv) {
46 // initialize Easy3D.
47 initialize();
48
49 // Create the default Easy3D viewer.
50 // Note: a viewer must be created before creating any drawables.
51 Viewer viewer(EXAMPLE_TITLE);
52 viewer.camera()->setUpVector(vec3(0, 1, 0));
53 viewer.camera()->setViewDirection(vec3(0, 0, -1));
54
55 //----------------------- Load texture from an image file ------------------------
56
57 const std::string texture_file = resource::directory() + "/images/logo.jpg";
58 Texture *tex = TextureManager::request(texture_file);
59 if (!tex) {
60 LOG(ERROR) << "failed to create texture. Please make sure the file exists and format is correct.";
61 return EXIT_FAILURE;
62 }
63
64 //--------------- create a mesh (which contains a single quad) -------------------
65
66 auto mesh = new SurfaceMesh;
67 auto texcoord = mesh->add_vertex_property<vec2>("v:texcoord");
68
69 const auto w = static_cast<float>(tex->width());
70 const auto h = static_cast<float>(tex->height());
71 // create a quad face having an aspect ratio the same as the texture image
72 auto v0 = mesh->add_vertex(vec3(0, 0, 0));
73 texcoord[v0] = vec2(0, 0);
74 auto v1 = mesh->add_vertex(vec3(w, 0, 0));
75 texcoord[v1] = vec2(1, 0);
76 auto v2 = mesh->add_vertex(vec3(w, h, 0));
77 texcoord[v2] = vec2(1, 1);
78 auto v3 = mesh->add_vertex(vec3(0, h, 0));
79 texcoord[v3] = vec2(0, 1);
80 mesh->add_quad(v0, v1, v2, v3);
81
82 // add the model to the viewer and create the default drawable "faces"
83 viewer.add_model(mesh, true);
84
85 // set the texture of the default drawable "faces"
86 auto drawable = mesh->renderer()->get_triangles_drawable("faces");
87 drawable->set_texture(tex);
88 drawable->set_texture_coloring(easy3d::State::VERTEX, "v:texcoord", tex);
89
90 // -------------------------------------------------------------------------------
91
92 // run the viewer
93 return viewer.run();
94}
95
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
TrianglesDrawable * get_triangles_drawable(const std::string &name) const
Definition: renderer.cpp:304
A halfedge data structure for polygonal meshes of 2-manifold.
Definition: surface_mesh.h:52
VertexProperty< T > add_vertex_property(const std::string &name, const T t=T())
Definition: surface_mesh.h:1374
OpenGL texture.
Definition: texture.h:44
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