2 Copyright (C) 2012-2021 Carl Hetherington <cth@carlh.net>
4 This file is part of DCP-o-matic.
6 DCP-o-matic is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 DCP-o-matic is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with DCP-o-matic. If not, see <http://www.gnu.org/licenses/>.
22 /** @file src/filter.cc
23 * @brief A class to describe one of FFmpeg's video or audio filters.
27 #include "dcpomatic_assert.h"
29 #include <dcp/warnings.h>
30 LIBDCP_DISABLE_WARNINGS
32 #include <libavfilter/avfilter.h>
34 LIBDCP_ENABLE_WARNINGS
41 using boost::optional;
44 vector<Filter> Filter::_filters;
48 * @param name User-visible name.
49 * @param category User-visible category.
50 * @param ffmpeg_string String for a FFmpeg filter descriptor.
52 Filter::Filter(string id, string name, string category, string ffmpeg_string)
56 , _ffmpeg(ffmpeg_string)
62 /** @return All available filters */
70 /** Set up the static _filters vector; must be called before from_*
74 Filter::setup_filters ()
76 /* Note: "none" is a magic id name, so don't use it here */
78 auto maybe_add = [](string id, string name, string category, string ffmpeg)
80 string check_name = ffmpeg;
81 size_t end = check_name.find("=");
82 if (end != string::npos) {
83 check_name = check_name.substr(0, end);
86 if (avfilter_get_by_name(check_name.c_str())) {
87 _filters.push_back(Filter(id, name, category, ffmpeg));
91 maybe_add (N_("vflip"), _("Vertical flip"), _("Orientation"), N_("vflip"));
92 maybe_add (N_("hflip"), _("Horizontal flip"), _("Orientation"), N_("hflip"));
93 maybe_add (N_("90clock"), _("Rotate 90 degrees clockwise"), _("Orientation"), N_("transpose=dir=clock"));
94 maybe_add (N_("90anticlock"), _("Rotate 90 degrees anti-clockwise"), _("Orientation"), N_("transpose=dir=cclock"));
95 maybe_add (N_("mcdeint"), _("Motion compensating deinterlacer"), _("De-interlacing"), N_("mcdeint"));
96 maybe_add (N_("kerndeint"), _("Kernel deinterlacer"), _("De-interlacing"), N_("kerndeint"));
97 maybe_add (N_("yadif"), _("Yet Another Deinterlacing Filter"), _("De-interlacing"), N_("yadif"));
98 maybe_add (N_("bwdif"), _("Bob Weaver Deinterlacing Filter"), _("De-interlacing"), N_("bwdif"));
99 maybe_add (N_("weave"), _("Weave filter"), _("De-interlacing"), N_("weave"));
100 maybe_add (N_("gradfun"), _("Gradient debander"), _("Misc"), N_("gradfun"));
101 maybe_add (N_("unsharp"), _("Unsharp mask and Gaussian blur"), _("Misc"), N_("unsharp"));
102 maybe_add (N_("denoise3d"), _("3D denoiser"), _("Noise reduction"), N_("denoise3d"));
103 maybe_add (N_("hqdn3d"), _("High quality 3D denoiser"), _("Noise reduction"), N_("hqdn3d"));
104 maybe_add (N_("telecine"), _("Telecine filter"), _("Misc"), N_("telecine"));
105 maybe_add (N_("ow"), _("Overcomplete wavelet denoiser"), _("Noise reduction"), N_("mp=ow"));
106 maybe_add (N_("premultiply"), _("Premultiply alpha channel"), _("Misc"), N_("premultiply=inplace=1"));
110 /** @param filters Set of filters.
111 * @return String to pass to FFmpeg for the video filters.
114 Filter::ffmpeg_string(vector<Filter> const& filters)
118 for (auto const& i: filters) {
130 * @return Corresponding Filter, if found.
133 Filter::from_id(string id)
135 auto iter = std::find_if(_filters.begin(), _filters.end(), [id](Filter const& filter) { return filter.id() == id; });
136 if (iter == _filters.end()) {
144 operator==(Filter const& a, Filter const& b)
146 return a.id() == b.id() && a.name() == b.name() && a.category() == b.category() && a.ffmpeg() == b.ffmpeg();
151 operator!=(Filter const& a, Filter const& b)
153 return a.id() != b.id() || a.name() != b.name() || a.category() != b.category() || a.ffmpeg() != b.ffmpeg();
158 operator<(Filter const& a, Filter const& b)
160 if (a.id() != b.id()) {
161 return a.id() < b.id();
164 if (a.name() != b.name()) {
165 return a.name() < b.name();
168 if (a.category() != b.category()) {
169 return a.category() < b.category();
172 return a.ffmpeg() < b.ffmpeg();