FFmpeg Encode Video TOP node

Encodes a sequence of still images as a video file.

On this page

Installation
Top_attributes
Parameters
Examples

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.

You can specify an explicit path to the executable using the node’s
If the FFmpeg path parameter is blank, the node looks for the environment variable PDG_FFMPEG, which if defined should contain a path to the executable.
If the PDG_FFMPEG variable is not defined, the node will assume the executable is in the system path.

TOP Attributes

`operation`	string	Indicates the ffmpeg operation (`"encode"`).
`overridebin`	integer	Whether the user specified a custom `ffmpeg` executable path. If this is `1`, the work script should use the executable path in the `ffmpegbin` attribute.
`ffmpegbin`	string	The path to the `ffmpeg` executable, if `overridebin` is `1`.
`fps`	integer	The playback speed of the output video in frames per second.
`framelistfile`	string	The file path of the text file that contains the list of input frame images.
`outputfilename`	string	The file path of the output video file.
`customcommand`	integer	When this is `1`, the work script will run the custom command line in `expr`.
`expr`	string	A custom command line to run, when `customcommand` is `1`.
`outputtag`	string	The file tag to put on the result file path.
`inputimages`	string	List of file paths to the frame images.

Parameters

Node

Frames Per Second

The playback speed of the output video.

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 Filename

The file path to write the output video to.

Output File Tag

The file tag to put on the output file path. The default is file/video.

FFmpeg Command

Turn this on to customize the command line passed to ffmpeg.

FFmpeg Path

Turn this on to set an explicit path to the ffmpeg executable. If this is off, the node will look for a PDG_FFMPEG environment variable. If the variable is not set, the node will simply assume the executable is on the system path.

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.

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

FFmpeg Extract Images

TOP nodes

Attribute Copy

Copies attributes from work items in one branch onto work items in another branch.
Attribute Create

Creates or sets an attribute on all incoming work items.
Attribute Delete

Removes attributes from work items.
Attribute from String

Parses attribute values from a string, such as a file name.
Block Begin Feedback

Starts a feedback loop. TOP nodes within the block execute serially, optionally looping for each incoming work item.
Block End Feedback

Ends a feedback loop. TOP nodes within the block execute serially, optionally looping for each incoming work item.
CSV Input

Copies data from a CSV file into work item attributes.
CSV Output

Writes work item attributes to a CSV file.
Command Send

Sends code to a shared server to execute
Command Server End

Ends a command server block.
Deadline Scheduler

PDG Scheduler for Thinkbox’s Deadline software.
Download File

Downloads the contents of one or more URLs into files.
Environment Edit

Edits the variables set in the environment work item command lines execute in.
Error

Create warnings or errors when a condition is met
Error Handler

Error handler for failed work items.
FFmpeg Encode Video

Encodes a sequence of still images as a video file.
FFmpeg Extract Images

Extracts a sequence of still images from a video file.
File Compress

Compress files into an archive.
File Copy

Copies a file from one location to another, either at runtime or whenever the node generates.
File Decompress

Decompresses archive files specified by incoming work items into individual files.
File Pattern

Creates work items based on files that match a certain pattern.
File Remove

Deletes a file at a specified path.
File Rename

Renames or moves a file.
Filter by Expression

Conditionally filter upstream work items
Filter by Range

Filter upstream work items that fall within a specified frame or attribute range
Generic Generator

Generates work items with no attributes that run a command line.
Geometry Import

Load points or primitives from SOP or file geometry into work item attributes or a temporary file.
HDA Processor

Creates work items that cook a digital asset
HQueue Scheduler

Schedules work items using HQueue.
Houdini Server Begin

Starts a persistent Houdini command server
ImageMagick

Provides easy access to ImageMagick functionality such as mass image convert, resize, and image mosaics.
Invoke

Invokes a compiled block on input geometry
Json Input

Extracts data from JSON files and creates attributes
Json Output

Performs various operations that produce JSON output
Local Scheduler

Schedules work items on the local machine.
Make Directory
Map All

Maps all upstream work items to downstream work items.
Map by Expression

Maps upstream work items to downstream work items using an expression
Map by Index

Maps upstream work items to downstream work items based on their index.
Map by Range

Map upstream work items to downstream work items using range values
Maya Server Begin

Starts a persistent Maya command server
Merge

Merge all upstream work items
Null

Does nothing
OP Notify

Notify an OP node that some TOP work has completed
Output

Subnet output
Partition by Attribute

Partitions work items based on their attributes
Partition by Bounds

Partitions source items spatially using the bounding items.
Partition by Combination

Partitions work items into pairs, triples, etc
Partition by Comparison

Partitions work items using existing comparisons
Partition by Expression

Partitions work items based on an expression
Partition by Frame

Partitions work items based on their frame
Partition by Index

Partitions work items based on their index
Partition by Node

Partitions work items based on their node
Partition by Range

Partition work items based on range values
Partition by Tile

Partitions work items spatially using axis-aligned bounding boxes.
Perforce

Execute Perforce commands through PDG
Python Mapper

Maps work items using a Python script
Python Partitioner

Partitions work items using a Python script
Python Processor

Generate work items using a Python script
Python Scheduler

A Python-based programmable Scheduler for PDG.
Python Script

Creates work items that run a script
Python Server Begin

Starts a python command server.
ROP Alembic Output

Creates work items that cook an embedded Alembic ROP node
ROP Composite Output

Creates work items that cook an embedded Composite ROP node
ROP Fetch

Creates work items that cook a ROP node or network
ROP Geometry Output

Creates work items that cook an embedded Geometry ROP node
ROP Mantra Render

Creates work items that cook an embedded Mantra ROP node
ROP USD Output

Creates work items that cook an embedded USD ROP node
Render IFD

Creates work items that render an IFD file with Mantra
SQL Input
SQL Output
Send Email

Sends an email
Shotgun Create

Creates shotgun entities
Shotgun Delete

Deletes entities from shotgun
Shotgun Download

Downloads shotgun attachments
Shotgun Find

Finds shotgun entities
Shotgun Server Begin

Starts a persistent Shotgun command server
Shotgun Update

Updates shotgun entities
Shotgun Upload

Uploads files to shotgun
Sort

Sorts work items by a list of attributes
Split

Splits upstream items in two
Subnetwork

Container for TOP nodes
Switch

Switch which between network branches
TOP Fetch

Cooks another TOP network
TOP Fetch Input

Input to a TOP fetch-ed network
Text Output

Writes text to a new file or appends to an existing file.
Tractor Scheduler

Schedules work items using Pixar’s Tractor.
USD Import Files

Creates work items from file references found in a USD stage.
USD Import Prims

Creates work items from prims found in a USD stage.
USD Render

Creates work items that render a USD file.
Wait for All

Waits for all upstream work items to complete.
Wedge

Creates work items with varying attribute values.
Work Item Expand

Expands file lists or partitions into multiple work items
Xml Input

Extracts data from XML into Work Item attributes