Lingo Dictionary > D-F > framesToHMS() |  |

framesToHMS()

Syntax

    framesToHMS(frames, tempo, dropFrame, fractionalSeconds)

Description

Function; converts the specified number of frames to their equivalent length in hours, minutes, and seconds. This function is useful for predicting the actual playtime of a movie or controlling a video playback device.

| `frames—`Integer expression that specifies the number of frames.
| `tempo—`Integer expression that specifies the tempo in frames per second.
| `dropFrame—`Compensates for the color NTSC frame rate, which is not exactly 30 frames per second and is meaningful only if FPS is set to 30 frames per second. Normally, this argument is set to `FALSE`.
| `fractionalSeconds`—Determines whether the residual frames are converted to the nearest hundredth of a second (`TRUE`) or returned as an integer number of frames (`FALSE`).

The resulting string uses the form `sHH:MM:SS.FFD`, where:

s | A character is used if the time is less than zero, or a space if the time is greater than or equal to zero.
HH | Hours.
MM | Minutes.
SS | Seconds.
FF | `Indicates a fraction of a second if` `fractionalSeconds` `is TRUE or frames if` `fractionalSeconds` `is FALSE.`
D | `A "d" is used if` `dropFrame` `is TRUE, or a space if` `dropFrame` `is FALSE.`

Example

This statement converts a 2710-frame, 30 frame-per-second movie. The `dropFrame` and `fractionalSeconds` arguments are both turned off:

    put framesToHMS(2710, 30, FALSE, FALSE)
    -- " 00:01:30.10 "

See also

`HMStoFrames()`