Skip to content
Rastering algorithm to approximate the rendering of a 3D model silhouette in a fully differentiable way.
Python
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data
img
rastering
.gitignore
LICENSE
README.md
__init__.py
main.py

README.md

Differentiable mesh renderer [Tensorflow]

Rastering algorithm to approximate the rendering of a 3D model silhouette in a fully differentiable way.

➡️ PyTorch implementation now available in the pytorch branch!


This code accompanies the paper:

"End-to-end 6-DoF Object Pose Estimation through Differentiable Rasterization"

Andrea Palazzi, Luca Bergamini, Simone Calderara, Rita Cucchiara

appeared in "Second Workshop on 3D Reconstruction Meets Semantics (3DRMS)" at ECCVW 2018.

Rotation on Y axis
Rendering while rotating the camera around Y axis.

Rotation on Z axis
Rendering while rotating the camera around Z axis.


Docs

Input meshes

The input meshes are expected to be np.ndarray of shape (n_triangles, 3, 3). Each mesh can be composed of a variable number of triangles. Five meshes of car 3D models are already in data/ directory to test the Rasterer.

Hello World

A short snippet to test the Rasterer is available in main.py. Just run it.

Three 3D models are randomly sampled from the dummy dataset and rendered in a batch. In this snippet the position of the camera is kept fixed for all three (but it may be changed).

If everything went fine, you should see the rendering output for the 3D models sampled. Something like this:

render_output
Output with resolution=(128, 128)

Moving the camera in the 3D world

There is a class RotoTranslation which encapsulates the camera matrix, providing an easy way to change the camera location while always mantaining a geometrically consistent pose.

The initial camera pose is set as:

camera_pose = RotoTranslation(rotation=Vector(x=90., y=0., z=0.),
                              translation=Vector(x=0., y=-8., z=0.),
                              angle_unit='degrees')

To change its position, simply use its setters:

  • alpha_x, alpha_y, alpha_z to change the rotation angle around respective axes
  • t_x, t_y, t_z to change the translation along respective axes

License

This code is released under MIT license. In case you use this code in your academic work, please cite the following paper:

@inproceedings{palazzi2018end,
  title={End-to-end 6-DoF Object Pose Estimation through Differentiable Rasterization},
  author={Palazzi, Andrea and Bergamini, Luca and Calderara, Simone and Cucchiara, Rita},
  booktitle={Second Workshop on 3D Reconstruction Meets Semantics (3DRMS)},
  year={2018}
}
You can’t perform that action at this time.