diff options
author | Gyan Doshi <ffmpeg@gyani.pro> | 2021-11-15 14:46:56 +0300 |
---|---|---|
committer | Gyan Doshi <ffmpeg@gyani.pro> | 2021-11-15 14:46:56 +0300 |
commit | 9e8cdb24cd2001959b37b08254d4c0cbc5668717 (patch) | |
tree | 264ba98dc75e5ba88503ec37f46eb98573075175 /doc | |
parent | 23a1f11d02a29b788d441e1b0846a28c0f479df9 (diff) |
doc/filters: add details and ranges for colorkey
Diffstat (limited to 'doc')
-rw-r--r-- | doc/filters.texi | 26 |
1 files changed, 16 insertions, 10 deletions
diff --git a/doc/filters.texi b/doc/filters.texi index 1fced203b6..3aa54e6c69 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -8496,25 +8496,31 @@ This filter supports the all above options as @ref{commands}. @section colorkey RGB colorspace color keying. +This filter operates on 8-bit RGB format frames by setting the alpha component of each pixel +which falls within the similarity radius of the key color to 0. The alpha value for pixels outside +the similarity radius depends on the value of the blend option. The filter accepts the following options: @table @option @item color -The color which will be replaced with transparency. +Set the color for which alpha will be set to 0 (full transparency). +See @ref{color syntax,,"Color" section in the ffmpeg-utils manual,ffmpeg-utils}. +Default is @code{black}. @item similarity -Similarity percentage with the key color. - -0.01 matches only the exact key color, while 1.0 matches everything. +Set the radius from the key color within which other colors also have full transparency. +The computed distance is related to the unit fractional distance in 3D space between the RGB values +of the key color and the pixel's color. Range is 0.01 to 1.0. 0.01 matches within a very small radius +around the exact key color, while 1.0 matches everything. +Default is @code{0.01}. @item blend -Blend percentage. - -0.0 makes pixels either fully transparent, or not transparent at all. - -Higher values result in semi-transparent pixels, with a higher transparency -the more similar the pixels color is to the key color. +Set how the alpha value for pixels that fall outside the similarity radius is computed. +0.0 makes pixels either fully transparent or fully opaque. +Higher values result in semi-transparent pixels, with greater transparency +the more similar the pixel color is to the key color. +Range is 0.0 to 1.0. Default is @code{0.0}. @end table @subsection Examples |