FFmpeg
qsvenc.h
Go to the documentation of this file.
1 /*
2  * Intel MediaSDK QSV encoder utility functions
3  *
4  * copyright (c) 2013 Yukinori Yamazoe
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg 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  * FFmpeg 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 FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #ifndef AVCODEC_QSVENC_H
24 #define AVCODEC_QSVENC_H
25 
26 #include <stdint.h>
27 #include <sys/types.h>
28 
29 #include <mfx/mfxvideo.h>
30 
31 #include "libavutil/avutil.h"
32 #include "libavutil/fifo.h"
33 
34 #include "avcodec.h"
35 #include "qsv_internal.h"
36 
37 #define QSV_HAVE_CO2 QSV_VERSION_ATLEAST(1, 6)
38 #define QSV_HAVE_CO3 QSV_VERSION_ATLEAST(1, 11)
39 #define QSV_HAVE_CO_VPS QSV_VERSION_ATLEAST(1, 17)
40 
41 #define QSV_HAVE_TRELLIS QSV_VERSION_ATLEAST(1, 8)
42 #define QSV_HAVE_MAX_SLICE_SIZE QSV_VERSION_ATLEAST(1, 9)
43 #define QSV_HAVE_BREF_TYPE QSV_VERSION_ATLEAST(1, 8)
44 
45 #define QSV_HAVE_LA QSV_VERSION_ATLEAST(1, 7)
46 #define QSV_HAVE_LA_DS QSV_VERSION_ATLEAST(1, 8)
47 #define QSV_HAVE_LA_HRD QSV_VERSION_ATLEAST(1, 11)
48 #define QSV_HAVE_VDENC QSV_VERSION_ATLEAST(1, 15)
49 
50 #define QSV_HAVE_GPB QSV_VERSION_ATLEAST(1, 18)
51 
52 #if defined(_WIN32) || defined(__CYGWIN__)
53 #define QSV_HAVE_AVBR QSV_VERSION_ATLEAST(1, 3)
54 #define QSV_HAVE_ICQ QSV_VERSION_ATLEAST(1, 8)
55 #define QSV_HAVE_VCM QSV_VERSION_ATLEAST(1, 8)
56 #define QSV_HAVE_QVBR QSV_VERSION_ATLEAST(1, 11)
57 #define QSV_HAVE_MF 0
58 #else
59 #define QSV_HAVE_AVBR 0
60 #define QSV_HAVE_ICQ QSV_VERSION_ATLEAST(1, 28)
61 #define QSV_HAVE_VCM 0
62 #define QSV_HAVE_QVBR QSV_VERSION_ATLEAST(1, 28)
63 #define QSV_HAVE_MF QSV_VERSION_ATLEAST(1, 25)
64 #endif
65 
66 #if !QSV_HAVE_LA_DS
67 #define MFX_LOOKAHEAD_DS_UNKNOWN 0
68 #define MFX_LOOKAHEAD_DS_OFF 0
69 #define MFX_LOOKAHEAD_DS_2x 0
70 #define MFX_LOOKAHEAD_DS_4x 0
71 #endif
72 
73 #define QSV_COMMON_OPTS \
74 { "async_depth", "Maximum processing parallelism", OFFSET(qsv.async_depth), AV_OPT_TYPE_INT, { .i64 = ASYNC_DEPTH_DEFAULT }, 1, INT_MAX, VE }, \
75 { "avbr_accuracy", "Accuracy of the AVBR ratecontrol", OFFSET(qsv.avbr_accuracy), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, VE }, \
76 { "avbr_convergence", "Convergence of the AVBR ratecontrol", OFFSET(qsv.avbr_convergence), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, VE }, \
77 { "preset", NULL, OFFSET(qsv.preset), AV_OPT_TYPE_INT, { .i64 = MFX_TARGETUSAGE_BALANCED }, MFX_TARGETUSAGE_BEST_QUALITY, MFX_TARGETUSAGE_BEST_SPEED, VE, "preset" }, \
78 { "veryfast", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_BEST_SPEED }, INT_MIN, INT_MAX, VE, "preset" }, \
79 { "faster", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_6 }, INT_MIN, INT_MAX, VE, "preset" }, \
80 { "fast", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_5 }, INT_MIN, INT_MAX, VE, "preset" }, \
81 { "medium", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_BALANCED }, INT_MIN, INT_MAX, VE, "preset" }, \
82 { "slow", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_3 }, INT_MIN, INT_MAX, VE, "preset" }, \
83 { "slower", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_2 }, INT_MIN, INT_MAX, VE, "preset" }, \
84 { "veryslow", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = MFX_TARGETUSAGE_BEST_QUALITY }, INT_MIN, INT_MAX, VE, "preset" }, \
85 { "rdo", "Enable rate distortion optimization", OFFSET(qsv.rdo), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
86 { "max_frame_size", "Maximum encoded frame size in bytes", OFFSET(qsv.max_frame_size), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, UINT16_MAX, VE }, \
87 { "max_slice_size", "Maximum encoded slice size in bytes", OFFSET(qsv.max_slice_size), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, UINT16_MAX, VE }, \
88 { "bitrate_limit", "Toggle bitrate limitations", OFFSET(qsv.bitrate_limit), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
89 { "mbbrc", "MB level bitrate control", OFFSET(qsv.mbbrc), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
90 { "extbrc", "Extended bitrate control", OFFSET(qsv.extbrc), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
91 { "adaptive_i", "Adaptive I-frame placement", OFFSET(qsv.adaptive_i), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
92 { "adaptive_b", "Adaptive B-frame placement", OFFSET(qsv.adaptive_b), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
93 { "b_strategy", "Strategy to choose between I/P/B-frames", OFFSET(qsv.b_strategy), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, VE }, \
94 { "forced_idr", "Forcing I frames as IDR frames", OFFSET(qsv.forced_idr), AV_OPT_TYPE_BOOL,{ .i64 = 0 }, 0, 1, VE }, \
95 { "low_power", "enable low power mode(experimental: many limitations by mfx version, BRC modes, etc.)", OFFSET(qsv.low_power), AV_OPT_TYPE_BOOL, { .i64 = 0}, 0, 1, VE},\
96 
97 typedef int SetEncodeCtrlCB (AVCodecContext *avctx,
98  const AVFrame *frame, mfxEncodeCtrl* enc_ctrl);
99 typedef struct QSVEncContext {
101 
103 
104  mfxSession session;
106 
110 
111  mfxVideoParam param;
112  mfxFrameAllocRequest req;
113 
114  mfxExtCodingOption extco;
115 #if QSV_HAVE_CO2
116  mfxExtCodingOption2 extco2;
117 #endif
118 #if QSV_HAVE_CO3
119  mfxExtCodingOption3 extco3;
120 #endif
121 #if QSV_HAVE_MF
122  mfxExtMultiFrameParam extmfp;
123  mfxExtMultiFrameControl extmfc;
124 #endif
125  mfxExtOpaqueSurfaceAlloc opaque_alloc;
126  mfxFrameSurface1 **opaque_surfaces;
128 
131 
132  mfxExtBuffer **extparam;
133 
135 
137 
138  mfxVersion ver;
139 
140  int hevc_vps;
141 
142  // options set by the caller
145  int profile;
146  int preset;
153  int vcm;
154  int rdo;
157 
158  int aud;
159 
162 
164  int mbbrc;
165  int extbrc;
169  int cavlc;
170 
175 
178  int gpb;
179 
180  int a53_cc;
181 
182 #if QSV_HAVE_MF
183  int mfmode;
184 #endif
188 } QSVEncContext;
189 
191 
193  AVPacket *pkt, const AVFrame *frame, int *got_packet);
194 
196 
197 #endif /* AVCODEC_QSVENC_H */
int single_sei_nal_unit
Definition: qsvenc.h:160
mfxExtBuffer * extparam_internal[2+QSV_HAVE_CO2+QSV_HAVE_CO3+(QSV_HAVE_MF *2)]
Definition: qsvenc.h:129
AVBufferRef * opaque_alloc_buf
Definition: qsvenc.h:127
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
mfxExtBuffer ** extparam
Definition: qsvenc.h:132
int int_ref_type
Definition: qsvenc.h:171
mfxExtOpaqueSurfaceAlloc opaque_alloc
Definition: qsvenc.h:125
int max_frame_size
Definition: qsvenc.h:155
int hevc_vps
Definition: qsvenc.h:140
mfxFrameAllocRequest req
Definition: qsvenc.h:112
int avbr_accuracy
Definition: qsvenc.h:147
QSVFrame * work_frames
Definition: qsvenc.h:102
int look_ahead_depth
Definition: qsvenc.h:151
int int_ref_qp_delta
Definition: qsvenc.h:173
Convenience header that includes libavutil&#39;s core.
QSVFramesContext frames_ctx
Definition: qsvenc.h:136
int packet_size
Definition: qsvenc.h:107
static AVPacket pkt
int bitrate_limit
Definition: qsvenc.h:163
int look_ahead
Definition: qsvenc.h:150
int SetEncodeCtrlCB(AVCodecContext *avctx, const AVFrame *frame, mfxEncodeCtrl *enc_ctrl)
Definition: qsvenc.h:97
mfxVideoParam param
Definition: qsvenc.h:111
#define QSV_HAVE_CO2
Definition: qsvenc.h:37
AVFifoBuffer * async_fifo
Definition: qsvenc.h:134
mfxExtCodingOption extco
Definition: qsvenc.h:114
mfxFrameSurface1 ** opaque_surfaces
Definition: qsvenc.h:126
int b_strategy
Definition: qsvenc.h:168
int ff_qsv_encode(AVCodecContext *avctx, QSVEncContext *q, AVPacket *pkt, const AVFrame *frame, int *got_packet)
Definition: qsvenc.c:1414
char * load_plugins
Definition: qsvenc.h:185
int low_power
Definition: qsvenc.h:177
int nb_extparam_internal
Definition: qsvenc.h:130
int max_dec_frame_buffering
Definition: qsvenc.h:161
int ff_qsv_enc_close(AVCodecContext *avctx, QSVEncContext *q)
Definition: qsvenc.c:1506
int adaptive_i
Definition: qsvenc.h:166
AVCodecContext * avctx
Definition: qsvenc.h:100
int idr_interval
Definition: qsvenc.h:144
int a53_cc
Definition: qsvenc.h:180
mfxVersion ver
Definition: qsvenc.h:138
int extbrc
Definition: qsvenc.h:165
int preset
Definition: qsvenc.h:146
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
int ff_qsv_enc_init(AVCodecContext *avctx, QSVEncContext *q)
Definition: qsvenc.c:997
int repeat_pps
Definition: qsvenc.h:176
int async_depth
Definition: qsvenc.h:143
int width_align
Definition: qsvenc.h:108
#define QSV_HAVE_CO3
Definition: qsvenc.h:38
Libavcodec external API header.
main external API structure.
Definition: avcodec.h:1568
int profile
Definition: qsvenc.h:145
a very simple circular buffer FIFO implementation
int height_align
Definition: qsvenc.h:109
QSVSession internal_qs
Definition: qsvenc.h:105
int max_slice_size
Definition: qsvenc.h:156
int int_ref_cycle_size
Definition: qsvenc.h:172
int adaptive_b
Definition: qsvenc.h:167
A reference to a data buffer.
Definition: buffer.h:81
int avbr_convergence
Definition: qsvenc.h:148
int forced_idr
Definition: qsvenc.h:187
int recovery_point_sei
Definition: qsvenc.h:174
#define QSV_HAVE_MF
Definition: qsvenc.h:63
int look_ahead_downsampling
Definition: qsvenc.h:152
This structure stores compressed data.
Definition: avcodec.h:1457
mfxSession session
Definition: qsvenc.h:104
int pic_timing_sei
Definition: qsvenc.h:149
SetEncodeCtrlCB * set_encode_ctrl_cb
Definition: qsvenc.h:186