v0.18.0

This release adds support for texture maps with seams. When a texture map contains seams, the vertices at the seams are usually duplicated, and then some of the triangle indices are different in uv space from the triangulation of the 3D vertices. This change allows to support the texture coordinates of the full-head 4D Face Model (4DFM).

• The MorphableModel file format version was increased to 4 to store an additional member containing the uv triangulation (85cc563)
• Updated extract_texture to support uv coordinates with seams (a70ded3)

Other minor changes:

• Made the return type of get_texture_coordinates const ref (3a25d52)

Please also have a look at the changes in v0.17.0.

v0.17.0

This is a release with quite a few nice changes and improvements. Please read through the release notes carefully.
This release was in the devel branch for a few months, and never actually left the devel branch. The MorphableModel format version was increased to 3, from adding landmark_definitions. Since there are quite a few model files with this version in circulation, it was deemed best to make it an "official" model version and release it as v0.17.0.

Major changes & improvements:

• Added (optional) landmark definitions to the MorphableModel class (8fcc2bf)
  Models can now optionally store landmark/vertex definitions, for example mappings like "eye.right.outer_corner" <=> 177 from a generic name to vertex ids - and then a second mappings file can be used, that maps from 2D landmark identifiers (like the number 37 from ibug) to these generic names ("eye.right.outer_corner"). This separates the vertex definition from a particular set of 2D landmarks.
  Alternatively, users can still use direct mappings, like in the file ibug_to_sfm.txt, which map directly from 2D landmark identifiers to 3D vertex indices.
• Added a getter to MorphableModel for landmark_definitions (e995b07)
• Set the vertex_idx in the fitting depending on whether the model contains landmark definitions (f123e51)
• Revamped the Image class to a better and more future-proof design (14b7f6f)
  Note: The storage order is now row-major, as opposed to col-major before. In the future, we may add means to choose the storage order.
• Added natvis file for Image Watch for eos::core::Image (be436f4)

Fixes:

• Fix mpark::variant compilation error on VS >=15.8; Updated pybind11 submodule to fix errors on VS 15.8 (a45a888, ecc6269)

Minor improvements, potentially breaking changes:

• Renamed get_all_mappings() to get_mappings() (9e0f539)
• Created new directory eos/core/image/ and moved Image_opencv_interop.hpp there (ad06db1)
• Return triangle_list by const reference (a7ede7b)
• Exposed a few more things to the Python bindings, particularly landmark-mappings related, and added some __repr__ methods.
• Removed the unused initial_rendering_params parameter from fit_shape_and_pose (ba46285)

Other minor changes/improvements:

• Exposed some parameters of the contour fitting to callers (54ade09, abb2dd7, 3929d0c)
• Improved read_obj a bit to handle a few more cases. Still, don't rely on it to parse every .obj file, it's not meant to do that. Use your own or assimp or something like that.

And as always, various small improvements to the code style and to the documentation.

v0.16.1

A few minor updates and fixes:

Fixes:

• Added missing inline to draw_sample (a6900a2)
• Fixed constructing a 4x4 rotation matrix R instead of 3x3 in the Python bindings of ScaledOrthoProjectionParameters (5863f3b)

Updates:

• Moved render::Rect to core namespace
• Added Python bindings for eos::core::Rect and eos::core::Landmark<Eigen::Vector2f>. The Python bindings are now using Landmark and LandmarkCollection natively, without having to keep a separate list of landmark identifiers.
• Added README.md as long_description for PyPI (link)
• Minor README.me/initial_cache.cmake.template updates

v0.16.0

This is a major release, bringing full support for expression PCA models. MorphableModels can now either contain no expression model, a set of blendshapes, or a PCA expression model.
The fit_shape_and_pose supports both as well, and calls either the _linear or _nnls solver, depending on whether a model contains blendshapes or an expression PCA model.

The main changes that go along with that:

• Updated the MorphableModel file format to version to 2 to include an optional expression model. Version 1 models can still be read.
• Added a flag ExpressionModelType to MorphableModel to easily query the type of the expression model.

Note: The behaviour of MorphableModel::get_mean() has been changed: It now returns the overall shape and expression mean. (see #188)

Other small additions:

• Updated the BFM2017 converter script to convert and save the expression PCA model too.
• Added a fitting function for fixed, given correspondences, that runs the fitting loop without contour fitting. (see here)
• The online doxygen documentation has been updated to v0.16.0.

As always, when updating from the GitHub repository, make sure to run git submodule update --init --recursive.

The binary files are provided for convenience only - it is recommended to build the examples from source, and use the library by cloning the GitHub repository.

Windows binaries are compiled with Windows 10 64bit, Visual Studio 2017. A .whl with python bindings for python 3.6 is available on PyPI.
Linux binaries are compiled with Linux Mint 18.3, based on Ubuntu 16.04, gcc-7. Make sure to follow the instructions for how to use gcc-7 with pip if using the Python bindings on Linux.

v0.15.1

This release improves a few crucial things over the last release.

Support for pre-C++17 compilers should be a lot better again - eos compiles again in C++14 mode on VS 2017, and, although not officially tested in CI, likely also compiles again with the likes of g++-5:

• eos now seemlessly uses akrzemi1::optional on all pre-C++17 compilers, not only on Apple platforms.
• Serialisation for optional also works correctly on all platforms (pre-C++17 and C++17 compilers); and updated cereal to the latest develop branch commit.
• optional now also works within the python bindings for pre-C++17 and C++17 compilers.
• Added eos::cpp17::clamp, which uses std::clamp on C++17 compilers, or a fallback otherwise.

Matlab bindings:

• Updated the eos-matlab-fitting bindings! They now work again in the latest version to use the fitting from Matlab.
• Disabled the eos-matlab-render bindings for now, as they would be more work to update. Having the fitting bindings back should suffice for most use cases.

Other small things:

• A few small improvements to the main CMakeLists.txt (86fbfa1).
• Fixed a missing inline, missing include, added a few consts, a couple documentation updates.

v0.15.0

eos is now fully working on Apple Xcode again and CI-tested with Xcode 9.2.

Main changes:

• Use of eos::cpp17::optional throughout the code base, to support platforms that do not have <optional> yet (currently only macOS - #ifdef __APPLE__). It is a namespace alias, and will be resolved to std::optional on compilers that have <optional>.
• akrzemi1/Optional is directly integrated into eos and used on macOS
• Added official eigen-git-mirror as submodule at tag 3.3.4, instead of the patrikhuber/eigen fork
• Updated Keyframe-related code to work again with the latest eos version
• Minor other improvements and updates (see v0.14.0...v0.15.0 for all the details)

v0.14.0

This is an update release with various small improvements throughout and two highlights:
One major highlight is proper (and tested) support for the BFM2009 (and partially the BFM2017).
Another highlight is that the multi_image_fit_devel branch is finally merged into master, and multi-frame fitting is thus now available in the main version.

The changes include, alongside other minor changes:

• Merged multi-frame fitting from multi_image_fit_devel branch. Thank you very much @PhilippKopp for the contribution!
• Added new (and correct) script to convert the BFM2009
• Added script to convert the BFM2017
• Updated syntax of the ibug_to_bfm*.txt files to TOML
• Add Python and Matlab scripts to generate edge-topology files
• Updated wiki with all BFM info & files (link)
• Clamping the colours to [0, 1] in sample_to_mesh
• Check find_if result for std::end in get_nearest_contour_correspondences to avoid continuing in Release builds without any error message
• Added lots of const qualifiers where possible
• Ran clang-format on the whole codebase
• Added some minor useful things to the Python bindings (e.g. default c'tors for Mesh and Blendshape)
• Updated Ceres code and example to work with the recent eos changes

v0.13.0

This release contains some major changes, mainly to the software-side of the library, and not to the algorithms.

• The library is now completely free of external dependencies, it does not depend on Boost and OpenCV anymore. All dependencies are header-only and included as submodules.
• The minimum required compilers are gcc-7, clang-5 and VS2017 Update 3.
• Changed the configuration file format from the custom boost::property_tree format to TOML. This mainly affects share/ibug_to_sfm.txt.

All in all, these changes make using the library much easier, and they should especially enable installation of the python bindings via pip install eos-py on any system, given >=cmake-3.8.2 and a recent compiler.

The changes, alongside other minor changes, include:

• Replacing all OpenCV vector types with Eigen::Vector
• Replacing glm types in the Python bindings with Eigen types
• Changed the pose fitting from OpenCV to Eigen - this could potentially be a bit of a speed-up
• Added own Image class (very basic, just covering the barebones needed to replace cv::Mat and to represent images). There is a converter function to and from cv::Mat (eos/core/Image_opencv_interop.hpp))
• Added functions to load and save PCA models (6c31092)
• Added ibug to BFM landmark mappings (5dbff1e)
• Updated all submodules to their newest versions
• Many more small fixes and improvements (documentation fixes, added 'const' in many places, etc.)

v0.12.2

This is a minor release, mainly adding functionality to build PCA models (include/eos/pca/pca.hpp).

This will be the last version that supports gcc-5, clang-3.x, and VS2015. The next release will require >=gcc-7, >=clang-5 and >=VS2017U3.

Other minor changes:

• Fix for texture mapping into destination image 6875e08
• Fixed some missing inlines, added lots of const, improved documentation, updates of submodules
• gcc-4.9 support removed

v0.12.1

This update brings a major speed-up of the shape and blendshape fitting. Depending on the setup (model resolution used, number of coefficients fitted), the speed-up is around 3x to 50x - typically around 10x. The shape and blendshape fitting now take only around or below 1ms per iteration (previously ~10ms). This was achieved by changing all linear algebra operations from OpenCV to Eigen.

Please see also the release notes of v0.12.0 below for the latest changes and updates, some of them breaking changes. See also the release notes of v0.12.0 for information on the PyPi package (eos-py) and the provided binaries.