Skip to content

K-Meech/image-matcher

Repository files navigation

image-matcher

Add-on for Blender that allows matching multiple 2D images to a corresponding 3D model. This uses OpenCV's Perspective-n-Point solver to estimate camera intrinsics (e.g. focal length, distortion coefficients) and extrinsics (camera position and orientation) based on pairs of 2D and 3D points.

This add-on builds on RT Studio's Camera Pnpoint Blender plugin: https://rtstudios.gumroad.com/l/camera_pnpoint / https://github.com/RT-studios/camera-pnpoint Do consider buying their addon on gumroad/blender market to help support them making great Blender addons!

This plugin adds:

  • Easier matching of multiple 2D images
  • Point mode to allow one click addition of 2D/3D points
  • UI to visualise list of points for each image
  • Easier adjustment of camera parameters / background image directly in the plugin UI
  • Export of camera parameters to JSON

For more information on the Perspective-n-Point process, see OpenCV's documentation: https://docs.opencv.org/4.x/d5/d1f/calib3d_solvePnP.html

Installation + Tutorials

Examples

You can see an example video moving between matched positions here: https://www.youtube.com/watch?v=zqXh3yGqvkA This uses publicly available data of the Ramesses II statue from the British Museum (data from Sketchfab and Collection Online)

Example match on Ramesses II statue

Releases

Github Actions runs on this repository to automatically create releases when a commit is pushed to main with a version tag like v1.0.0. This will automatically create a zip file with only the required python files for installation in Blender.

To trigger this:

# Add a tag to last commit (on main)
git tag v1.0.0
git push origin --tags

About

Blender addon for matching 2D images and 3D models

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages