diff --git a/doc/filters.texi b/doc/filters.texi index 274532dcfb..2aebd8eb5c 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -10076,6 +10076,73 @@ Scale a subtitle stream to match the main video in size before overlaying @end example @end itemize +@section selectivecolor + +Adjust cyan, magenta, yellow and black (CMYK) to certain ranges of colors (such +as "reds", "yellows", "greens", "cyans", ...). The adjustment range is defined +by the "purity" of the color (that is, how saturated it already is). + +This filter is similar to the Adobe Photoshop Selective Color tool. + +The filter accepts the following options: + +@table @option +@item correction_method +Select color correction method. + +Available values are: +@table @samp +@item absolute +Specified adjustments are applied "as-is" (added/subtracted to original pixel +component value). +@item relative +Specified adjustments are relative to the original component value. +@end table +Default is @code{absolute}. +@item reds +Adjustments for red pixels (pixels where the red component is the maximum) +@item yellows +Adjustments for yellow pixels (pixels where the blue component is the minimum) +@item greens +Adjustments for green pixels (pixels where the green component is the maximum) +@item cyans +Adjustments for cyan pixels (pixels where the red component is the minimum) +@item blues +Adjustments for blue pixels (pixels where the blue component is the maximum) +@item magentas +Adjustments for magenta pixels (pixels where the green component is the minimum) +@item whites +Adjustments for white pixels (pixels where all components are greater than 128) +@item neutrals +Adjustments for all pixels except pure black and pure white +@item blacks +Adjustments for black pixels (pixels where all components are lesser than 128) +@item psfile +Specify a Photoshop selective color file (@code{.asv}) to import the settings from. +@end table + +All the adjustment settings (@option{reds}, @option{yellows}, ...) accept up to +4 space separated floating point adjustment values in the [-1,1] range, +respectively to adjust the amount of cyan, magenta, yellow and black for the +pixels of its range. + +@subsection Examples + +@itemize +@item +Increase cyan by 50% and reduce yellow by 33% in every green areas, and +increase magenta by 27% in blue areas: +@example +selectivecolor=greens=.5 0 -.33 0:blues=0 .27 +@end example + +@item +Use a Photoshop selective color preset: +@example +selectivecolor=psfile=MySelectiveColorPresets/Misty.asv +@end example +@end itemize + @section separatefields The @code{separatefields} takes a frame-based video input and splits @@ -13627,73 +13694,6 @@ ffmpeg -copyts -vsync 0 -segment_time_metadata 1 -i input.ffconcat -vf select=co @end example @end itemize -@section selectivecolor - -Adjust cyan, magenta, yellow and black (CMYK) to certain ranges of colors (such -as "reds", "yellows", "greens", "cyans", ...). The adjustment range is defined -by the "purity" of the color (that is, how saturated it already is). - -This filter is similar to the Adobe Photoshop Selective Color tool. - -The filter accepts the following options: - -@table @option -@item correction_method -Select color correction method. - -Available values are: -@table @samp -@item absolute -Specified adjustments are applied "as-is" (added/subtracted to original pixel -component value). -@item relative -Specified adjustments are relative to the original component value. -@end table -Default is @code{absolute}. -@item reds -Adjustments for red pixels (pixels where the red component is the maximum) -@item yellows -Adjustments for yellow pixels (pixels where the blue component is the minimum) -@item greens -Adjustments for green pixels (pixels where the green component is the maximum) -@item cyans -Adjustments for cyan pixels (pixels where the red component is the minimum) -@item blues -Adjustments for blue pixels (pixels where the blue component is the maximum) -@item magentas -Adjustments for magenta pixels (pixels where the green component is the minimum) -@item whites -Adjustments for white pixels (pixels where all components are greater than 128) -@item neutrals -Adjustments for all pixels except pure black and pure white -@item blacks -Adjustments for black pixels (pixels where all components are lesser than 128) -@item psfile -Specify a Photoshop selective color file (@code{.asv}) to import the settings from. -@end table - -All the adjustment settings (@option{reds}, @option{yellows}, ...) accept up to -4 space separated floating point adjustment values in the [-1,1] range, -respectively to adjust the amount of cyan, magenta, yellow and black for the -pixels of its range. - -@subsection Examples - -@itemize -@item -Increase cyan by 50% and reduce yellow by 33% in every green areas, and -increase magenta by 27% in blue areas: -@example -selectivecolor=greens=.5 0 -.33 0:blues=0 .27 -@end example - -@item -Use a Photoshop selective color preset: -@example -selectivecolor=psfile=MySelectiveColorPresets/Misty.asv -@end example -@end itemize - @section sendcmd, asendcmd Send commands to filters in the filtergraph.