2 * This file is part of Libav.
4 * Libav 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 * Libav 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 Libav; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 * deinterlace video filter - QSV
24 #include <mfx/mfxvideo.h>
29 #include "libavutil/avstring.h"
30 #include "libavutil/common.h"
31 #include "libavutil/hwcontext.h"
32 #include "libavutil/hwcontext_qsv.h"
33 #include "libavutil/internal.h"
34 #include "libavutil/mathematics.h"
35 #include "libavutil/opt.h"
36 #include "libavutil/pixdesc.h"
37 #include "libavutil/time.h"
45 QSVDEINT_MORE_OUTPUT = 1,
49 typedef struct QSVFrame {
51 mfxFrameSurface1 surface;
54 struct QSVFrame *next;
57 typedef struct QSVDeintContext {
60 AVBufferRef *hw_frames_ctx;
61 /* a clone of the main session, used internally for deinterlacing */
67 mfxFrameSurface1 **surface_ptrs;
70 mfxExtOpaqueSurfaceAlloc opaque_alloc;
71 mfxExtBuffer *ext_buffers[1];
73 QSVFrame *work_frames;
81 static void qsvdeint_uninit(AVFilterContext *ctx)
83 QSVDeintContext *s = ctx->priv;
90 av_buffer_unref(&s->hw_frames_ctx);
94 s->work_frames = cur->next;
95 av_frame_free(&cur->frame);
100 av_freep(&s->mem_ids);
103 av_freep(&s->surface_ptrs);
104 s->nb_surface_ptrs = 0;
107 static int qsvdeint_query_formats(AVFilterContext *ctx)
109 static const enum AVPixelFormat pixel_formats[] = {
110 AV_PIX_FMT_QSV, AV_PIX_FMT_NONE,
112 AVFilterFormats *pix_fmts = ff_make_format_list(pixel_formats);
114 ff_set_common_formats(ctx, pix_fmts);
119 static mfxStatus frame_alloc(mfxHDL pthis, mfxFrameAllocRequest *req,
120 mfxFrameAllocResponse *resp)
122 AVFilterContext *ctx = pthis;
123 QSVDeintContext *s = ctx->priv;
125 if (!(req->Type & MFX_MEMTYPE_VIDEO_MEMORY_PROCESSOR_TARGET) ||
126 !(req->Type & (MFX_MEMTYPE_FROM_VPPIN | MFX_MEMTYPE_FROM_VPPOUT)) ||
127 !(req->Type & MFX_MEMTYPE_EXTERNAL_FRAME))
128 return MFX_ERR_UNSUPPORTED;
130 resp->mids = s->mem_ids;
131 resp->NumFrameActual = s->nb_mem_ids;
136 static mfxStatus frame_free(mfxHDL pthis, mfxFrameAllocResponse *resp)
141 static mfxStatus frame_lock(mfxHDL pthis, mfxMemId mid, mfxFrameData *ptr)
143 return MFX_ERR_UNSUPPORTED;
146 static mfxStatus frame_unlock(mfxHDL pthis, mfxMemId mid, mfxFrameData *ptr)
148 return MFX_ERR_UNSUPPORTED;
151 static mfxStatus frame_get_hdl(mfxHDL pthis, mfxMemId mid, mfxHDL *hdl)
157 static const mfxHandleType handle_types[] = {
158 MFX_HANDLE_VA_DISPLAY,
159 MFX_HANDLE_D3D9_DEVICE_MANAGER,
160 MFX_HANDLE_D3D11_DEVICE,
163 static int init_out_session(AVFilterContext *ctx)
166 QSVDeintContext *s = ctx->priv;
167 AVHWFramesContext *hw_frames_ctx = (AVHWFramesContext*)s->hw_frames_ctx->data;
168 AVQSVFramesContext *hw_frames_hwctx = hw_frames_ctx->hwctx;
169 AVQSVDeviceContext *device_hwctx = hw_frames_ctx->device_ctx->hwctx;
171 int opaque = !!(hw_frames_hwctx->frame_type & MFX_MEMTYPE_OPAQUE_FRAME);
173 mfxHDL handle = NULL;
174 mfxHandleType handle_type;
181 /* extract the properties of the "master" session given to us */
182 err = MFXQueryIMPL(device_hwctx->session, &impl);
183 if (err == MFX_ERR_NONE)
184 err = MFXQueryVersion(device_hwctx->session, &ver);
185 if (err != MFX_ERR_NONE) {
186 av_log(ctx, AV_LOG_ERROR, "Error querying the session attributes\n");
187 return AVERROR_UNKNOWN;
190 for (i = 0; i < FF_ARRAY_ELEMS(handle_types); i++) {
191 err = MFXVideoCORE_GetHandle(device_hwctx->session, handle_types[i], &handle);
192 if (err == MFX_ERR_NONE) {
193 handle_type = handle_types[i];
198 /* create a "slave" session with those same properties, to be used for
199 * actual deinterlacing */
200 err = MFXInit(impl, &ver, &s->session);
201 if (err != MFX_ERR_NONE) {
202 av_log(ctx, AV_LOG_ERROR, "Error initializing a session for deinterlacing\n");
203 return AVERROR_UNKNOWN;
207 err = MFXVideoCORE_SetHandle(s->session, handle_type, handle);
208 if (err != MFX_ERR_NONE)
209 return AVERROR_UNKNOWN;
212 memset(&par, 0, sizeof(par));
215 s->surface_ptrs = av_mallocz_array(hw_frames_hwctx->nb_surfaces,
216 sizeof(*s->surface_ptrs));
217 if (!s->surface_ptrs)
218 return AVERROR(ENOMEM);
219 for (i = 0; i < hw_frames_hwctx->nb_surfaces; i++)
220 s->surface_ptrs[i] = hw_frames_hwctx->surfaces + i;
221 s->nb_surface_ptrs = hw_frames_hwctx->nb_surfaces;
223 s->opaque_alloc.In.Surfaces = s->surface_ptrs;
224 s->opaque_alloc.In.NumSurface = s->nb_surface_ptrs;
225 s->opaque_alloc.In.Type = hw_frames_hwctx->frame_type;
227 s->opaque_alloc.Out = s->opaque_alloc.In;
229 s->opaque_alloc.Header.BufferId = MFX_EXTBUFF_OPAQUE_SURFACE_ALLOCATION;
230 s->opaque_alloc.Header.BufferSz = sizeof(s->opaque_alloc);
232 s->ext_buffers[0] = (mfxExtBuffer*)&s->opaque_alloc;
234 par.ExtParam = s->ext_buffers;
235 par.NumExtParam = FF_ARRAY_ELEMS(s->ext_buffers);
237 par.IOPattern = MFX_IOPATTERN_IN_OPAQUE_MEMORY | MFX_IOPATTERN_OUT_OPAQUE_MEMORY;
239 mfxFrameAllocator frame_allocator = {
241 .Alloc = frame_alloc,
243 .Unlock = frame_unlock,
244 .GetHDL = frame_get_hdl,
248 s->mem_ids = av_mallocz_array(hw_frames_hwctx->nb_surfaces,
249 sizeof(*s->mem_ids));
251 return AVERROR(ENOMEM);
252 for (i = 0; i < hw_frames_hwctx->nb_surfaces; i++)
253 s->mem_ids[i] = hw_frames_hwctx->surfaces[i].Data.MemId;
254 s->nb_mem_ids = hw_frames_hwctx->nb_surfaces;
256 err = MFXVideoCORE_SetFrameAllocator(s->session, &frame_allocator);
257 if (err != MFX_ERR_NONE)
258 return AVERROR_UNKNOWN;
260 par.IOPattern = MFX_IOPATTERN_IN_VIDEO_MEMORY | MFX_IOPATTERN_OUT_VIDEO_MEMORY;
263 par.AsyncDepth = 1; // TODO async
265 par.vpp.In = hw_frames_hwctx->surfaces[0].Info;
267 par.vpp.In.CropW = ctx->inputs[0]->w;
268 par.vpp.In.CropH = ctx->inputs[0]->h;
270 if (ctx->inputs[0]->frame_rate.num) {
271 par.vpp.In.FrameRateExtN = ctx->inputs[0]->frame_rate.num;
272 par.vpp.In.FrameRateExtD = ctx->inputs[0]->frame_rate.den;
274 par.vpp.In.FrameRateExtN = ctx->inputs[0]->time_base.num;
275 par.vpp.In.FrameRateExtD = ctx->inputs[0]->time_base.den;
278 par.vpp.Out = par.vpp.In;
280 if (ctx->outputs[0]->frame_rate.num) {
281 par.vpp.Out.FrameRateExtN = ctx->outputs[0]->frame_rate.num;
282 par.vpp.Out.FrameRateExtD = ctx->outputs[0]->frame_rate.den;
284 par.vpp.Out.FrameRateExtN = ctx->outputs[0]->time_base.num;
285 par.vpp.Out.FrameRateExtD = ctx->outputs[0]->time_base.den;
288 err = MFXVideoVPP_Init(s->session, &par);
289 if (err != MFX_ERR_NONE) {
290 av_log(ctx, AV_LOG_ERROR, "Error opening the VPP for deinterlacing: %d\n", err);
291 return AVERROR_UNKNOWN;
297 static int qsvdeint_config_props(AVFilterLink *outlink)
299 AVFilterContext *ctx = outlink->src;
300 AVFilterLink *inlink = ctx->inputs[0];
301 QSVDeintContext *s = ctx->priv;
304 qsvdeint_uninit(ctx);
306 s->last_pts = AV_NOPTS_VALUE;
307 outlink->frame_rate = av_mul_q(inlink->frame_rate,
308 (AVRational){ 2, 1 });
309 outlink->time_base = av_mul_q(inlink->time_base,
310 (AVRational){ 1, 2 });
312 /* check that we have a hw context */
313 if (!inlink->hw_frames_ctx) {
314 av_log(ctx, AV_LOG_ERROR, "No hw context provided on input\n");
315 return AVERROR(EINVAL);
318 s->hw_frames_ctx = av_buffer_ref(inlink->hw_frames_ctx);
319 if (!s->hw_frames_ctx)
320 return AVERROR(ENOMEM);
322 av_buffer_unref(&outlink->hw_frames_ctx);
323 outlink->hw_frames_ctx = av_buffer_ref(inlink->hw_frames_ctx);
324 if (!outlink->hw_frames_ctx) {
325 qsvdeint_uninit(ctx);
326 return AVERROR(ENOMEM);
329 ret = init_out_session(ctx);
337 static void clear_unused_frames(QSVDeintContext *s)
339 QSVFrame *cur = s->work_frames;
341 if (!cur->surface.Data.Locked) {
342 av_frame_free(&cur->frame);
349 static int get_free_frame(QSVDeintContext *s, QSVFrame **f)
351 QSVFrame *frame, **last;
353 clear_unused_frames(s);
355 frame = s->work_frames;
356 last = &s->work_frames;
367 frame = av_mallocz(sizeof(*frame));
369 return AVERROR(ENOMEM);
376 static int submit_frame(AVFilterContext *ctx, AVFrame *frame,
377 mfxFrameSurface1 **surface)
379 QSVDeintContext *s = ctx->priv;
383 ret = get_free_frame(s, &qf);
389 qf->surface = *(mfxFrameSurface1*)qf->frame->data[3];
391 qf->surface.Data.Locked = 0;
392 qf->surface.Info.CropW = qf->frame->width;
393 qf->surface.Info.CropH = qf->frame->height;
395 qf->surface.Info.PicStruct = !qf->frame->interlaced_frame ? MFX_PICSTRUCT_PROGRESSIVE :
396 (qf->frame->top_field_first ? MFX_PICSTRUCT_FIELD_TFF :
397 MFX_PICSTRUCT_FIELD_BFF);
398 if (qf->frame->repeat_pict == 1)
399 qf->surface.Info.PicStruct |= MFX_PICSTRUCT_FIELD_REPEATED;
400 else if (qf->frame->repeat_pict == 2)
401 qf->surface.Info.PicStruct |= MFX_PICSTRUCT_FRAME_DOUBLING;
402 else if (qf->frame->repeat_pict == 4)
403 qf->surface.Info.PicStruct |= MFX_PICSTRUCT_FRAME_TRIPLING;
405 if (ctx->inputs[0]->frame_rate.num) {
406 qf->surface.Info.FrameRateExtN = ctx->inputs[0]->frame_rate.num;
407 qf->surface.Info.FrameRateExtD = ctx->inputs[0]->frame_rate.den;
409 qf->surface.Info.FrameRateExtN = ctx->inputs[0]->time_base.num;
410 qf->surface.Info.FrameRateExtD = ctx->inputs[0]->time_base.den;
413 qf->surface.Data.TimeStamp = av_rescale_q(qf->frame->pts,
414 ctx->inputs[0]->time_base,
415 (AVRational){1, 90000});
417 *surface = &qf->surface;
423 static int process_frame(AVFilterContext *ctx, const AVFrame *in,
424 mfxFrameSurface1 *surf_in)
426 QSVDeintContext *s = ctx->priv;
427 AVFilterLink *inlink = ctx->inputs[0];
428 AVFilterLink *outlink = ctx->outputs[0];
431 mfxFrameSurface1 *surf_out;
432 mfxSyncPoint sync = NULL;
436 out = av_frame_alloc();
438 return AVERROR(ENOMEM);
440 ret = av_hwframe_get_buffer(s->hw_frames_ctx, out, 0);
444 surf_out = (mfxFrameSurface1*)out->data[3];
445 surf_out->Info.CropW = outlink->w;
446 surf_out->Info.CropH = outlink->h;
447 surf_out->Info.PicStruct = MFX_PICSTRUCT_PROGRESSIVE;
450 err = MFXVideoVPP_RunFrameVPPAsync(s->session, surf_in, surf_out,
452 if (err == MFX_WRN_DEVICE_BUSY)
454 } while (err == MFX_WRN_DEVICE_BUSY);
456 if (err == MFX_ERR_MORE_DATA) {
458 return QSVDEINT_MORE_INPUT;
461 if ((err < 0 && err != MFX_ERR_MORE_SURFACE) || !sync) {
462 av_log(ctx, AV_LOG_ERROR, "Error during deinterlacing: %d\n", err);
463 ret = AVERROR_UNKNOWN;
466 if (err == MFX_ERR_MORE_SURFACE)
470 err = MFXVideoCORE_SyncOperation(s->session, sync, 1000);
471 } while (err == MFX_WRN_IN_EXECUTION);
473 av_log(ctx, AV_LOG_ERROR, "Error synchronizing the operation: %d\n", err);
474 ret = AVERROR_UNKNOWN;
478 ret = av_frame_copy_props(out, in);
482 out->width = outlink->w;
483 out->height = outlink->h;
484 out->interlaced_frame = 0;
486 out->pts = av_rescale_q(out->pts, inlink->time_base, outlink->time_base);
487 if (out->pts == s->last_pts)
489 s->last_pts = out->pts;
491 ret = ff_filter_frame(outlink, out);
495 return again ? QSVDEINT_MORE_OUTPUT : 0;
501 static int qsvdeint_filter_frame(AVFilterLink *link, AVFrame *in)
503 AVFilterContext *ctx = link->dst;
505 mfxFrameSurface1 *surf_in;
508 ret = submit_frame(ctx, in, &surf_in);
515 ret = process_frame(ctx, in, surf_in);
518 } while (ret == QSVDEINT_MORE_OUTPUT);
523 static int qsvdeint_request_frame(AVFilterLink *outlink)
525 AVFilterContext *ctx = outlink->src;
526 QSVDeintContext *s = ctx->priv;
529 s->got_output_frame = 0;
530 while (ret >= 0 && !s->got_output_frame)
531 ret = ff_request_frame(ctx->inputs[0]);
536 #define OFFSET(x) offsetof(QSVDeintContext, x)
537 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM
538 static const AVOption options[] = {
542 static const AVClass qsvdeint_class = {
543 .class_name = "deinterlace_qsv",
544 .item_name = av_default_item_name,
546 .version = LIBAVUTIL_VERSION_INT,
549 static const AVFilterPad qsvdeint_inputs[] = {
552 .type = AVMEDIA_TYPE_VIDEO,
553 .filter_frame = qsvdeint_filter_frame,
558 static const AVFilterPad qsvdeint_outputs[] = {
561 .type = AVMEDIA_TYPE_VIDEO,
562 .config_props = qsvdeint_config_props,
563 .request_frame = qsvdeint_request_frame,
568 AVFilter ff_vf_deinterlace_qsv = {
569 .name = "deinterlace_qsv",
570 .description = NULL_IF_CONFIG_SMALL("QuickSync video deinterlacing"),
572 .uninit = qsvdeint_uninit,
573 .query_formats = qsvdeint_query_formats,
575 .priv_size = sizeof(QSVDeintContext),
576 .priv_class = &qsvdeint_class,
578 .inputs = qsvdeint_inputs,
579 .outputs = qsvdeint_outputs,