Perspective Matcher

Perspective Matcher helps align a Blender camera to a still image when there is no video track. It uses perspective guide lines, vanishing points, focal length estimates, origin controls, and camera orientation tools.

How to use it

  1. 1 Load a reference image.
  2. 2 Start Perspective Match with an active camera.
  3. 3 Drag red and green guide lines onto parallel real-world lines.
  4. 4 Adjust origin and principal point settings if needed.
  5. 5 Apply the computed camera perspective.

Perspective Matcher Panel

The Perspective Matcher aligns a Blender camera to a single still image when there is no video to track, such as an architectural photo or a product shot. You drag guide lines onto parallel lines in the photo, and it computes the camera rotation and focal length from the vanishing points.

Reference Image

Click Load Image and choose the photo. Its file name appears with a check mark once it is loaded.

Perspective Match

  • •
    Up Axis: which axis points up in the scene, usually Z Up.
  • •
    Custom Principal Point: use your own optical center (Center X and Center Y) instead of the image center, for cropped or shifted photos.

Click Start Perspective Match. The scene needs a camera; if there is none, the button says so. In the viewport, drag the handles of the guide lines onto real parallel lines in the photo: red for the X axis and green for the Y axis, for example two edges of a building or the lines of a floor. Use Ctrl+Z and Ctrl+Y to undo and redo, Enter to apply and Esc to cancel, or click Done in the panel.

Origin Point

Distance sets how far the scene origin is from the camera, in scene units. It sets the scale of the matched scene, so use a real measurement if you know one.

Results

While matching, the panel shows the computed focal length in pixels and millimetres and the camera rotation. If the result faces the wrong way, use Flip X, Flip Y or Flip Z. Click Apply to Camera to write the result to the camera.

Technical notes

This is useful for architectural reference photos, product visualization, still-image VFX, and shots where a normal camera track is not available.

The tool can live-update the camera, show focal length in pixels and millimeters, support undo/redo inside the modal tool, and flip orientation around axes when needed.

Docs Select Footage and Video Conversion

The Select Footage panel prepares video or image sequences before tracking. It can convert videos to numbered PNG sequences, downscale large image sequences, and keep source footage organized for Quick, Heavy, Dense, Mesh, and Batch workflows.

Docs Floor Alignment

The Aligner panel turns arbitrary reconstruction orientation into a usable Blender scene. It can snap selected floor points to the XY plane and flip inverted tracks.

Docs Heavy Tracking

Heavy Tracking is the primary high-quality workflow for camera reconstruction and solved lens data. Use it when the shot needs strong solve quality, a specific distortion model, calibration/STMap export, masks, undistortion, dense point clouds, or mesh generation.