Changes between Version 52 and Version 53 of FilteringGuide

Timestamp:

Nov 29, 2019, 10:15:28 AM (7 years ago)

Author:

slhck

Comment:

add first table for metadata keys

FilteringGuide

@@ -163 +163 @@
 There are other options for generating synthetic video input, see [http://stackoverflow.com/questions/11640458/how-can-i-generate-a-video-file-directly-from-an-ffmpeg-filter-with-no-actual-in here] and [http://stackoverflow.com/a/15795112/32453 here] ("generic equation" filter).
 
+=== Other Filter Examples ===
+
+* [[FancyFilteringExamples|Fancy Filtering Examples]] – Examples for various psychedelic effects and other weird filtering.
+*  [[Null]] describes the nullsink filter.
+
+== Filter Metadata ==
+
+Filters may write metadata entries that can be used for debugging their functionality, or extracting additional information from the input file. For a general description, see [http://ffmpeg.org/ffmpeg-filters.html#metadata_002c-ametadata the metadata filter documentation].
+
+Metadata keys are defined by the respective filters, and there is no globally accessible list. Some of them are mentioned in the filter documentation itself.
+
+Here are some important metadata keys, all starting with `lavfi.<filter>`, where `<filter>` is the name of the filter itself.
+
+||= '''Filter''' =||= '''Key''' =||= '''Description''' =||
+|| `aphasemeter` || `phase` || ||
+|| `astats` || `Bit_depth2` || ||
+|| `astats` || `Bit_depth` || ||
+|| `astats` || `Crest_factor` || ||
+|| `astats` || `DC_offset` || ||
+|| `astats` || `Dynamic_range` || ||
+|| `astats` || `Flat_factor` || ||
+|| `astats` || `Max_difference` || ||
+|| `astats` || `Max_level` || ||
+|| `astats` || `Mean_difference` || ||
+|| `astats` || `Min_difference` || ||
+|| `astats` || `Min_level` || ||
+|| `astats` || `Overall.Bit_depth2` || ||
+|| `astats` || `Overall.Bit_depth` || ||
+|| `astats` || `Overall.DC_offset` || ||
+|| `astats` || `Overall.Flat_factor` || ||
+|| `astats` || `Overall.Max_difference` || ||
+|| `astats` || `Overall.Max_level` || ||
+|| `astats` || `Overall.Mean_difference` || ||
+|| `astats` || `Overall.Min_difference` || ||
+|| `astats` || `Overall.Min_level` || ||
+|| `astats` || `Overall.Number_of_samples` || ||
+|| `astats` || `Overall.Peak_count` || ||
+|| `astats` || `Overall.Peak_level` || ||
+|| `astats` || `Overall.RMS_difference` || ||
+|| `astats` || `Overall.RMS_level` || ||
+|| `astats` || `Overall.RMS_peak` || ||
+|| `astats` || `Overall.RMS_trough` || ||
+|| `astats` || `Peak_count` || ||
+|| `astats` || `Peak_level` || ||
+|| `astats` || `RMS_difference` || ||
+|| `astats` || `RMS_level` || ||
+|| `astats` || `RMS_peak` || ||
+|| `astats` || `RMS_trough` || ||
+|| `astats` || `Zero_crossings_rate` || ||
+|| `astats` || `Zero_crossings` || ||
+|| `bbox`   || `h` || ||
+|| `bbox`   || `w` || ||
+|| `bbox`   || `x1` || ||
+|| `bbox`   || `x2` || ||
+|| `bbox`   || `y1` || ||
+|| `bbox`   || `y2` || ||
+|| `blackframe` || `pblack` || ||
+|| `cropdetect` || `h` || ||
+|| `cropdetect` || `w` || ||
+|| `cropdetect` || `x1` || ||
+|| `cropdetect` || `x2` || ||
+|| `cropdetect` || `x` || ||
+|| `cropdetect` || `y1` || ||
+|| `cropdetect` || `y2` || ||
+|| `cropdetect` || `y` || ||
+|| `ebur128` || `r128.I` ||  ||
+|| `ebur128` || `r128.LRA.high` ||  ||
+|| `ebur128` || `r128.LRA.low` ||  ||
+|| `ebur128` || `r128.LRA` ||  ||
+|| `ebur128` || `r128.M` ||  ||
+|| `ebur128` || `r128.S` ||  ||
+|| `freezedetect` || `freeze_duration` || Duration of the freeze period ||
+|| `freezedetect` || `freeze_end` || End of the freeze period ||
+|| `freezedetect` || `freeze_start` || Start of the freeze period ||
+|| `psnr` || `mse.u` || ||
+|| `psnr` || `mse.v` || ||
+|| `psnr` || `mse.y` || ||
+|| `psnr` || `mse_avg` || ||
+|| `psnr` || `psnr.u` || ||
+|| `psnr` || `psnr.v` || ||
+|| `psnr` || `psnr.y` || ||
+|| `psnr` || `psnr_avg` || ||
+|| `signalstats` || `HUEAVG` || ||
+|| `signalstats` || `HUEMED` || ||
+|| `signalstats` || `key` || ||
+|| `signalstats` || `SATAVG` || ||
+|| `signalstats` || `SATHIGH` || ||
+|| `signalstats` || `SATLOW` || ||
+|| `signalstats` || `SATMAX` || ||
+|| `signalstats` || `SATMIN` || ||
+|| `signalstats` || `UAVG` || ||
+|| `signalstats` || `UBITDEPTH` || ||
+|| `signalstats` || `UDIF` || ||
+|| `signalstats` || `UHIGH` || ||
+|| `signalstats` || `ULOW` || ||
+|| `signalstats` || `UMAX` || ||
+|| `signalstats` || `UMIN` || ||
+|| `signalstats` || `VAVG` || ||
+|| `signalstats` || `VBITDEPTH` || ||
+|| `signalstats` || `VDIF` || ||
+|| `signalstats` || `VHIGH` || ||
+|| `signalstats` || `VLOW` || ||
+|| `signalstats` || `VMAX` || ||
+|| `signalstats` || `VMIN` || ||
+|| `signalstats` || `YAVG` || ||
+|| `signalstats` || `YBITDEPTH` || ||
+|| `signalstats` || `YDIF` || ||
+|| `signalstats` || `YHIGH` || ||
+|| `signalstats` || `YLOW` || ||
+|| `signalstats` || `YMAX` || ||
+|| `signalstats` || `YMIN` || ||
+|| `silencedetect` || `silence_duration` || Duration of the silence period ||
+|| `silencedetect` || `silence_end` || End of the silence period ||
+|| `silencedetect` || `silence_start` || Start of the silence period ||
+|| `ssim` || `All` || ||
+|| `ssim` || `dB` || ||
+|| `ssim` || `u` || ||
+|| `ssim` || `v` || ||
+|| `ssim` || `y` || ||
+
 == Scripting Filters ==
 
@@ -217 +337 @@
 The array in the `$command_line` variable helps avoid loss of the quotes which occurs otherwise. Other shells may behave differently.
 
-== Other Filter Examples ==
-
-* [[FancyFilteringExamples|Fancy Filtering Examples]] – Examples for various psychedelic effects and other weird filtering.
-*  [[Null]] describes the nullsink filter.
-
 == Developing your own Filters ==