Libav
qsvenc_h264.c
Go to the documentation of this file.
1 /*
2  * Intel MediaSDK QSV based H.264 enccoder
3  *
4  * copyright (c) 2013 Yukinori Yamazoe
5  *
6  * This file is part of Libav.
7  *
8  * Libav is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * Libav is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with Libav; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 
24 #include <stdint.h>
25 #include <sys/types.h>
26 
27 #include <mfx/mfxvideo.h>
28 
29 #include "libavutil/common.h"
30 #include "libavutil/opt.h"
31 
32 #include "avcodec.h"
33 #include "internal.h"
34 #include "qsv.h"
35 #include "qsv_internal.h"
36 #include "qsvenc.h"
37 
38 typedef struct QSVH264EncContext {
39  AVClass *class;
42 
44 {
45  QSVH264EncContext *q = avctx->priv_data;
46 
47  return ff_qsv_enc_init(avctx, &q->qsv);
48 }
49 
50 static int qsv_enc_frame(AVCodecContext *avctx, AVPacket *pkt,
51  const AVFrame *frame, int *got_packet)
52 {
53  QSVH264EncContext *q = avctx->priv_data;
54 
55  return ff_qsv_encode(avctx, &q->qsv, pkt, frame, got_packet);
56 }
57 
59 {
60  QSVH264EncContext *q = avctx->priv_data;
61 
62  return ff_qsv_enc_close(avctx, &q->qsv);
63 }
64 
65 #define OFFSET(x) offsetof(QSVH264EncContext, x)
66 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
67 static const AVOption options[] = {
69 
70  { "idr_interval", "Distance (in I-frames) between IDR frames", OFFSET(qsv.idr_interval), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, VE },
71  { "single_sei_nal_unit", "Put all the SEI messages into one NALU", OFFSET(qsv.single_sei_nal_unit), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
72  { "max_dec_frame_buffering", "Maximum number of frames buffered in the DPB", OFFSET(qsv.max_dec_frame_buffering), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, UINT16_MAX, VE },
73 
74  { "int_ref_type", "Intra refresh type", OFFSET(qsv.int_ref_type), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, UINT16_MAX, VE, "int_ref_type" },
75  { "none", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 0 }, .flags = VE, "int_ref_type" },
76  { "vertical", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = 1 }, .flags = VE, "int_ref_type" },
77  { "int_ref_cycle_size", "Number of frames in the intra refresh cycle", OFFSET(qsv.int_ref_cycle_size), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, UINT16_MAX, VE },
78  { "int_ref_qp_delta", "QP difference for the refresh MBs", OFFSET(qsv.int_ref_qp_delta), AV_OPT_TYPE_INT, { .i64 = INT16_MIN }, INT16_MIN, INT16_MAX, VE },
79  { "recovery_point_sei", "Insert recovery point SEI messages", OFFSET(qsv.recovery_point_sei), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE },
80 
81  { "trellis", "Trellis quantization", OFFSET(qsv.trellis), AV_OPT_TYPE_FLAGS, { .i64 = 0 }, 0, UINT_MAX, VE, "trellis" },
82  { "off", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TRELLIS_OFF }, .flags = VE, "trellis" },
83  { "I", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TRELLIS_I }, .flags = VE, "trellis" },
84  { "P", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TRELLIS_P }, .flags = VE, "trellis" },
85  { "B", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TRELLIS_B }, .flags = VE, "trellis" },
86 
87  { "profile", NULL, OFFSET(qsv.profile), AV_OPT_TYPE_INT, { .i64 = MFX_PROFILE_UNKNOWN }, 0, INT_MAX, VE, "profile" },
88  { "unknown" , NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_PROFILE_UNKNOWN }, INT_MIN, INT_MAX, VE, "profile" },
89  { "baseline", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_PROFILE_AVC_BASELINE }, INT_MIN, INT_MAX, VE, "profile" },
90  { "main" , NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_PROFILE_AVC_MAIN }, INT_MIN, INT_MAX, VE, "profile" },
91  { "high" , NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_PROFILE_AVC_HIGH }, INT_MIN, INT_MAX, VE, "profile" },
92 
93  { NULL },
94 };
95 
96 static const AVClass class = {
97  .class_name = "h264_qsv encoder",
98  .item_name = av_default_item_name,
99  .option = options,
101 };
102 
104  { "b", "1M" },
105  { "refs", "0" },
106  // same as the x264 default
107  { "g", "250" },
108  { "bf", "3" },
109  { "coder", "ac" },
110 
111  { "flags", "+cgop" },
112 #if FF_API_PRIVATE_OPT
113  { "b_strategy", "-1" },
114 #endif
115  { NULL },
116 };
117 
119  .name = "h264_qsv",
120  .long_name = NULL_IF_CONFIG_SMALL("H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 (Intel Quick Sync Video acceleration)"),
121  .priv_data_size = sizeof(QSVH264EncContext),
122  .type = AVMEDIA_TYPE_VIDEO,
123  .id = AV_CODEC_ID_H264,
124  .init = qsv_enc_init,
125  .encode2 = qsv_enc_frame,
126  .close = qsv_enc_close,
127  .capabilities = AV_CODEC_CAP_DELAY,
128  .pix_fmts = (const enum AVPixelFormat[]){ AV_PIX_FMT_NV12,
131  AV_PIX_FMT_NONE },
132  .priv_class = &class,
133  .defaults = qsv_enc_defaults,
134  .caps_internal = FF_CODEC_CAP_INIT_CLEANUP,
135 };
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
Definition: internal.h:48
int single_sei_nal_unit
Definition: qsvenc.h:116
This structure describes decoded (raw) audio or video data.
Definition: frame.h:140
AVOption.
Definition: opt.h:234
int int_ref_type
Definition: qsvenc.h:128
int int_ref_qp_delta
Definition: qsvenc.h:130
AVCodec.
Definition: avcodec.h:3120
#define AV_PIX_FMT_P010
Definition: pixfmt.h:288
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:39
#define AV_CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
Definition: avcodec.h:863
int ff_qsv_encode(AVCodecContext *avctx, QSVEncContext *q, AVPacket *pkt, const AVFrame *frame, int *got_packet)
Definition: qsvenc.c:1007
#define av_cold
Definition: attributes.h:66
AVOptions.
static const AVCodecDefault qsv_enc_defaults[]
Definition: qsvenc_h264.c:103
#define QSV_COMMON_OPTS
Definition: qsvenc.h:50
int ff_qsv_enc_close(AVCodecContext *avctx, QSVEncContext *q)
Definition: qsvenc.c:1076
static const AVOption options[]
Definition: qsvenc_h264.c:67
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:148
planar YUV 4:2:0, 12bpp, 1 plane for Y and 1 plane for the UV components, which are interleaved (firs...
Definition: pixfmt.h:86
const char * name
Name of the codec implementation.
Definition: avcodec.h:3127
int max_dec_frame_buffering
Definition: qsvenc.h:117
AVCodec ff_h264_qsv_encoder
Definition: qsvenc_h264.c:118
int idr_interval
Definition: qsvenc.h:105
LIBAVUTIL_VERSION_INT
Definition: eval.c:55
NULL
Definition: eval.c:55
QSVEncContext qsv
Definition: qsvenc_h264.c:40
Libavcodec external API header.
av_default_item_name
Definition: dnxhdenc.c:55
main external API structure.
Definition: avcodec.h:1409
int profile
Definition: qsvenc.h:106
Describe the class of an AVClass context structure.
Definition: log.h:34
int ff_qsv_enc_init(AVCodecContext *avctx, QSVEncContext *q)
Definition: qsvenc.c:708
HW acceleration through QSV, data[3] contains a pointer to the mfxFrameSurface1 structure.
Definition: pixfmt.h:215
static int qsv_enc_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *frame, int *got_packet)
Definition: qsvenc_h264.c:50
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:257
int int_ref_cycle_size
Definition: qsvenc.h:129
static av_cold int qsv_enc_init(AVCodecContext *avctx)
Definition: qsvenc_h264.c:43
common internal api header.
common internal and external API header
static av_cold int init(AVCodecParserContext *s)
Definition: h264_parser.c:582
void * priv_data
Definition: avcodec.h:1451
#define VE
Definition: qsvenc_h264.c:66
int recovery_point_sei
Definition: qsvenc.h:131
#define OFFSET(x)
Definition: qsvenc_h264.c:65
static av_cold int qsv_enc_close(AVCodecContext *avctx)
Definition: qsvenc_h264.c:58
int trellis
Definition: qsvenc.h:118
AVPixelFormat
Pixel format.
Definition: pixfmt.h:57
This structure stores compressed data.
Definition: avcodec.h:1323