Media file input/ Movie/Audio file input

Movie/Audio file input supports playback of video clips, looping playback, and more.

• Media source - Use the Load button to load a clip into Composer. If a clip has been loaded but the file has been modified, you can use the Reload button to refresh the clip in Composer. Use the Clear button to unload the clip.
  Note! Only movie clips can be loaded–no image files. Supported media format and codecs.

• Playback state - Current playback state

• Commands

  • Play button - Start playback

  • Pause button - Pause playback

  • Stop button - Stop playback

• Configuration

  • End of file behaviour - Determines the action to perform at the end of the file. The options are Loop/repeat playback, Hold the last frame and Stop.

  • Synchronize playback  - All Movie inputs that have this checkbox actived will start their playback in sync.

  • Start playing when loaded - Check this option to automatically start playback when the file is loaded (Default).

  • Video decoder thread count - Number of CPU threads used for decoding. 

  • Prefer hardware decoding - If enabled, the GPU will try to do the decoding of the video file. (To enable this feature, the video file must be stopped first)

  • Hardware decoding active - If “Yes”, the GPU will do the decoding (also called nvdec) of the video file instead of the CPU. The video file must have a resolution of a minimum of 48x48px. 

  • Cue points JSON - By adding a JSON array, it is possible to call a connector on a specific frame. This will trigger one or more events.
    In the example below, after 100 frames are played, it will trigger a connector called "TOP". After 200 frames, it will trigger the connector "FRONT".
    Example: [ { "100": "TOP" }, { "200": "FRONT" }]

• Performance and properties

  • Message - Info message

  • Avg video decoding time (ms) - average time (in ms) for decoding a video frame

  • Video buffer memory used (MB) - Memory used.

  • Parsed video buffer length (ms) - Length of video buffer in ms

  • Parsed audio buffer length (ms) - Length of audio buffer in ms

  • Video buffer length (ms) - number of video frames decoded (buffered) but not rendered. Buffered video might occur depending on how the video is encoded. For example, if the video encoding utilizes b-frames, there will be a longer video buffer than a video encoded without b-frames.

  • Audio buffer length (ms) - audio buffer length (in ms)

  • Current time - current playback time (Time code) in hours:minutes:seconds:frames.

  • Number of loops played - Counting the number of loops

  • VideoTrackInfo - detailed debug information on video track properties

  • AudioTrackInfo - detailed debug information on audio track properties

• About - Information about the input.

• Resolution

  • Width -  Video width (pixels)

  • Height - Video height (pixels)

HINT

To copy the current frame (video), right-click on the input title and select Copy image.

NOTE!

Minimum size of a videofile is 48×48px

Media format and codecs 

Video with audio:
The .mp4 container is preferred for movie files, with an h264/h265 (HEVC) video track and aac audio track. There are multiple compressors for encoding original content or transcoding existing content. Available settings will differ between compressors. The most important settings are: 

• .mp4 container with h264/h265 video and aac audio

• Bitrate depends on resolution, but reasonable bitrates are generally between 3 and 15 mbit/s

• Keyframe (I-frame) distance set to double the move framerate

• AAC 48 kHz stereo, Bitrate 128 kbps or above

• If there are options for pooling or interleaving audio, interleaving should always be chosen

Video/audio with alpha channel:
It is possible to use a video containing an alpha channel. Save the video file as a .mov file with the video codec "Quicktime Animation", in colorspace RGBA (with alpha channel).

Handbrake

An excellent utility for transcoding media files is Handbrake. It is free and works for Windows, Mac, and Linux. These are the recommended key settings in Handbrake:

By default, Handbrake will use the suffix .m4v when saving a file, rename the suffix to .mp4 to make Composer recognize the file.