Time Tags Access using the FrameTagManager Interface

The Time Tags are used to define reference points on the time line for quick navigation.

They are now accessible via the FrameTagManager Interface (corresponding to the IFrameTagManager interface in the SDK).

The example below demonstrates the access to time tags via MAXscript using the FrameTagManager Interface.

FOR EXAMPLE

ntags = FrameTagManager.GetTagCount() --> 0
tag1 = FrameTagManager.CreateNewTag "tag1" 15 --> 1
tag2 = FrameTagManager.CreateNewTag "tag2" 25 lockID:tag1 scale:true --> 2
tag3 = FrameTagManager.CreateNewTag "tag3" 25 scale:false-->3
loop1 = FrameTagManager.CheckForLoop tag1 tag2 --> false
loop2 = FrameTagManager.CheckForLoop tag2 tag1 --> true
loop3 = FrameTagManager.CheckForLoop tag1 tag3 --> false 
loop4 = FrameTagManager.CheckForLoop tag3 tag1 --> false
ntags = FrameTagManager.GetTagCount() --> 3
for i = 1 to ntags do
(
id = FrameTagManager.GetTagID i
tagTime = FrameTagManager.GetTimeByID id
tagLockID = FrameTagManager.GetLockIDByID id
tagName = FrameTagManager.GetNameByID id
tagScale = FrameTagManager.GetScaleByID id
format "%: id:%; name:%; time:%; lockID:%; scale:%\n" i id tagName tagTime tagLockID tagScale
)
FrameTagManager.SetTimeByID tag1 10 --> ok
FrameTagManager.SetLockIDByID tag3 tag2 --> true
FrameTagManager.SetNameByID tag1 "modified tag1" --> ok
FrameTagManager.SetScaleByID tag1 false --> ok
ntags = FrameTagManager.GetTagCount() --> 3
for i = 1 to ntags do
(
id = FrameTagManager.GetTagID i
tagTime = FrameTagManager.GetTimeByID id
tagLockID = FrameTagManager.GetLockIDByID id
tagName = FrameTagManager.GetNameByID id
tagScale = FrameTagManager.GetScaleByID id
format "%: id:%; name:%; time:%; lockID:%; scale:%\n" i id tagName tagTime tagLockID tagScale
)
FrameTagManager.SetTimeByID tag2 5 relative:true --> ok
ntags = FrameTagManager.GetTagCount() --> 3
for i = 1 to ntags do
(
id = FrameTagManager.GetTagID i
tagTime = FrameTagManager.GetTimeByID id
tagLockID = FrameTagManager.GetLockIDByID id
tagName = FrameTagManager.GetNameByID id
tagScale = FrameTagManager.GetScaleByID id
format "%: id:%; name:%; time:%; lockID:%; scale:%\n" i id tagName tagTime tagLockID tagScale
)
FrameTagManager.DeleteTag tag2 --> ok
FrameTagManager.FindItem tag2 --> 0
FrameTagManager.FindItem tag3 --> 2
ntags = FrameTagManager.GetTagCount() --> 2
for i = 1 to ntags do
(
id = FrameTagManager.GetTagID i
tagTime = FrameTagManager.GetTimeByID id
tagLockID = FrameTagManager.GetLockIDByID id
tagName = FrameTagManager.GetNameByID id
tagScale = FrameTagManager.GetScaleByID id
format "%: id:%; name:%; time:%; lockID:%; scale:%\n" i id tagName tagTime tagLockID tagScale
)
FrameTagManager.SetLockIDByID tag1 tag3 --> true
FrameTagManager.GetTimeByID tag1 --> 10f
FrameTagManager.SetLockIDByID tag3 tag1 --> false
FrameTagManager.GetTimeByID tag3 --> 20f
FrameTagManager.CheckForLoop tag1 tag3 --> true
FrameTagManager.CheckForLoop tag3 tag1 --> false
FrameTagManager.SetLockIDByID tag1 0 --> true
FrameTagManager.GetTimeByID tag1 --> 10f
FrameTagManager.FindItemByTime 10 --> 1
FrameTagManager.FindItemByTime 15 --> 0
FrameTagManager.FindItemByTime 20 --> 2