Documentation

MotionMaster 3D 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.

Get MotionMaster 3D Read tutorials

Workflow steps

  1. Open Lens Distortion / STMap in the Heavy panel.
  2. Choose Auto Parameters or enter every parameter in the model-specific order shown in the UI.
  3. Run Heavy Tracking.
  4. If several Heavy runs exist, scan their parent folder in Import Results and choose the required Solved Result.
  5. Export Calibration to write lens_export/lens_calibration.json.
  6. Export STMaps to write undistort_stmap.exr, redistort_stmap.exr, and stmap_manifest.json.

Important details

The bundled models are SIMPLE_PINHOLE, PINHOLE, SIMPLE_RADIAL, RADIAL, OPENCV, OPENCV_FISHEYE, FULL_OPENCV, FOV, SIMPLE_RADIAL_FISHEYE, RADIAL_FISHEYE, THIN_PRISM_FISHEYE, and RAD_TAN_THIN_PRISM_FISHEYE. Manual values are validated for count, finite numbers, focal length, and model-specific constraints before processing starts.

Calibration JSON stores raw camera IDs, model names, source resolution, params in exact COLMAP order, named parameters, source result folder, and the frame-to-camera map needed by zoom shots.

STMaps are 32-bit float images with normalized bottom-left UV coordinates: R is U and G is V. The undistort map samples the distorted source plate into an undistorted image; the redistort map samples undistorted CG or comp output back into the original plate geometry. When a COLMAP Undistorted workspace exists, its camera and resolution define the target. Otherwise the exporter warns that the maps are model-based at source resolution.

Related docs

Continue with the connected workflow

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.

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.

Camera Footage Projection

Camera Footage Projection creates a live, non-destructive front projection from a tracked camera background image, sequence, or movie clip onto a mesh.