MovieTrackingSettings(bpy_struct)

base class — bpy_struct

class bpy.types.MovieTrackingSettings(bpy_struct)

Match moving settings

clean_action

Cleanup action to execute

  • SELECT Select, Select unclean tracks.
  • DELETE_TRACK Delete Track, Delete unclean tracks.
  • DELETE_SEGMENTS Delete Segments, Delete unclean segments of tracks.
Type :enum in [‘SELECT’, ‘DELETE_TRACK’, ‘DELETE_SEGMENTS’], default ‘SELECT’
clean_error

Effect on tracks which have a larger re-projection error

Type :float in [0, inf], default 0.0
clean_frames

Effect on tracks which are tracked less than the specified amount of frames

Type :int in [0, inf], default 0
default_correlation_min

Default minimum value of correlation between matched pattern and reference that is still treated as successful tracking

Type :float in [0, 1], default 0.0
default_frames_limit

Every tracking cycle, this number of frames are tracked

Type :int in [0, 32767], default 0
default_margin

Default distance from image boundary at which marker stops tracking

Type :int in [0, 300], default 0
default_motion_model

Default motion model to use for tracking

  • Perspective Perspective, Search for markers that are perspectively deformed (homography) between frames.
  • Affine Affine, Search for markers that are affine-deformed (t, r, k, and skew) between frames.
  • LocRotScale LocRotScale, Search for markers that are translated, rotated, and scaled between frames.
  • LocScale LocScale, Search for markers that are translated and scaled between frames.
  • LocRot LocRot, Search for markers that are translated and rotated between frames.
  • Loc Loc, Search for markers that are translated between frames.
Type :enum in [‘Perspective’, ‘Affine’, ‘LocRotScale’, ‘LocScale’, ‘LocRot’, ‘Loc’], default ‘Loc’
default_pattern_match

Track pattern from given frame when tracking marker to next frame

  • KEYFRAME Keyframe, Track pattern from keyframe to next frame.
  • PREV_FRAME Previous frame, Track pattern from current frame to next frame.
Type :enum in [‘KEYFRAME’, ‘PREV_FRAME’], default ‘KEYFRAME’
default_pattern_size

Size of pattern area for newly created tracks

Type :int in [5, 1000], default 0
default_search_size

Size of search area for newly created tracks

Type :int in [5, 1000], default 0
distance

Distance between two bundles used for scene scaling

Type :float in [-inf, inf], default 1.0
object_distance

Distance between two bundles used for object scaling

Type :float in [0.001, 10000], default 1.0
reconstruction_success_threshold

Threshold value of reconstruction error which is still considered successful

Type :float in [0, inf], default 0.001
refine_intrinsics

Refine intrinsics during camera solving

  • NONE Nothing, Do not refine camera intrinsics.
  • FOCAL_LENGTH Focal Length, Refine focal length.
  • FOCAL_LENGTH_RADIAL_K1 Focal length, K1, Refine focal length and radial distortion K1.
  • FOCAL_LENGTH_RADIAL_K1_K2 Focal length, K1, K2, Refine focal length and radial distortion K1 and K2.
  • FOCAL_LENGTH_PRINCIPAL_POINT_RADIAL_K1_K2 Focal Length, Optical Center, K1, K2, Refine focal length, optical center and radial distortion K1 and K2.
  • FOCAL_LENGTH_PRINCIPAL_POINT Focal Length, Optical Center, Refine focal length and optical center.
  • RADIAL_K1_K2 K1, K2, Refine radial distortion K1 and K2.
Type :enum in [‘NONE’, ‘FOCAL_LENGTH’, ‘FOCAL_LENGTH_RADIAL_K1’, ‘FOCAL_LENGTH_RADIAL_K1_K2’, ‘FOCAL_LENGTH_PRINCIPAL_POINT_RADIAL_K1_K2’, ‘FOCAL_LENGTH_PRINCIPAL_POINT’, ‘RADIAL_K1_K2’], default ‘NONE’
show_default_expanded

Show the expanded in the user interface

Type :boolean, default False
speed

Limit speed of tracking to make visual feedback easier (this does not affect the tracking quality)

  • FASTEST Fastest, Track as fast as it’s possible.
  • DOUBLE Double, Track with double speed.
  • REALTIME Realtime, Track with realtime speed.
  • HALF Half, Track with half of realtime speed.
  • QUARTER Quarter, Track with quarter of realtime speed.
Type :enum in [‘FASTEST’, ‘DOUBLE’, ‘REALTIME’, ‘HALF’, ‘QUARTER’], default ‘FASTEST’
use_default_blue_channel

Use blue channel from footage for tracking

Type :boolean, default False
use_default_brute

Use a brute-force translation-only initialization when tracking

Type :boolean, default False
use_default_green_channel

Use green channel from footage for tracking

Type :boolean, default False
use_default_mask

Use a grease pencil datablock as a mask to use only specified areas of pattern when tracking

Type :boolean, default False
use_default_normalization

Normalize light intensities while tracking (slower)

Type :boolean, default False
use_default_red_channel

Use red channel from footage for tracking

Type :boolean, default False
use_fallback_reconstruction

Use fallback reconstruction algorithm in cases main reconstruction algorithm failed (could give better solution with bad tracks)

Type :boolean, default False
use_keyframe_selection

Automatically select keyframes when solving camera/object motion

Type :boolean, default False
use_tripod_solver

Use special solver to track a stable camera position, such as a tripod

Type :boolean, default False

Inherited Properties

Inherited Functions

References

Previous topic

MovieTrackingReconstruction(bpy_struct)

Next topic

MovieTrackingStabilization(bpy_struct)