These nodes are for playing movies (videos).

A movie file contains a sequence of frames. Each frame has an image and a time when it’s supposed to be displayed. You can play frames in sequence using the Play Movie node. You can grab individual frames using the Decode Movie Image node.

These nodes use FFmpeg and support any of its supported file formats. They don’t support the proprietary AAC audio format.

These nodes support both inter-frame and intra-frame codecs. When retrieving a frame from an inter-frame movie, these nodes output the frame as it would normally be shown (interpolated from keyframes, not as raw inter-frame data). Since this requires extra processing — especially when using Decode Movie Image, or Play Movie with mirrored looping or a negative playbackRate — you’ll often get better performance with an intra-frame codec (such as MJPEG, ProRes 422/4444, or DV).

These nodes support decoding the movie’s sound, too. Connect the decodedAudio port to a Send Live Audio node’s sendChannels port to hear the audio. (The decodedAudio port only fires events when the movie is playing forward at normal speed. When the playbackRate is not 1, or when the loop is “Mirror” and the movie is playing in reverse, the decodedAudio port does not fire events.)

Currently these nodes only support movieURLs which are absolute filesystem paths. (In a future release, you’ll be able to use relative paths and HTTP URLs.)

To load a movie from a file on the computer running the composition, use the file’s location on the computer. Example:

Example compositions: