forked from intel/libva
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathva_fei_hevc.h
251 lines (232 loc) · 11.2 KB
/
va_fei_hevc.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
/*
* Copyright (c) 2007-2017 Intel Corporation. All Rights Reserved.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sub license, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice (including the
* next paragraph) shall be included in all copies or substantial portions
* of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
* IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR
* ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
/**
* \file va_fei_hevc.h
* \brief The FEI encoding HEVC special API
*/
#ifndef __VA_FEI_HEVC_H__
#define __VA_FEI_HEVC_H__
#ifdef __cplusplus
extern "C" {
#endif
#include <stdint.h>
#include "va_fei.h"
/**
* \defgroup api_fei_hevc HEVC FEI encoding API
*
* @{
*/
/** \brief FEI frame level control buffer for HEVC */
typedef struct _VAEncMiscParameterFEIFrameControlHEVC {
/* one of the VAConfigAttribFEIFunctionType values */
uint32_t function;
/** \brief CTB control input buffer. It is valid only when per_ctb_input
* is set to 1. The data in this buffer correspond to the input source. CTB is in raster scan order,
* each CTB control data structure is defined by VAEncFEICTBControlHEVC.
* Buffer size shall not be less than the number of CTBs multiplied by
* sizeof(VAEncFEICTBControlHEVC).
*/
VABufferID ctb_ctrl;
/** \brief CTB cmd per CTB data output of ENC
* it is reserved for CTB level information
* it should include CU split information and other CTB datas .
* Each CTB block has one CTB cmd data.
*/
VABufferID ctb_cmd;
/** \brief CU record data output of ENC
* it is reserved for CU level information
* it should include CU detail data. include mode,MV, reference etc.
* Each CTB block has one CU record data.
*/
VABufferID cu_record;
/** \brief distortion output of ENC or ENC_PAK.
* Each CTB has one distortion data with VAEncFEIDistortionHevc
* Buffer size shall not be less than the number of CTBs multiplied by
* sizeof(VAEncFEIDistortionHevc).
*/
VABufferID distortion;
/** \brief Qp input buffer. It is valid only when per_block_qp is set to 1.
* The data in this buffer correspond to the input source.
* One Qp per block block is in raster scan order, each Qp is a signed char (8-bit) value.
**/
VABufferID qp;
/** \brief MV predictor. It is valid only when mv_predictor_input is set to non-zero.
* Each CTB block has one or more pair of motion vectors and the corresponding
* reference indexes as defined by VAEncFEIMVPredictorHEVC. 32x32 block is in raster scan order.
* Buffer size shall not be less than the number of 16x16 blocks multiplied by
* sizeof(VAEncFEIMVPredictorHEVC). */
VABufferID mv_predictor;
/** \brief number of MV predictors L0 and L1. the maximum number of motion vector predictor for a 16x16, 32x32 or
* 64x64 block is four, it must not be greater than maximum supported MV predictor,
**/
uint32_t num_mv_predictors_l0 : 16;
uint32_t num_mv_predictors_l1 : 16;
/** \brief control parameters */
uint32_t search_path : 8;
uint32_t len_sp : 8;
uint32_t reserved0 : 16;
/** \brief multi pred l0/1
* 0000: no internal MV predictor will be used
* 0001: spatial MV predictors
* 0100/1000: Reserved
**/
uint32_t multi_pred_l0 : 4;
uint32_t multi_pred_l1 : 4;
/** \brief defines the motion vector precision, like integer/half/quarter pel.
* 00b: integer pel
* 01b: half-pel
* 10b: reserved
* 11b: quarter-pel
*/
uint32_t sub_pel_mode : 2;
uint32_t adaptive_search : 1;
/** \brief mv_predictor_input
* 000: MV predictor disabled
* 001: MV predictor enabled per 16x16 block
* 010: MV predictor enabled per 32x32 block
* 011: MV predictor enabled per 64x64 block
* 111: MV predictor enabled, block size can vary and is determined by BlockSize in motion vector predictor buffer
* 100/101/110: Reserved
**/
uint32_t mv_predictor_input : 3;
/** \brief enables per CTB or CU qp */
uint32_t per_block_qp : 1;
/** \brief enables the per CTB input , if 1, need ctb_ctrl to be a real surface ID*/
uint32_t per_ctb_input : 1;
/** when this flag is set, extra distortion between current CTB and co-located CTB is provided.
* Extra distortion output has performance impact, set it only when it is needed */
uint32_t colocated_ctb_distortion : 1;
/** brief specifies whether this CTB should be forced to split to remove Inter big LCU: do not check Inter 32x32
* PUs. Every 32x32 LCU is split at least once. It can be used to improved performance.
* 0: ENC determined block type
* 1: Force to split
**/
uint32_t force_lcu_split : 1;
/** \brief enables CU64x64 check */
uint32_t enable_cu64_check : 1;
/** \brief enables CU64x64 asymmetric motion partition check */
uint32_t enable_cu64_amp_check : 1;
/** \brief specifies if check the 64x64 merge candidate
* 0: after skip check,
* 1: only skip check for 64x64
Default: 0. This field is used by LCU64 bi-directional.
**/
uint32_t cu64_skip_check_only : 1;
uint32_t reserved1 : 11;
/** specifies the search region width in pixels.
* When bidirectional search is enabled, this applies to both search regions */
uint32_t ref_width : 8;
/** specifies the reference region height in pixels. When bidirectional search is enabled,
* this applies to both search regions. */
uint32_t ref_height : 8;
/** \brief search window similar for AVC
* defines predefined search windows. If it is selected, RefWidth, RefHeight, LenSP and SearchPath are ignored.
* 0 : not use predefined search window
* 1 : Tiny – (4 SUs) 24x24 window diamond search
* 2 : Small – (9 SUs) 28x28 window diamond search
* 3 : Diamond – (16 SUs) 48x40 window diamond search
* 4 : Large Diamond – (32 SUs) 48x40 window diamond search
* 5 : Exhaustive – 48x40 window full search
* 6 : (64 SUs) 64x64 window full search
* Note: option 1, 2, 3 and 4 are valid only when CAP parameter SearchWindow64Support is 0.
* And option 6 is valid only when SearchWindow64Support is 1.*/
uint32_t search_window : 8;
/** \brief number of internal MV predictors for IME searches */
uint32_t max_num_ime_search_center : 3;
/** \brief fast intra prediction enabling bit. It is used as a trade-off between speed and quality.
* The flag will be ignored if it's unsupported in the driver*/
uint32_t fast_intra_mode : 1;
uint32_t reserved2 : 4;
/** \brief specifies number of splits that encoder could be run concurrently
* 1: level 1, default value
* 2: level 2
* 4: level 3
**/
uint32_t num_concurrent_enc_frame_partition : 8;
uint32_t reserved3 : 24;
/** \brief max frame size control with multi passes QP setting */
uint32_t max_frame_size;
/** \brief number of passes, every pass has different QP */
uint32_t num_passes;
/** \brief delta QP list for every pass */
uint8_t *delta_qp;
uint32_t reserved4[2];
} VAEncMiscParameterFEIFrameControlHEVC;
/** \brief Application can use this definition as reference to allocate the buffer
* based on MaxNumPredictor returned from attribute VAConfigAttribFEIMVPredictors query.
* this buffer allocation is always based on 16x16 block even block size is indicated as 32x32 or 64x64, and buffer
* layout is always in 32x32 block raster scan order even block size is 16x16 or 64x64. If 32x32 block size is set,
* only the data in the first 16x16 block (block 0) is used for 32x32 block. If 64x64 block size is set
* MV layout is still in 32x32 raster scan order, the same as 32x32 and the first 16x16
* block within each 32x32 block needs to have intended MV data (four 32x32 blocks will have the same MV data in the
* correspondent first 16x16 block). Data structure for each 16x16 block is defined as below (same as AVC except
* BlockSize/Reserved bits).
**/
typedef struct _VAEncFEIMVPredictorHEVC {
/** \brief Feference index corresponding to the entry of RefPicList0 & RefPicList1 in slice header (final reference
* list). Note that RefPicList0 & RefPicList1 needs to be the same for all slices.
* Ref0xIndex – RefPicList0; Ref1xIndex – RefPicList1; x – 0 ~ MaxNumPredictor */
struct {
uint8_t ref_idx_l0 : 4;
uint8_t ref_idx_l1 : 4;
} ref_idx[4]; /* index is predictor number */
/** \brief Valid only when MVPredictor is set to 011 for HEVC. Only valid in the first 16x16 block.
* 00: MV predictor disabled for this 32x32 block
* 01: MV predictor enabled per 16x16 block for this 32x32 block
* 10: MV predictor enabled per 32x32 block, the rest of 16x16 block data within this 32x32 block are ignored
* 11: Reserved */
uint32_t block_size : 2;
uint32_t reserved : 30;
VAMotionVector mv[4]; /* MaxNumPredictor is 4 */
} VAEncFEIMVPredictorHEVC; //40 bytes
/** \brief FEI CTB level control data structure */
typedef struct _VAEncFEICTBControlHEVC {
// DWORD 0
uint32_t force_to_intra : 1;
uint32_t force_to_inter : 1;
uint32_t force_to_skip : 1;
/** \brief force all coeff to zero */
uint32_t force_to_zero_coeff : 1;
uint32_t reserved0 : 28;
// DWORD 1
uint32_t reserved1;
// DWORD 2
uint32_t reserved2;
// DWORD 3
uint32_t reserved3;
} VAEncFEICTBControlHEVC;
/** \brief VAEncFEIDistortionHevc defines the data structure for VAEncFEIDistortionBufferType per CTB block.
* It is output buffer of ENC and ENC_PAK modes, The CTB block is in raster scan order.
* Buffer size shall not be less than the number of CTB blocks multiple by sizeof(VAEncFEIDistortionHevc).
**/
typedef struct _VAEncFEIDistortionHevc {
/** best CTB distortion */
uint32_t best_distortion;
/** only when colocated_ctb_distortion in VAEncMiscParameterFEIFrameControlHEVC is set */
uint32_t colocated_ctb_distortion;
} VAEncFEIDistortionHevc;
#ifdef __cplusplus
}
#endif
#endif