cflores86 / easy3d Goto Github PK

(This 3D model of the Easy3D logo was generated and rendered by Easy3D).

• Efficient data structures for representing and managing 3D models (i.e., point clouds, meshes, and graphs). Easy to add/access arbitrary types of per-element properties. Non-manifoldness is automatically resolved when loading models from files ...

• A set of widely used algorithms, e.g., point cloud normal estimation/re-orientation, Poisson Surface Reconstruction, RANSAC, mesh simplification, subdivision, smoothing, parametrization, remeshing, and more.

• A bunch of rendering techniques, e.g., point/line imposters, ambient occlusion (SSAO), hard shadow (shadow maps), soft shadow (PCSS), eye-dome lighting (for rendering point clouds without normal information), transparency (average color blending, dual depth peeling), and more.

• High-level encapsulation of OpenGL and GLSL for convenient and efficient rendering (based on modern and faster programmable-shader-style rendering, i.e., no fixed function calls). Client code does not need to touch the low-level APIs of OpenGL.

• Step-by-step tutorials to get acquainted with the data structures, rendering techniques, and algorithms for 3D modeling and geometry processing.

• A viewer that can be used directly to visualize 3D scenes in various formats, which can also be easily extended.

• A handy tool Mapple created out of the Easy3D library for rendering and processing 3D data.

Any types of 3D drawables (e.g., points, lines, triangles, and thus point clouds, mesh surfaces, scalar fields, vector fields) can be rendered by writing a few lines of code with Easy3D. For example, the following code renders a point cloud as a set of spheres

        // assume your point cloud has been loaded to the viewer
        PointsDrawable* drawable = cloud->renderer()->get_points_drawable("vertices");
        drawable->set_impostor_type(PointsDrawable::SPHERE); // draw points as spheres.
        drawable->set_point_size(3.0f);    // set point size

or as a set of surfels (i.e., 3D discs)

        drawable->set_impostor_type(PointsDrawable::SURFEL);

By abstracting geometric elements as one of the above drawables, more general visualization (e.g., vector fields, scalar fields) can be done very conveniently.

Easy3D depends on some third-party libraries. All dependencies necessary for the core functionality and the basic viewer are included in the distribution. So you don't need to do anything about third-party libraries. Easy3D also supports the use of Qt. You can switch on the following CMake option to include the related examples and applications (e.g., Tutorial_202_Viewer_Qt and Mapple) in your build:

• EASY3D_ENABLE_QT

To build Easy3D, you need CMake and, of course, a compiler:

• CMake >= 3.1
• a compiler that supports >= C++11

Easy3D has been tested on macOS (Xcode >= 8), Windows (MSVC >=2015), and Linux (GCC >= 4.8, Clang >= 3.3). Machines nowadays typically provide higher supports, so you should be able to build Easy3D on almost all platforms.

There are many options to build Easy3D. Choose one of the following (or whatever you are familiar with):

• Option 1: Use any IDE that can directly handle CMakeLists files to open the CMakeLists.txt in the root directory of Easy3D. Then you should have obtained a usable project and just build. I recommend using CLion or QtCreator.
• Option 2: Use CMake to generate project files for your IDE. Then load the project to your IDE and build.
• Option 3: Use CMake to generate Makefiles and then make (on Linux/macOS) or nmake(on Windows with Microsoft Visual Studio).

Don't have any experience with C/C++ programming? Have a look at How to build Easy3D step by step.

Easy3D is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License or (at your option) any later version. The full text of the license can be found in the accompanying 'License' file.

If Easy3D is useful in your research/work, I would be grateful if you show your appreciation by citing it:

@misc{easy3d2018nan,
  title = {Easy3D: a lightweight, easy-to-use, and efficient C++ library for processing and rendering 3D data},
  author = {Liangliang, Nan},
  note = {\url{https://github.com/LiangliangNan/Easy3D}},
  year = {2018},
}

Should you have any questions, comments, or suggestions, please contact me at [email protected]

Liangliang Nan

https://3d.bk.tudelft.nl/liangliang/

Dec. 8, 2018

Copyright (C) 2018