Commit daa4e9ea authored by Patrik Huber's avatar Patrik Huber Committed by GitHub

Added Matlab bindings section to Readme

parent df5f1c75
...@@ -22,7 +22,7 @@ At the moment, it mainly provides the following functionality: ...@@ -22,7 +22,7 @@ At the moment, it mainly provides the following functionality:
* 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 * 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
* Isomap texture extraction to obtain a pose-invariant representation of the face texture * Isomap texture extraction to obtain a pose-invariant representation of the face texture
* (_Experimental_): Non-linear fitting cost functions using Ceres for shape, camera, blendshapes and the colour model (needs Ceres to be installed separately) * (_Experimental_): Non-linear fitting cost functions using Ceres for shape, camera, blendshapes and the colour model (needs Ceres to be installed separately)
* (_**New**, experimental_): Python bindings for parts of the library * (_**New**, experimental_): Python bindings for parts of the library, and Matlab bindings for the fitting
## Usage ## Usage
...@@ -97,6 +97,12 @@ sample = np.array(s) # the conversion from 'Mat' to a numpy array is necessary a ...@@ -97,6 +97,12 @@ sample = np.array(s) # the conversion from 'Mat' to a numpy array is necessary a
help(eos) # check the documentation help(eos) # check the documentation
``` ```
## Matlab bindings
_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.
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).
## Documentation ## Documentation
Doxygen: http://patrikhuber.github.io/eos/doc/ Doxygen: http://patrikhuber.github.io/eos/doc/
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment