mbox series

[FFmpeg-devel,0/2] Print filter input/output formats in help output

Message ID pull.43.ffstaging.FFmpeg.1665494271.ffmpegagent@gmail.com
Headers show
Series Print filter input/output formats in help output | expand

Message

Aman Karmani Oct. 11, 2022, 1:17 p.m. UTC 
Example out put for command: ffmpeg -h filters=overlay

Filter overlay
  Overlay a video source on top of the input.
    slice threading supported
    Inputs:
       #0: main (video), Formats: Dynamic, Default: [yuv420p, yuvj420p, yuva420p, nv12, nv21]
       #1: overlay (video), Formats: Dynamic, Default: [yuva420p]
    Outputs:
       #0: default (video), Formats: Dynamic, Default: [yuv420p, yuvj420p, yuva420p, nv12, nv21]

overlay AVOptions:
    [...]



Examples for what it prints in various cases
============================================


For pass-through filter links
=============================

"All (passthrough)"



For filters using query_formats
===============================

"Dynamic"



For filters using query_formats where a call to query_formats succeeds
======================================================================

"Dynamic, Default: [yuv420p, yuvj420p, yuva420p, nv12, nv21]"



For all other cases
===================

"[s16p, s32p, fltp, dblp]"



Except in case when all formats are supported
=============================================

(when the number of formats equals the number of available formats)

"All"


softworkz (2):
  avfilter/avfilter: add avfilter_print_config_formats()
  ftools/opt_common: Print filter input/output formats in help output

 doc/APIchanges              |   3 ++
 fftools/opt_common.c        |  39 +++++++++-----
 libavfilter/avfilter.c      | 102 +++++++++++++++++++++++++++++++++++-
 libavfilter/avfilter.h      |  12 +++++
 libavfilter/avfiltergraph.c |  14 +++--
 libavfilter/internal.h      |   9 ++++
 libavfilter/version.h       |   4 +-
 7 files changed, 163 insertions(+), 20 deletions(-)


base-commit: e10e27a2ead8848648b29a1b397cc240206e9c3d
Published-As: https://github.com/ffstaging/FFmpeg/releases/tag/pr-ffstaging-43%2Fsoftworkz%2Fsubmit_print_formats-v1
Fetch-It-Via: git fetch https://github.com/ffstaging/FFmpeg pr-ffstaging-43/softworkz/submit_print_formats-v1
Pull-Request: https://github.com/ffstaging/FFmpeg/pull/43