2 * This file is part of FFmpeg.
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 ** Hardware accelerated common filters based on Intel Quick Sync Video VPP
26 #include "libavutil/opt.h"
27 #include "libavutil/eval.h"
28 #include "libavutil/avassert.h"
29 #include "libavutil/pixdesc.h"
34 #include "libavcodec/avcodec.h"
35 #include "libavformat/avformat.h"
39 #define OFFSET(x) offsetof(VPPContext, x)
40 #define FLAGS (AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_FILTERING_PARAM)
42 /* number of video enhancement filters */
43 #define ENH_FILTERS_COUNT (5)
45 typedef struct VPPContext{
50 /* Video Enhancement Algorithms */
51 mfxExtVPPDeinterlacing deinterlace_conf;
52 mfxExtVPPFrameRateConversion frc_conf;
53 mfxExtVPPDenoise denoise_conf;
54 mfxExtVPPDetail detail_conf;
55 mfxExtVPPProcAmp procamp_conf;
60 AVRational framerate; /* target framerate */
61 int use_frc; /* use framerate conversion */
62 int deinterlace; /* deinterlace mode : 0=off, 1=bob, 2=advanced */
63 int denoise; /* Enable Denoise algorithm. Value [0, 100] */
64 int detail; /* Enable Detail Enhancement algorithm. */
65 /* Level is the optional, value [0, 100] */
66 int use_crop; /* 1 = use crop; 0=none */
72 /* param for the procamp */
73 int procamp; /* enable procamp */
79 char *cx, *cy, *cw, *ch;
83 static const AVOption options[] = {
84 { "deinterlace", "deinterlace mode: 0=off, 1=bob, 2=advanced", OFFSET(deinterlace), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, MFX_DEINTERLACING_ADVANCED, .flags = FLAGS, "deinterlace" },
85 { "bob", "Bob deinterlace mode.", 0, AV_OPT_TYPE_CONST, { .i64 = MFX_DEINTERLACING_BOB }, .flags = FLAGS, "deinterlace" },
86 { "advanced", "Advanced deinterlace mode. ", 0, AV_OPT_TYPE_CONST, { .i64 = MFX_DEINTERLACING_ADVANCED }, .flags = FLAGS, "deinterlace" },
88 { "denoise", "denoise level [0, 100]", OFFSET(denoise), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 100, .flags = FLAGS },
89 { "detail", "enhancement level [0, 100]", OFFSET(detail), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 100, .flags = FLAGS },
90 { "framerate", "output framerate", OFFSET(framerate), AV_OPT_TYPE_RATIONAL, { .dbl = 0.0 },0, DBL_MAX, .flags = FLAGS },
91 { "procamp", "Enable ProcAmp", OFFSET(procamp), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, .flags = FLAGS},
92 { "hue", "ProcAmp hue", OFFSET(hue), AV_OPT_TYPE_FLOAT, { .dbl = 0.0 }, -180.0, 180.0, .flags = FLAGS},
93 { "saturation", "ProcAmp saturation", OFFSET(saturation), AV_OPT_TYPE_FLOAT, { .dbl = 1.0 }, 0.0, 10.0, .flags = FLAGS},
94 { "contrast", "ProcAmp contrast", OFFSET(contrast), AV_OPT_TYPE_FLOAT, { .dbl = 1.0 }, 0.0, 10.0, .flags = FLAGS},
95 { "brightness", "ProcAmp brightness", OFFSET(brightness), AV_OPT_TYPE_FLOAT, { .dbl = 0.0 }, -100.0, 100.0, .flags = FLAGS},
97 { "cw", "set the width crop area expression", OFFSET(cw), AV_OPT_TYPE_STRING, { .str = "iw" }, CHAR_MIN, CHAR_MAX, FLAGS },
98 { "ch", "set the height crop area expression", OFFSET(ch), AV_OPT_TYPE_STRING, { .str = "ih" }, CHAR_MIN, CHAR_MAX, FLAGS },
99 { "cx", "set the x crop area expression", OFFSET(cx), AV_OPT_TYPE_STRING, { .str = "(in_w-out_w)/2" }, CHAR_MIN, CHAR_MAX, FLAGS },
100 { "cy", "set the y crop area expression", OFFSET(cy), AV_OPT_TYPE_STRING, { .str = "(in_h-out_h)/2" }, CHAR_MIN, CHAR_MAX, FLAGS },
102 { "w", "Output video width", OFFSET(ow), AV_OPT_TYPE_STRING, { .str="cw" }, 0, 255, .flags = FLAGS },
103 { "width", "Output video width", OFFSET(ow), AV_OPT_TYPE_STRING, { .str="cw" }, 0, 255, .flags = FLAGS },
104 { "h", "Output video height", OFFSET(oh), AV_OPT_TYPE_STRING, { .str="w*ch/cw" }, 0, 255, .flags = FLAGS },
105 { "height", "Output video height", OFFSET(oh), AV_OPT_TYPE_STRING, { .str="w*ch/cw" }, 0, 255, .flags = FLAGS },
109 static const char *const var_names[] = {
124 VAR_oW, VAR_OUT_W, VAR_W,
125 VAR_oH, VAR_OUT_H, VAR_H,
133 static int eval_expr(AVFilterContext *ctx)
135 #define PASS_EXPR(e, s) {\
136 ret = av_expr_parse(&e, s, var_names, NULL, NULL, NULL, NULL, 0, ctx); \
138 av_log(ctx, AV_LOG_ERROR, "Error when passing '%s'.\n", s);\
142 #define CALC_EXPR(e, v, i) {\
143 i = v = av_expr_eval(e, var_values, NULL); \
145 VPPContext *vpp = ctx->priv;
146 double var_values[VAR_VARS_NB] = { NAN };
147 AVExpr *w_expr = NULL, *h_expr = NULL;
148 AVExpr *cw_expr = NULL, *ch_expr = NULL;
149 AVExpr *cx_expr = NULL, *cy_expr = NULL;
152 PASS_EXPR(cw_expr, vpp->cw);
153 PASS_EXPR(ch_expr, vpp->ch);
155 PASS_EXPR(w_expr, vpp->ow);
156 PASS_EXPR(h_expr, vpp->oh);
158 PASS_EXPR(cx_expr, vpp->cx);
159 PASS_EXPR(cy_expr, vpp->cy);
162 var_values[VAR_IN_W] = ctx->inputs[0]->w;
165 var_values[VAR_IN_H] = ctx->inputs[0]->h;
168 CALC_EXPR(cw_expr, var_values[CW], vpp->crop_w);
169 CALC_EXPR(ch_expr, var_values[CH], vpp->crop_h);
171 /* calc again in case cw is relative to ch */
172 CALC_EXPR(cw_expr, var_values[CW], vpp->crop_w);
175 var_values[VAR_OUT_W] = var_values[VAR_oW] = var_values[VAR_W],
178 var_values[VAR_OUT_H] = var_values[VAR_oH] = var_values[VAR_H],
181 /* calc again in case ow is relative to oh */
183 var_values[VAR_OUT_W] = var_values[VAR_oW] = var_values[VAR_W],
187 CALC_EXPR(cx_expr, var_values[CX], vpp->crop_x);
188 CALC_EXPR(cy_expr, var_values[CY], vpp->crop_y);
190 /* calc again in case cx is relative to cy */
191 CALC_EXPR(cx_expr, var_values[CX], vpp->crop_x);
193 if ((vpp->crop_w != var_values[VAR_iW]) || (vpp->crop_h != var_values[VAR_iH]))
197 av_expr_free(w_expr);
198 av_expr_free(h_expr);
199 av_expr_free(cw_expr);
200 av_expr_free(ch_expr);
201 av_expr_free(cx_expr);
202 av_expr_free(cy_expr);
209 static int config_input(AVFilterLink *inlink)
211 AVFilterContext *ctx = inlink->dst;
212 VPPContext *vpp = ctx->priv;
215 if (vpp->framerate.den == 0 || vpp->framerate.num == 0)
216 vpp->framerate = inlink->frame_rate;
218 if (av_cmp_q(vpp->framerate, inlink->frame_rate))
221 ret = eval_expr(ctx);
223 av_log(ctx, AV_LOG_ERROR, "Fail to eval expr.\n");
227 if (vpp->out_height == 0 || vpp->out_width == 0) {
228 vpp->out_width = inlink->w;
229 vpp->out_height = inlink->h;
233 vpp->crop_x = FFMAX(vpp->crop_x, 0);
234 vpp->crop_y = FFMAX(vpp->crop_y, 0);
236 if(vpp->crop_w + vpp->crop_x > inlink->w)
237 vpp->crop_x = inlink->w - vpp->crop_w;
238 if(vpp->crop_h + vpp->crop_y > inlink->h)
239 vpp->crop_y = inlink->h - vpp->crop_h;
245 static int config_output(AVFilterLink *outlink)
247 AVFilterContext *ctx = outlink->src;
248 VPPContext *vpp = ctx->priv;
249 QSVVPPParam param = { NULL };
250 QSVVPPCrop crop = { 0 };
251 mfxExtBuffer *ext_buf[ENH_FILTERS_COUNT];
253 outlink->w = vpp->out_width;
254 outlink->h = vpp->out_height;
255 outlink->frame_rate = vpp->framerate;
256 outlink->time_base = av_inv_q(vpp->framerate);
258 param.filter_frame = NULL;
259 param.out_sw_format = AV_PIX_FMT_NV12;
260 param.num_ext_buf = 0;
261 param.ext_buf = ext_buf;
265 crop.x = vpp->crop_x;
266 crop.y = vpp->crop_y;
267 crop.w = vpp->crop_w;
268 crop.h = vpp->crop_h;
274 if (vpp->deinterlace) {
275 memset(&vpp->deinterlace_conf, 0, sizeof(mfxExtVPPDeinterlacing));
276 vpp->deinterlace_conf.Header.BufferId = MFX_EXTBUFF_VPP_DEINTERLACING;
277 vpp->deinterlace_conf.Header.BufferSz = sizeof(mfxExtVPPDeinterlacing);
278 vpp->deinterlace_conf.Mode = vpp->deinterlace == 1 ?
279 MFX_DEINTERLACING_BOB : MFX_DEINTERLACING_ADVANCED;
281 param.ext_buf[param.num_ext_buf++] = (mfxExtBuffer*)&vpp->deinterlace_conf;
285 memset(&vpp->frc_conf, 0, sizeof(mfxExtVPPFrameRateConversion));
286 vpp->frc_conf.Header.BufferId = MFX_EXTBUFF_VPP_FRAME_RATE_CONVERSION;
287 vpp->frc_conf.Header.BufferSz = sizeof(mfxExtVPPFrameRateConversion);
288 vpp->frc_conf.Algorithm = MFX_FRCALGM_DISTRIBUTED_TIMESTAMP;
290 param.ext_buf[param.num_ext_buf++] = (mfxExtBuffer*)&vpp->frc_conf;
294 memset(&vpp->denoise_conf, 0, sizeof(mfxExtVPPDenoise));
295 vpp->denoise_conf.Header.BufferId = MFX_EXTBUFF_VPP_DENOISE;
296 vpp->denoise_conf.Header.BufferSz = sizeof(mfxExtVPPDenoise);
297 vpp->denoise_conf.DenoiseFactor = vpp->denoise;
299 param.ext_buf[param.num_ext_buf++] = (mfxExtBuffer*)&vpp->denoise_conf;
303 memset(&vpp->detail_conf, 0, sizeof(mfxExtVPPDetail));
304 vpp->detail_conf.Header.BufferId = MFX_EXTBUFF_VPP_DETAIL;
305 vpp->detail_conf.Header.BufferSz = sizeof(mfxExtVPPDetail);
306 vpp->detail_conf.DetailFactor = vpp->detail;
308 param.ext_buf[param.num_ext_buf++] = (mfxExtBuffer*)&vpp->detail_conf;
312 memset(&vpp->procamp_conf, 0, sizeof(mfxExtVPPProcAmp));
313 vpp->procamp_conf.Header.BufferId = MFX_EXTBUFF_VPP_PROCAMP;
314 vpp->procamp_conf.Header.BufferSz = sizeof(mfxExtVPPProcAmp);
315 vpp->procamp_conf.Hue = vpp->hue;
316 vpp->procamp_conf.Saturation = vpp->saturation;
317 vpp->procamp_conf.Contrast = vpp->contrast;
318 vpp->procamp_conf.Brightness = vpp->brightness;
320 param.ext_buf[param.num_ext_buf++] = (mfxExtBuffer*)&vpp->procamp_conf;
323 return ff_qsvvpp_create(ctx, &vpp->qsv, ¶m);
326 static int filter_frame(AVFilterLink *inlink, AVFrame *picref)
328 VPPContext *vpp = inlink->dst->priv;
330 return ff_qsvvpp_filter_frame(vpp->qsv, inlink, picref);
333 static int query_formats(AVFilterContext *ctx)
336 AVFilterFormats *in_fmts, *out_fmts;
337 static const enum AVPixelFormat in_pix_fmts[] = {
345 static const enum AVPixelFormat out_pix_fmts[] = {
351 in_fmts = ff_make_format_list(in_pix_fmts);
352 out_fmts = ff_make_format_list(out_pix_fmts);
353 ret = ff_formats_ref(in_fmts, &ctx->inputs[0]->out_formats);
356 ret = ff_formats_ref(out_fmts, &ctx->outputs[0]->in_formats);
363 static av_cold void vpp_uninit(AVFilterContext *ctx)
365 VPPContext *vpp = ctx->priv;
367 ff_qsvvpp_free(&vpp->qsv);
370 static const AVClass vpp_class = {
371 .class_name = "vpp_qsv",
372 .item_name = av_default_item_name,
374 .version = LIBAVUTIL_VERSION_INT,
377 static const AVFilterPad vpp_inputs[] = {
380 .type = AVMEDIA_TYPE_VIDEO,
381 .config_props = config_input,
382 .filter_frame = filter_frame,
387 static const AVFilterPad vpp_outputs[] = {
390 .type = AVMEDIA_TYPE_VIDEO,
391 .config_props = config_output,
396 AVFilter ff_vf_vpp_qsv = {
398 .description = NULL_IF_CONFIG_SMALL("Quick Sync Video VPP."),
399 .priv_size = sizeof(VPPContext),
400 .query_formats = query_formats,
401 .uninit = vpp_uninit,
402 .inputs = vpp_inputs,
403 .outputs = vpp_outputs,
404 .priv_class = &vpp_class,
405 .flags_internal = FF_FILTER_FLAG_HWFRAME_AWARE,