summaryrefslogtreecommitdiff
path: root/doc/filters.texi
diff options
context:
space:
mode:
authorNiklas Haas <git@haasn.dev>2022-04-11 13:26:07 +0200
committerNiklas Haas <git@haasn.dev>2022-04-23 21:51:55 +0200
commit2cb0cebd11eb90dfcccac5c258af1003bd4f17d2 (patch)
treec32eabb4f547368477d1d073f60b56598944fa39 /doc/filters.texi
parent5cfeaeef0c2e0970f64d3188375a525c17f4621b (diff)
lavfi: add vf_iccdetect for parsing ICC profiles
This filter is designed to parse embedded ICC profiles and attempt extracting colorspace tags from them, updating the AVFrame metadata accordingly. This is intentionally made a separate filter, rather than being part of libavcodec itself, so that it's an opt-in behavior for the time being. This also gives the user more flexibility to e.g. first attach an ICC profile and then also set the colorspace tags from it. This makes #9673 possible, though not automatic. Signed-off-by: Niklas Haas <git@haasn.dev>
Diffstat (limited to 'doc/filters.texi')
-rw-r--r--doc/filters.texi14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/filters.texi b/doc/filters.texi
index 67765a1ff9..495d59c924 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -14384,6 +14384,20 @@ By default value is 0.
The @code{hysteresis} filter also supports the @ref{framesync} options.
+@section iccdetect
+
+Detect the colorspace from an embedded ICC profile (if present), and update
+the frame's tags accordingly.
+
+This filter accepts the following options:
+
+@table @option
+@item force
+If true, the frame's existing colorspace tags will always be overridden by
+values detected from an ICC profile. Otherwise, they will only be assigned if
+they contain @code{unknown}. Enabled by default.
+@end table
+
@section iccgen
Generate ICC profiles and attach them to frames.