AVObjects Knowledge Base - New pages [en]

Pipe for ffmpeg: Settings

2025-10-23T12:08:12Z

Dkn:

Filter interface and command line preparation for [[Pipe for ffmpeg]] DirectShow filter. 
Interface IAVOPipeFFmpeg can be found in file <filter installation directory>\Idl\PipeFF.idl

===Command line===

The command line includes the following sections: 
'''<Path to ffmpeg.exe> <INPUT> [<Common options>] [<Coding[0]> ... <Coding[N]>] <Output file>''' 

where: 

'''- <Path to ffmpeg.exe>''' : The full name of the ffmpeg.exe module. Specified by the user. If IAVOPipeFFmpeg::PutExe(bsExe) is called with bsExe == NULL or *bsExe = 0, ffmpeg.exe will be searched in the .exe (application) or .dll (filter) folders. 

'''- <INPUT>''' : Input stream and pipe parameters. These are set by the filter based on the connection media types and predefined parameters. 

'''- <Common options>''': the following options can be specified in this section 
* Input stream modifications (resize, aspect ratio, frame rate, sample rate, etc.); 
* Trimming (start, end, duration, etc.); 
* Encoding options (encoders, bitrate, profile, etc.); 
* Additional parameters ("-y" for overwriting, "-loglevel", "-report", etc.); 
NOTE: ":stream_specifier" must be set according to ffmpeg docs (-c:v, -b:a:1, etc.). 
<Common options> section is optional, some parameters can be specified in the <Coding> sections. 

'''- <Coding[n]>''': encoding parameters for stream n (for the stream number, only connected pins are taken into account). Stream parameters can be retrieved using IAVOPipeFFmpeg::GetPinParams(nPin, ...). Features of this section: 

* The codec used can be specified in the first word of this part, the codec name starts with a letter, for example: mpeg2video, mpeg4, libx264, aac, ac3, ... The codec option and stream_specifier will be automatically added before the codec name, for example for video stream 0: "-c:v:0", for audio stream 5: "-c:a:5", etc. 
* Partial options are allowed: ":stream_specifier" can be omitted after the option name, it will be automatically added for known options (see [:stream_specifier] in ffmpeg docs). If ":stream_specifier" is found after the option name, it will be changed to the actual "stream_type:additional_stream_specifier" by filter. 
Examples of <Coding>:
Video stream 1: "mpeg4 -b 1150k -maxrate:v 1150k" converted to "-c:v:1 mpeg4 -b:v:1 1150k -maxrate:v:1 1150k"
Audio stream 2: "mp2 -b:a 224k" converted to "-c:a:2 mp2 -b:a:2 224k"
Audio stream 0: "-codec aac -b 128K" converted to "-c:a:0 aac -b:a:0 128K"
<Coding[n]> sections are optional, parameters can be specified in <Common options>. 

'''- <Output file>''' : the full name of the output file. The file type is determined by the extension, unless changed in the <Common options> section with the "-f" option. This part is mandatory.

===Use cases===
To create the ffmpeg command line, the IAVOPipeFFmpeg interface functions are used (see Idl\PipeFF.idl). There are two main methods for using these functions to create
a command line: 

'''1.''' For users unfamiliar with ffmpeg syntax and for quick usage: 
<Common options> is used for actual "common" properties: "-y", "-loglevel", "-report", etc. 
<Coding[N]> is used to select the encoder. You can also set the bitrate and other parameters. 

[[Image:PipeFF-coding.jpg|800px|Using <Coding> section.]] 

 
'''2.''' For advanced ffmpeg users 
You can put all ffmpeg options in <Common options> and leave <Coding[N]> empty. 
<Common options> line on picture: "-c:v mpeg4 -b:v 2000K -c:a:0 aac -b:a:0 128K -c:a:1 ac3 -b:a:1 192K -y" 

[[Image:PipeFF-common.jpg|800px|Using <Common options> section.]] 

A combination of these methods is also possible. 

If you have any questions, this information is not sufficient, or you have any additional requests, please contact us at [mailto:support@avobjects.com support@avobjects.com]

Pipe for ffmpeg: Release Notes

2025-09-25T08:25:20Z

Dkn:

{{This|release_notes/Pipe_for_ffmpeg:_Release_Notes}}


=== 1.0.2.1 - Oct 24, 2025 ===

* Fixed edit controls in drop-down combo boxes on the properties page.

=== 1.0.2.0 - Oct 23, 2025 ===

* Added the function of automatic selection of the ffmpeg.exe module to be used from the .exe (application) or .dll (filter) folders.
* Fixed bugs in grid control on the filter properties page.

=== 1.0.1.0 - Oct 22, 2025 ===

* Added support for v210 and r210 color spaces.
* Fixed a bug when capturing multiple video or audio streams.
* Corrected functions for parsing options and creating the ffmpeg command line.
* Fixed bugs in grid control on the filter properties page.
* Added a choice of options on the filter properties page.
* Corrected interface method for receiving messages from ffmpeg and filter.
* Corrected property page control to display latest and all messages from ffmpeg and filter.

=== 1.0.0.1 - Sep 25, 2025 ===

* First release.

[[Category:Release Notes]]
__NOTOC__

Pipe for ffmpeg

2025-09-25T07:30:08Z

Dkn:

{{This|products/special_filters/Pipe_for_ffmpeg.html}}

{{Pipe for ffmpeg: Description}}

==Overview==

Pipe for ffmpeg uses the ffmpeg.exe external module to encode video and audio streams and write them to files. The encoding and file types depend on the ffmpeg.exe used. You can download it from https://www.ffmpeg.org/download.html.

==Features==

The path to the external ffmpeg module to be used must be specified.

The following encoders and file types were tested:
* video: mpeg2video, mpeg4, libxvid, libx264, libx265
* audio: copy, aac, ac3, mp2, libmp3lame, libopus, flac
* files: mp4, mov, avi, mkv, mpg
Additional parameters (bitrate and other encoding characteristics) can also be specified, please see [[Pipe for ffmpeg: Settings]]

The tests used "FFmpeg 64-bit static Windows build from www.gyan.dev" (Version: 2024-10-24-git-153a6dc8fa-full_build-www.gyan.dev).

{{.idl}}

==Supported Formats==

* Input video streams are RGB or YUV, 8 or 10 bits, 4:2:0, 4:2:2 or 4:4:4 color spaces: - MEDIATYPE_Video, FORMAT_VideoInfo or FORMAT_VideoInfo2 - 8 bit color spaces: NV12, YV12, I420, YUY2, UYVY, YVYU, Y422, ARGB32, RGB32, RGB24 - 10 bit color spaces: v210, r210

* Input audio streams are PCM or IEEE_FLOAT: - MEDIASUBTYPE_PCM (8 -:- 32 bits, up to 32 channels) - MEDIASUBTYPE_IEEE_FLOAT (32 bits, up to 32 channels)

==Possible filter extensions==

* Adding output pins to further pass input streams (with removed timestamps) to renderers or other filters for monitoring.
* Adding the ability to start/stop capturing at any time while the graph is running. This can be used to capture specific fragments of input streams into one or more files.
If you are interested in these extensions or have any other additional requests, please contact us at [mailto:support@avobjects.com support@avobjects.com]

==See Also==

* [[Pipe for ffmpeg: Settings]]
* [[Pipe for ffmpeg: Release Notes]]

==You Might Also Need==

The PipeFFTest samples use the following filters:
* {{LinkDescription|Video Generator}}
* {{LinkDescription|Wave Generator}}

===Action Items===

* {{Pipe for ffmpeg: Download}}
* {{Contact Support}}
* {{Place Order!}}

{{Prices|950|1650|2400|000|000|000}}

[[Category:Special Filters]]
__NOTOC__