The FXScript Reference

For Final Cut Pro created by Joe Maller

frame

frame

Frame returns a number corresponding to the current frame of a clip. This value has nothing to do with a clip's original timecode and is specifically derived from the total number of frames in this particular instance of a clip. If the source is interlaced and the filter does not contain a FullFrame definition flag, the frame value on external video monitors will be double that visible in Final Cut Pro's viewer.

FXScript counts the first frame as zero, so the last frame is always one less than the amount reported by duration.

Related Links:
ChannelFill

Additional Notes

This article contradicts the "duration" article

The "frame" article says, "FXScript counts the first frame as zero, so the last frame is always one less than the amount reported by duration."

The "duration" article says, "Frames are counted using whole numbers starting with 1, so duration will always return a number 1 greater than frame reports as the last frame of a clip."

I think the counting must start at zero (as stated in the "frame" article) and not 1 (as stated in the "duration" article).

Rob:-]