Skip to content

Commit daa4e9e

Browse files
authored
Added Matlab bindings section to Readme
1 parent df5f1c7 commit daa4e9e

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

README.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ At the moment, it mainly provides the following functionality:
2222
* Edge-fitting, heavily inspired by: A. Bas et al., _Fitting a 3D Morphable Model to Edges: A Comparison Between Hard and Soft Correspondences_, ACCVW 2016
2323
* Isomap texture extraction to obtain a pose-invariant representation of the face texture
2424
* (_Experimental_): Non-linear fitting cost functions using Ceres for shape, camera, blendshapes and the colour model (needs Ceres to be installed separately)
25-
* (_**New**, experimental_): Python bindings for parts of the library
25+
* (_**New**, experimental_): Python bindings for parts of the library, and Matlab bindings for the fitting
2626

2727
## Usage
2828

@@ -97,6 +97,12 @@ sample = np.array(s) # the conversion from 'Mat' to a numpy array is necessary a
9797
help(eos) # check the documentation
9898
```
9999

100+
## Matlab bindings
101+
102+
_Experimental_: eos includes Matlab bindings for the `fit_shape_and_pose(...)` function, which means the fitting can be run from Matlab. Set `-DGENERATE_MATLAB_BINDINGS=on` when running `cmake` to build the required mex-file and run the `INSTALL` target to install everything. (Set `Matlab_ROOT_DIR` to point to your Matlab directory if it's not found automatically). More bindings (e.g. the MorphableModel itself) might be added in the future.
103+
104+
Go to the `install/eos/matlab` directory and run [`demo.m`](https://github.com/patrikhuber/eos/blob/master/matlab/demo.m) to see how to run the fitting. The result is a mesh and rendering parameters (pose).
105+
100106
## Documentation
101107

102108
Doxygen: http://patrikhuber.github.io/eos/doc/

0 commit comments

Comments
 (0)