c4d.modules.motiontracker.Mt2dTrack

class c4d.modules.motiontracker.Mt2dTrack

New in version R18.020.

Overview

Mt2dTrack.GetName

Retrieves the name of the track.

Mt2dTrack.GetId

Retrieves the global ID of the track.

Mt2dTrack.GetStatus

Retrieves the track status.

Mt2dTrack.GetFramesWithTrackData

Retrieves the frames on which the track has data.

Mt2dTrack.GetDataForFrame

Retrieves the motion tracking data for the given frame.

Mt2dTrack.GetDataForCurrentFrame

Retrieves the track data for the current frame.

Members

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.