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

Optional[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

Optional[c4d.modules.motiontracker.MtData]

Returns

The tracking data for the current frame, or None if it does not exist.