c4d.modules.motiontracker.Mt2dTrack

class c4d.modules.motiontracker.Mt2dTrack

New in version R18.020.

Methods Signatures

Mt2dTrack.GetName(self) Retrieves the name of the track.
Mt2dTrack.GetId(self) Retrieves the global ID of the track.
Mt2dTrack.GetStatus(self) Retrieves the track status.
Mt2dTrack.GetFramesWithTrackData(self) Retrieves the frames on which the track has data.
Mt2dTrack.GetDataForFrame(self, frameNum) Retrieves the motion tracking data for the given frame.
Mt2dTrack.GetDataForCurrentFrame(self) Retrieves the track data for the current frame.

Methods Documentation

Mt2dTrack.GetName(self)

Retrieves the name of the track.

Return type:str
Returns:The name of the track.
Mt2dTrack.GetId(self)

Retrieves the global ID of the track.

Return type:c4d.modules.motiontracker.MtTrkGid
Returns:The global ID of the track.
Mt2dTrack.GetStatus(self)

Retrieves the track status.

Return type:int
Returns:The track status:
INVALID_TRACK Not a valid track.
UNTRACKED Has not yet been tracked.
TRACKED_VALID Has been tracked, and is up to date.
TRACKED_STALE Has been tracked, but needs updating. (Changes have been made, but has not yet been retracked.)
Mt2dTrack.GetFramesWithTrackData(self)

Retrieves the frames on which the track has data.

Return type:c4d.BaseSelect
Returns:The frames with track data.
Mt2dTrack.GetDataForFrame(self, frameNum)

Retrieves the motion tracking data for the given frame.

Parameters:frameNum (int) – The frame number.
Return type:c4d.modules.motiontracker.MtData
Returns:The tracking data, or None if it does not exist for the requested frame.
Mt2dTrack.GetDataForCurrentFrame(self)

Retrieves the track data for the current frame.

Return type:c4d.modules.motiontracker.MtData
Returns:The tracking data for the current frame, or None if it does not exist.