GetTimecodeStringFromClip
GetTimecodeStringFromClip(srcClip, timeOffset, string)
Additional Notes
(sorry - don't know how to edit my previous note - then I add...)
GetTimecodeStringFromClip first adds the IN point position of the current clip to "timeOffset", and then output the result to "string".
The output "string" then contains the timecode (relative to the beginning of "srcClip") of the frame "timeOffset" relative to the IN Point.
In the previous example, if the IN point is in position "00:00:01:00", the output "string" will contain "00:00:02:02".
Note: this is visible only in the Canvas when srcClip is in the Timeline, not in the Viewer...


My tests in FCE HD make me believe this function only converts the input float "timeOffset" into an output string "string" formatted as a standard time code.
Example: on any clip I tested (3 PAL clips) with "timeOffset"=27 GetTimecodeStringFromClip returned "00:00:01:02" in "string", independent of: clip length, clip in point, playhead position, and clip initial time code (read with GetTimeCode). It seems that srcClip is used only to get the fps = 25 (PAL).