Import Results

Import Results separates processing from scene import. Scan one folder to choose among indexed Quick, Heavy, Tripod, Planar, Dense, or Mesh results and to scope the solved-lens source used by calibration and STMap export.

How to use it

  1. 1 Choose a sequence result folder or regular sequence folder.
  2. 2 Scan to detect Quick, Heavy, Tripod, Planar, Dense, Mesh, and undistorted outputs.
  3. 3 Expand a result type and select the exact indexed run you need.
  4. 4 For Heavy results, use the Heavy panel Solved Result dropdown to choose which run supplies lens calibration and STMaps.
  5. 5 Keep Smart Importer enabled for Heavy workflows when possible.
  6. 6 Import the selected outputs, then clean and align them as needed.

Import Results Panel

Import Results brings tracking results into the scene independently of the run that created them. Use it to import results from an earlier session or a batch run, to re-import a result, or to compare several runs of the same shot.

Result Folder and Scan Folder

Choose the folder in Result Folder and click Scan Folder. Point it at either:

  • •
    a batch output folder, which contains one result folder per sequence, such as mysequence_result, or
  • •
    a sequence folder from a normal run, which contains result subfolders such as heavy_track_result and quick_track_result.

Available Results

After the scan, results are grouped by type: Quick, Heavy, Tripod, Planar, Dense and Mesh. Expand a group and tick the runs you want. Repeated runs are numbered, such as heavy_track_result_2, so you can compare attempts. Runs with a dense point cloud show a point cloud icon, and runs without usable reconstruction data are marked with a warning.

  • •
    Quick results import an animated camera and a sparse point cloud.
  • •
    Heavy results import the solved camera and the sparse reconstruction; enable Import Dense Point Cloud to add the dense cloud as well.
  • •
    Mesh results import the refined or textured mesh generated from a Heavy result.
  • •
    Tripod and Planar results (Max) show extra options: the target camera for tripod solves, and for planar solves the Corner Pin, the native clip tracks, the 3D plane, Object or Camera Motion and the plane depth.

Settings

  • •
    Smart Importer (recommended): builds the camera animation from the exact frame numbers stored with each solved camera, so the camera stays in sync with the footage and gaps in the tracked frames are handled correctly.
  • •
    Use Undistorted: uses the undistorted version of the reconstruction when one exists. Undistorted results match a perfect pinhole camera, which is what Blender renders.

Click Import Selected to bring everything you ticked into the scene. Importing the same result twice creates duplicate cameras and point clouds, so delete the old objects first if you re-import.

Choosing the lens and STMap source

When a folder contains several Heavy runs, the Heavy panel's Solved Result dropdown lists each of them. The run you choose there, or the Heavy result you select here, is the one used for calibration and STMap export, so a newer run never silently replaces the lens you meant to use.

Texture Tools

Textured meshes from the reconstruction can have a flat background color, usually orange, in the unused parts of the texture atlas. Select the mesh and click Fix Texture Background: MotionMaster 3D replaces that color with the average color of the real texture, saves the result as a new numbered PNG and switches the material to it.

Background Threshold controls how close a pixel must be to the background color to be replaced. If orange is still visible, increase it; if real texture colors get replaced, decrease it.

Result folder structure

sequence_folder/
├── (your images)
├── heavy_track_result/
│   ├── database.db
│   ├── 0/
│   └── Undistorted/
│       ├── sparse/
│       ├── scene_dense.ply
│       └── scene_dense_mesh_refine.ply
├── heavy_track_result_2/     (second run)
├── quick_track_result/
│   ├── log_forward/
│   └── log_backward/
└── quick_track_result_2/     (second run)

Technical notes

Smart Importer preserves source frame numbering and gaps so imported camera animation stays aligned with the footage.

Selecting a Heavy result such as heavy_track_result_2 makes that run the active lens source. The dropdown lists the Heavy alternatives inside the folder currently scanned by Import Results, so a later run does not silently override an earlier calibration.

Tripod imports restore rotation keys and the camera adjustment rig. Planar imports can publish a Corner Pin, an editable native Plane Track, and either a camera-parented animated 3D plane (Object Motion) or a fixed plane plus animated camera (Camera Motion) at the chosen Plane Depth. Failed or cancelled result folders are not offered as importable solves; result JSON is authoritative, so outputs can be recreated without rerunning feature tracking. License-locked result types remain visible but cannot be imported by an ineligible account.

Docs Lens Calibration and STMap Export

The Heavy Tracking lens workflow preserves the complete solved COLMAP camera model and exports portable calibration JSON plus float STMaps for undistorting the original plate and redistorting CG back into it.

Docs Planar Tracking

Planar Tracking solves the perspective motion of a flat surface such as a screen, sign, wall, card, or set-extension plane. You draw an editable four-corner quad over the surface in the MotionMaster 3D Track Workspace, track it forward or backward, correct drift non-destructively, and publish a native Blender Plane Track, a compositor Corner Pin, and a 3D plane or an animated camera.

Docs Point Cloud Cleanup

Point Cloud Cleanup removes noisy or unwanted points from imported Quick, Heavy, Dense, and mesh-related point cloud objects so the reconstruction becomes easier to inspect and use.

 Guide Camera tracking software for Blender

Camera tracking software that keeps the whole VFX workflow inside Blender

 Guide Point cloud generation for Blender

Generate useful sparse and dense point clouds from tracked footage