c4d.modules.motiontracker.Mt2dTrack

class c4d.modules.motiontracker.Mt2dTrack

New in version R18.020.

Overview

Motion Data

Mt2dTrack.GetDataForCurrentFrame()

Retrieves the track data for the current frame.

Mt2dTrack.GetDataForFrame()

Retrieves the motion tracking data for the given frame.

Mt2dTrack.GetFramesWithTrackData()

Retrieves the frames on which the track has data.

Track Metadata

Mt2dTrack.GetId()

Retrieves the global ID of the track.

Mt2dTrack.GetName()

Retrieves the name of the track.

Mt2dTrack.GetStatus()

Retrieves the track status.

Members

Motion Data

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.

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.GetFramesWithTrackData(self)

Retrieves the frames on which the track has data.

Return type

c4d.BaseSelect

Returns

The frames with track data.

Track Metadata

Mt2dTrack.GetId(self)

Retrieves the global ID of the track.

Return type

c4d.modules.motiontracker.MtTrkGid

Returns

The global ID of the track.

Mt2dTrack.GetName(self)

Retrieves the name of the track.

Return type

str

Returns

The name 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.)