An Open Mesh Effect plug-in for VCGlib

To summarize, this project enables one to use the geometry filters implemented in MeshLab in other softwares such as Blender. It is an Open Mesh Effect plug-in that exposes mesh filters provided by the VCGlib to any host. VCGlib is the library at the core of MeshLab, an open source software awarded for its proximity with scientific research on geometry processing. An Open Mesh Effect host is a Digital Content Creation tool able to load Open Mesh Effect plug-ins, for instance this branch of Blender.

This repository contains submodules to include the VCGlib repository, so do not use the download zip button provided by GitHub. To clone the repository using git, run:

git clone --recurse-submodules https://github.com/eliemichel/MfxVcg.git

If you forgot to use the --recurse-submodules, you can get submodules with:

git submodule update --init --recursive

This is a standard CMake project. Building it consits in running:

mkdir build
cd build
cmake ..

Alternatively, you can run one of the build-something scripts.

Once CMake has run, you can build the project using your favorite IDE or with the following command line in the build directory:

cmake --build . --config Debug

The output of the build is not an executable. It is an OpenFX plug-in called MfxVCG.ofx. It is created within the build directory, in src or src/Debug or src/Release or something similar depending on your compiler.

You can open this plug-in in any Open Mesh Effect host, for instance the Open Mesh Effect for Blender branch using an Open Mesh Effect modifier.

This plug-in currently is a proof of concept. It provides two example filters: convex hull generation and laplacian filter. To add more filters, look for all the instances of MAX_PLUGINS, they come with comments about what to do when increasing it.

This software as a whole is released under the terms of the GPLv3 license. Some of its part uses the Apache 2 license. See LICENSE.txt and copyright notices in individual files for details.

MfxVCG is an Open Mesh Effect plug-in providing VCGlib-based filters.
Copyright (C) 2019  Élie Michel

This program 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.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.