Skip to content

Commit 29141c6

Browse files
committed
Added section about 4DFM to the Readme
1 parent b8d775e commit 29141c6

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ eos is a lightweight 3D Morphable Face Model fitting library that provides basic
1313

1414
At the moment, it mainly provides the following functionality:
1515

16-
* MorphableModel and PcaModel classes to represent 3DMMs, with basic operations like `draw_sample()`. Supports the Surrey Face Model (SFM) and the Basel Face Model (BFM) 2009 and 2017 out-of-the-box
16+
* MorphableModel and PcaModel classes to represent 3DMMs, with basic operations like `draw_sample()`. Supports the Surrey Face Model (SFM), 4D Face Model (4DFM), and the Basel Face Model (BFM) 2009 and 2017 out-of-the-box
1717
* Our low-resolution, shape-only 3D Morphable Face Model ([share/sfm_shape_3448.bin](https://github.com/patrikhuber/eos/blob/master/share/sfm_shape_3448.bin))
1818
* Fast, linear pose, shape and expression fitting, edge and contour fitting:
1919
* Linear scaled orthographic projection camera pose estimation
@@ -83,10 +83,19 @@ See [examples/fit-model.cpp](https://github.com/patrikhuber/eos/blob/master/exam
8383

8484
The library includes a low-resolution shape-only version of the Surrey Morphable Face Model. It is a PCA model of shape variation built from 3D face scans. It comes with uv-coordinates to perform texture remapping.
8585

86-
<img src="https://raw.githubusercontent.com/patrikhuber/eos/gh-pages/images/sfm_shape_3448_mesh.png" width=20% alt="Face Model Picture"></img>
86+
<img src="https://raw.githubusercontent.com/patrikhuber/eos/gh-pages/images/sfm_shape_3448_mesh.png" width=20% alt="Surrey Face Model shape picture"></img>
8787

8888
The full model is available at [http://www.cvssp.org/facemodel](http://www.cvssp.org/facemodel).
8989

90+
## 4D Face Model (4DFM)
91+
92+
eos can be used to load, use and do basic fitting with the 4D Face Model (4DFM) from [4dface Ltd](https://www.4dface.io). The model features 36 expressions/action units, and diverse identity variation.
93+
94+
<img src="https://raw.githubusercontent.com/patrikhuber/eos/gh-pages/images/4dfm_color_sample.jpg" width=20% alt="4D Face Model colour picture"></img>
95+
<img src="https://raw.githubusercontent.com/patrikhuber/eos/gh-pages/images/4dfm_shape.png" width=20% alt="4D Face Model shape picture"></img>
96+
97+
More information about the model can be found on [www.4dface.io/4dfm](https://www.4dface.io/4dfm/).
98+
9099
## Python bindings
91100

92101
eos includes python bindings for some of its functionality (and more can be added!). It can be installed from [PyPI](https://pypi.org/project/eos-py/) with `pip install eos-py`. You will still need the data files from this repository.

0 commit comments

Comments
 (0)