Houdini 18.0 Nodes TOP nodes

FFmpeg Encode Video TOP node

Encodes a sequence of still images as a video file.

On this page

The opposite operation (extract frame images from a video) is in the FFmpeg extract images node.

Installation

This node is a wrapper around the ffmpeg command line tool. You must have FFmpeg installed on each machine for this node to work.

For the node to find the FFmpeg command line tool, the path to the tool’s executable binary must be available via one of the following methods:

  • The system path

  • Specified in an environment variable named PDG_FFMPEG

  • Specified directly in the node by the FFmpeg Binary Path parameter

TOP Attributes

fps

integer

The frames per second of the output video.

Parameters

Node

Tool Presets

This menu provides a set of pre-defined FFmpeg operations. Choosing one of the presets will automatially configure the parameters and FFmpeg command.

Create Video From Images

This option allows a video to be created from a set of input images.

Convert File Format

Use this option when you want to perform a simple conversion of an audio or video file.

Convert Audio or Video File

Use this option for more complex conversion operations (for example, if you want to change the format of a video file and also change its resolution).

Input

Input Source

Selects the input source.

Upstream Output Images

The output files from the upstream work item with the tag specified by the File Tag parameter will be used as the input images.

Upstream Output File

The first output file from the upstream work item with the tag specified by the File Tag parameter will be used as the input.

Custom File Path

The file path specified by the File Path parameter will be used as the input.

File Tag

Specifies the file tag of the input source.

File Path

Specifies the file path to the input source.

Frame List File

The file path to the frame list file. The frame list file is a text file that contains an ordered list of all of the input images to FFmpeg that are used to construct the video.

It is a requirement of FFmpeg that the paths of the images in this file are specified as relative paths. Therefore, when running on Windows, the frame list file must be placed on the same drive as the input images.

Output

Output File Path

The file path of the outputted video.

File Tag

The file tag of the outputted video.

Options

Frames Per Second

Specifies the frames per second of the encoded video file.

Format

When enabled, specifies the value of the FFmpeg -f argument.

Size

When enabled, specifies the value of the FFmpeg -s argument.

-apply_trc

When enabled, specifies the value of the FFmpeg -apply_trc argument.

Video Codec

When enabled, specifies the value of the FFmpeg -c:v argument.

-movflags

When enabled, specifies the value of the FFmpeg -movflags argument.

Pixel Format

When enabled, specifies the pixel format.

FFmpeg

FFmpeg Binary

Specifies how FFmpeg will be called.

System Path

Use this option when FFmpeg is available from the system path.

$PDG_FFMPEG

When this option is selected, FFmpeg will be called by using the path stored in an environment variable with the name of PDG_FFMPEG. This environment variable must be created by the user.

Custom Path

The value of the FFmpeg Binary Path parameter will be used as the path to the FFmpeg binary.

FFmpeg Binary Path

Specifies the path to FFmpeg when FFmpeg Binary is set to Custom Path.

FFmpeg Command

Shows the FFmpeg command that will be called when the work item cooks. When this field is enabled, the command can be modified but it will not be updated when changing the other parameters.

Processor

Work Item Generation

Whether this node generates static or dynamic work items. You should generally leave this set to "Automatic" unless you know the node’s work items can be computed statically, or that they need to be generated dynamically.

Dynamic

This node always creates dynamic work items: it waits until the upstream work items are known, and generates new work items from the upstream work items.

Static

This node always creates static work items: it creates the number of work items it thinks it needs based on the parameters (and any upstream static items) before the network runs.

Automatic

If the input is static (a static processor, or a partitioner with only static inputs, or a mapper), this node generates static work items, otherwise it generates dynamic work items.

Cache Mode

How the processor node handles work items that report expected file results.

Automatic

If the expected result file exists on disk, the work item is marked as cooked without being scheduled. If the file does not exist, the item is scheduled as normal.

Read Files

If the expected result file exists on disk, the work item is marked as cooked without being scheduled. Otherwise the work item is marked as failed.

Write Files

Work items are always scheduled and the excepted result file is ignored, even if it exists on disk.

Schedulers

TOP Scheduler Override

This parameter overrides the TOP scheduler for this node.

Work Item Priority

This parameter determines how the current scheduler prioritizes the work items in this node.

Inherit From Upstream Item

The work items inherit their priority from their parent items. If a work item has no parent, its priority is set to 0.

Custom Expression

The work item priority is set to the value of Priority Expression.

Node Defines Priority

The work item priority is set based on the node’s own internal priority calculations.

This option is only available on the Python Processor TOP, ROP Fetch TOP, and ROP Output TOP nodes. These nodes define their own prioritization schemes that are implemented in their node logic.

Priority Expression

This parameter is only available when Work Item Priority is set to Custom Expression.

This parameter specifies an expression for work item priority. The expression is evaluated for each work item in the node.

Examples

example_top_ffmpegencodevideo Example for FFmpeg Encode Video TOP node

This example demonstrates how to use FFmpeg Encode Video node to encode a sequence of images into a video file.

See also

TOP nodes