/usr/include/va/va_fei_h264.h is in libva-dev 2.1.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 | /*
* 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_h264.h
* \brief The FEI encoding H264 special API
*/
#ifndef VA_FEI_H264_H
#define VA_FEI_H264_H
#ifdef __cplusplus
extern "C" {
#endif
#include <stdint.h>
#include "va_fei.h"
/**
* \defgroup api_fei_h264 H.264 FEI encoding API
*
* @{
*/
/** \brief FEI frame level control buffer for H.264 */
typedef struct _VAEncMiscParameterFEIFrameControlH264
{
uint32_t function; /* one of the VAConfigAttribFEIFunctionType values */
/** \brief MB (16x16) control input buffer. It is valid only when (mb_input | mb_size_ctrl)
* is set to 1. The data in this buffer correspond to the input source. 16x16 MB is in raster scan order,
* each MB control data structure is defined by VAEncFEIMBControlH264.
* Buffer size shall not be less than the number of 16x16 blocks multiplied by
* sizeof(VAEncFEIMBControlH264).
* Note: if mb_qp is set, VAEncQPBufferH264 is expected.
*/
VABufferID mb_ctrl;
/** \brief distortion output of MB ENC or ENC_PAK.
* Each 16x16 block has one distortion data with VAEncFEIDistortionH264 layout
* Buffer size shall not be less than the number of 16x16 blocks multiplied by
* sizeof(VAEncFEIDistortionH264).
*/
VABufferID distortion;
/** \brief MVs data output of MB ENC.
* Each 16x16 block has one MVs data with layout VAMotionVector
* Buffer size shall not be less than the number of 16x16 blocks multiplied by
* sizeof(VAMotionVector) * 16.
*/
VABufferID mv_data;
/** \brief MBCode data output of MB ENC.
* Each 16x16 block has one MB Code data with layout VAEncFEIMBCodeH264
* Buffer size shall not be less than the number of 16x16 blocks multiplied by
* sizeof(VAEncFEIMBCodeH264).
*/
VABufferID mb_code_data;
/** \brief QP input buffer with layout VAEncQPBufferH264. It is valid only when mb_qp is set to 1.
* The data in this buffer correspond to the input source.
* One QP per 16x16 block 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_enable is set to 1.
* Each 16x16 block has one or more pair of motion vectors and the corresponding
* reference indexes as defined by VAEncFEIMVPredictorH264. 16x16 block is in raster scan order.
* Buffer size shall not be less than the number of 16x16 blocks multiplied by
* sizeof(VAEncFEIMVPredictorH264). */
VABufferID mv_predictor;
/** \brief number of MV predictors. 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 motion search method definition
* 0: default value, diamond search
* 1: full search
* 2: diamond search
**/
uint32_t search_path : 8;
/** \brief maximum number of Search Units, valid range is [1, 63]
* 0 is treated as 1. reference search locations are grouped in a predefined pattern,
* and all locations within the same group must be either all are chosen or all are skipped.
* These predefined groups are called search unit (SU).*/
uint32_t len_sp : 8;
uint32_t reserved0 : 16;
/** \brief defines the bit-mask for disabling sub-partition
* The lower 4 bits are for the major partitions (sub-macroblock) and the higher 3 bits for minor partitions (with sub-partition for 4x(8x8) sub-macroblocks.
* xxxxxx1 : 16x16 sub-macroblock disabled
* xxxxx1x : 2x(16x8) sub-macroblock within 16x16 disabled
* xxxx1xx : 2x(8x16) sub-macroblock within 16x16 disabled
* xxx1xxx : 1x(8x8) sub-partition for 4x(8x8) within 16x16 disabled
* xx1xxxx : 2x(8x4) sub-partition for 4x(8x8) within 16x16 disabled
* x1xxxxx : 2x(4x8) sub-partition for 4x(8x8) within 16x16 disabled
* 1xxxxxx : 4x(4x4) sub-partition for 4x(8x8) within 16x16 disabled
* 1111111 : Invalid
* 0000000 : default value */
uint32_t sub_mb_part_mask : 7;
/** specifies which Luma Intra partition is enabled/disabled for intra mode decision.
* xxxx1: luma_intra_16x16 disabled
* xxx1x: luma_intra_8x8 disabled
* xx1xx: luma_intra_4x4 disabled
* xx111: intra prediction is disabled */
uint32_t intra_part_mask : 5;
/** when set to 1, neighbor MV will be used as predictor; when set to 0, no neighbor MV will be used as predictor.*/
uint32_t multi_pred_l0 : 1;
/** when set to 1, neighbor MV will be used as predictor; when set to 0, no neighbor MV will be used as predictor.*/
uint32_t multi_pred_l1 : 1;
/**defines the half/quarter pel modes. The mode is inclusive, ie., higher precision mode samples lower precision locations.
* 00b: integer mode searching
* 01b: half-pel mode searching
* 10b: reserved
* 11b: quarter-pel mode searching */
uint32_t sub_pel_mode : 2;
/** specifies distortion measure adjustments used for the inter motion search SAD comparison.
* 00b: none
* 10b: Haar transform adjusted*/
uint32_t inter_sad : 2;
/** specifies distortion measure adjustments used for the intra motion search SAD comparison.
* 00b: none
* 10b: Haar transform adjusted*/
uint32_t intra_sad : 2;
/** specifies if the output distortion is the raw distortion or cost adjusted distortion.
* 0: Raw Distortion without Cost
* 1: Distortion with added Cost */
uint32_t distortion_type : 1;
/** when set to 1, enables the additional calls on Fraction & Bidirectional Refinement*/
uint32_t repartition_check_enable : 1;
/** defines whether adaptive searching is enabled for IME(Integer Motion Estimation).
* 0: disable
* 1: enable */
uint32_t adaptive_search : 1;
/** enables using the motion vector as an extra predictor provided by the host. If it is set,
* host needs to provide a buffer with motion vectors and the associated reference index for
* each 16x16 block as defined . The host can call processing function to get motion vectors and use as predictor.
* 0: MV predictor disabled
* 1: MV predictor enabled */
uint32_t mv_predictor_enable : 1;
/** enables using the QP buffer to set the QP for each block*/
uint32_t mb_qp : 1;
/** enable mb_ctrl buffer to handle MB*/
uint32_t mb_input : 1;
/** when this flag is set, mb_ctrl must be set too and a buffer with per MB input
* needs to be provided and MaxSizeInWord and */
uint32_t mb_size_ctrl : 1;
/** when this flag is set, extra distortion between the current MB and co-located MB is provided.
* Extra distortion output has performance impact, set it only when it is needed.*/
uint32_t colocated_mb_distortion : 1;
uint32_t reserved1 : 4;
/** \brief motion search window(ref_width * ref_height) */
uint32_t ref_width : 8;
uint32_t ref_height : 8;
/** \brief predefined motion search windows. If selected, len_sp, window(ref_width * ref_eight)
* and search_path setting are ignored.
* 0: not use predefined search window
* 1: Tiny, len_sp=4, 24x24 window and diamond search
* 2: Small, len_sp=9, 28x28 window and diamond search
* 3: Diamond, len_sp=16, 48x40 window and diamond search
* 4: Large Diamond, len_sp=32, 48x40 window and diamond search
* 5: Exhaustive, len_sp=48, 48x40 window and full search
* 6: Extend Diamond, len_sp=16, 64x40 window and diamond search
* 7: Extend Large Diamond, len_sp=32, 64x40 window and diamond search
* 8: Extend Exhaustive, len_sp=48, 64x40 window and full search
**/
uint32_t search_window : 4;
uint32_t reserved2 : 12;
/** \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 reserved3[VA_PADDING_LOW];
} VAEncMiscParameterFEIFrameControlH264;
/** \brief FEI MB level control data structure */
typedef struct _VAEncFEIMBControlH264
{
/** \brief when set, correposndent MB is coded as intra */
uint32_t force_to_intra : 1;
/** \brief when set, correposndent MB is coded as skip */
uint32_t force_to_skip : 1;
/** \brief specifies whether this macroblock should be coded as a non-skipped macroblock. */
uint32_t force_to_nonskip : 1;
uint32_t enable_direct_bias_adjustment : 1;
uint32_t enable_motion_bias_adjustment : 1;
uint32_t ext_mv_cost_scaling_factor : 3;
uint32_t reserved0 : 24;
uint32_t reserved1;
uint32_t reserved2;
uint32_t reserved3 : 16;
/** \brief when mb_size_ctrl is set, size here is used to budget accumulatively. Set to 0xFF if don't care. */
uint32_t target_size_in_word : 8;
/** \brief specifies the max size of each MB */
uint32_t max_size_in_word : 8;
} VAEncFEIMBControlH264;
/** \brief Application can use this definition as reference to allocate the buffer
* based on MaxNumPredictor returned from attribute VAConfigAttribFEIMVPredictors query.
**/
typedef struct _VAEncFEIMVPredictorH264
{
/** \brief Reference index corresponding to the entry of RefPicList0 & RefPicList1 in VAEncSliceParameterBufferH264.
* Note that RefPicList0 & RefPicList1 needs to be the same for all slices.
* ref_idx_l0_x : index to RefPicList0; ref_idx_l1_x : index to RefPicList1; x : 0 - MaxNumPredictor.
**/
struct {
uint8_t ref_idx_l0 : 4;
uint8_t ref_idx_l1 : 4;
} ref_idx[4]; /* index is predictor number */
uint32_t reserved;
/** \brief MV. MaxNumPredictor must be the returned value from attribute VAConfigAttribFEIMVPredictors query.
* Even application doesn't use the maximum predictors, the VAFEIMVPredictorH264 structure size
* has to be defined as maximum so each MB can be at a fixed location.
* Note that 0x8000 must be used for correspondent intra block.
**/
VAMotionVector mv[4]; /* MaxNumPredictor is 4 */
} VAEncFEIMVPredictorH264;
/** \brief FEI output */
/**
* Motion vector output is per 4x4 block. For each 4x4 block there is a pair of MVs
* for RefPicList0 and RefPicList1 and each MV is 4 bytes including horizontal and vertical directions.
* Depending on Subblock partition, for the shape that is not 4x4, the MV is replicated
* so each 4x4 block has a pair of MVs. The 16x16 block has 32 MVs (128 bytes).
* 0x8000 is used for correspondent intra block. The 16x16 block is in raster scan order,
* within the 16x16 block, each 4x4 block MV is ordered as below in memory.
* The buffer size shall be greater than or equal to the number of 16x16 blocks multiplied by 128 bytes.
* Note that, when separate ENC and PAK is enabled, the exact layout of this buffer is needed for PAK input.
* App can reuse this buffer, or copy to a different buffer as PAK input.
* Layout is defined as Generic motion vector data structure VAMotionVector
* 16x16 Block
* -----------------------------------------
* | 1 | 2 | 5 | 6 |
* -----------------------------------------
* | 3 | 4 | 7 | 8 |
* -----------------------------------------
* | 9 | 10 | 13 | 14 |
* -----------------------------------------
* | 11 | 12 | 15 | 16 |
* -----------------------------------------
**/
/** \brief VAEncFEIMBCodeH264 defines the data structure for VAEncFEIMBCodeBufferType per 16x16 MB block.
* it is output buffer of ENC and ENC_PAK modes, it's also input buffer of PAK mode.
* The 16x16 block is in raster scan order. Buffer size shall not be less than the number of 16x16 blocks
* multiplied by sizeof(VAEncFEIMBCodeH264). Note that, when separate ENC and PAK is enabled,
* the exact layout of this buffer is needed for PAK input. App can reuse this buffer,
* or copy to a different buffer as PAK input, reserved elements must not be modified when used as PAK input.
**/
typedef struct _VAEncFEIMBCodeH264
{
//DWORD 0~2
uint32_t reserved0[3];
//DWORD 3
uint32_t inter_mb_mode : 2;
uint32_t mb_skip_flag : 1;
uint32_t reserved1 : 1;
uint32_t intra_mb_mode : 2;
uint32_t reserved2 : 1;
uint32_t field_mb_polarity_flag : 1;
uint32_t mb_type : 5;
uint32_t intra_mb_flag : 1;
uint32_t field_mb_flag : 1;
uint32_t transform8x8_flag : 1;
uint32_t reserved3 : 1;
uint32_t dc_block_coded_cr_flag : 1;
uint32_t dc_block_coded_cb_flag : 1;
uint32_t dc_block_coded_y_flag : 1;
uint32_t reserved4 : 12;
//DWORD 4
uint32_t horz_origin : 8;
uint32_t vert_origin : 8;
uint32_t cbp_y : 16;
//DWORD 5
uint32_t cbp_cb : 16;
uint32_t cbp_cr : 16;
//DWORD 6
uint32_t qp_prime_y : 8;
uint32_t reserved5 : 17;
uint32_t mb_skip_conv_disable : 1;
uint32_t is_last_mb : 1;
uint32_t enable_coefficient_clamp : 1;
uint32_t direct8x8_pattern : 4;
//DWORD 7 8 and 9
union
{
/* Intra MBs */
struct
{
uint32_t luma_intra_pred_modes0 : 16;
uint32_t luma_intra_pred_modes1 : 16;
uint32_t luma_intra_pred_modes2 : 16;
uint32_t luma_intra_pred_modes3 : 16;
uint32_t chroma_intra_pred_mode : 2;
uint32_t intra_pred_avail_flag : 5;
uint32_t intra_pred_avail_flagF : 1;
uint32_t reserved6 : 24;
} intra_mb;
/* Inter MBs */
struct
{
uint32_t sub_mb_shapes : 8;
uint32_t sub_mb_pred_modes : 8;
uint32_t reserved7 : 16;
uint32_t ref_idx_l0_0 : 8;
uint32_t ref_idx_l0_1 : 8;
uint32_t ref_idx_l0_2 : 8;
uint32_t ref_idx_l0_3 : 8;
uint32_t ref_idx_l1_0 : 8;
uint32_t ref_idx_l1_1 : 8;
uint32_t ref_idx_l1_2 : 8;
uint32_t ref_idx_l1_3 : 8;
} inter_mb;
} mb_mode;
//DWORD 10
uint32_t reserved8 : 16;
uint32_t target_size_in_word : 8;
uint32_t max_size_in_word : 8;
//DWORD 11~14
uint32_t reserved9[4];
//DWORD 15
uint32_t reserved10;
} VAEncFEIMBCodeH264; // 64 bytes
/** \brief VAEncFEIDistortionH264 defines the data structure for VAEncFEIDistortionBufferType per 16x16 MB block.
* It is output buffer of ENC and ENC_PAK modes, The 16x16 block is in raster scan order.
* Buffer size shall not be less than the number of 16x16 blocks multiple by sizeof(VAEncFEIDistortionH264).
**/
typedef struct _VAEncFEIDistortionH264 {
/** \brief Inter-prediction-distortion associated with motion vector i (co-located with subblock_4x4_i).
* Its meaning is determined by sub-shape. It must be zero if the corresponding sub-shape is not chosen.
**/
uint16_t inter_distortion[16];
uint32_t best_inter_distortion : 16;
uint32_t best_intra_distortion : 16;
uint32_t colocated_mb_distortion : 16;
uint32_t reserved0 : 16;
uint32_t reserved1[2];
} VAEncFEIDistortionH264; // 48 bytes
/** \brief Motion Vector and Statistics frame level controls.
* VAStatsStatisticsParameterBufferType for H264 16x16 block
**/
typedef struct _VAStatsStatisticsParameterH264
{
VAStatsStatisticsParameter stats_params;
uint32_t frame_qp : 8;
/** \brief length of search path */
uint32_t len_sp : 8;
/** \brief motion search method definition
* 0: default value, diamond search
* 1: full search
* 2: diamond search
**/
uint32_t search_path : 8;
uint32_t reserved0 : 8;
uint32_t sub_mb_part_mask : 7;
/** \brief sub pixel mode definition
* 00b: integer mode searching
* 01b: half-pel mode searching
* 10b: reserved
* 11b: quarter-pel mode searching
**/
uint32_t sub_pel_mode : 2;
/** \brief distortion measure adjustment for inter search SAD comparison
* 00b: none
* 01b: reserved
* 10b: Haar transform adjusted
* 11b: reserved
**/
uint32_t inter_sad : 2;
/** \brief distortion measure adjustment for intra search SAD comparison
* 00b: none
* 01b: reserved
* 10b: Haar transform adjusted
* 11b: reserved
**/
uint32_t intra_sad : 2;
uint32_t adaptive_search : 1;
/** \brief indicate if future or/and past MV in mv_predictor buffer is valid.
* 0: MV predictor disabled
* 1: MV predictor enabled for past reference
* 2: MV predictor enabled for future reference
* 3: MV predictor enabled for both past and future references
**/
uint32_t mv_predictor_ctrl : 3;
uint32_t mb_qp : 1;
/** \brief forward transform enable
* 0: disable
* 1: enable, needs frame_qp or mb_qp input for transform
**/
uint32_t ft_enable : 1;
/** \brief luma intra mode partition mask
* xxxx1: luma_intra_16x16 disabled
* xxx1x: luma_intra_8x8 disabled
* xx1xx: luma_intra_4x4 disabled
* xx111: intra prediction is disabled
**/
uint32_t intra_part_mask : 5;
uint32_t reserved1 : 8;
/** \brief motion search window(ref_width * ref_height) */
uint32_t ref_width : 8;
uint32_t ref_height : 8;
/** \brief predefined motion search windows. If selected, len_sp, window(ref_width * ref_eight)
* and search_path setting are ignored.
* 0: not use predefined search window
* 1: Tiny, len_sp=4, 24x24 window and diamond search
* 2: Small, len_sp=9, 28x28 window and diamond search
* 3: Diamond, len_sp=16, 48x40 window and diamond search
* 4: Large Diamond, len_sp=32, 48x40 window and diamond search
* 5: Exhaustive, len_sp=48, 48x40 window and full search
* 6: Extend Diamond, len_sp=16, 64x40 window and diamond search
* 7: Extend Large Diamond, len_sp=32, 64x40 window and diamond search
* 8: Extend Exhaustive, len_sp=48, 64x40 window and full search
**/
uint32_t search_window : 4;
uint32_t reserved2 : 12;
/** \brief MVOutput. When set to 1, MV output is NOT provided */
uint32_t disable_mv_output : 1;
/** \brief StatisticsOutput. When set to 1, Statistics output is NOT provided. */
uint32_t disable_statistics_output : 1;
/** \brief block 8x8 data enabling in statistics output */
uint32_t enable_8x8_statistics : 1;
uint32_t reserved3 : 29;
uint32_t reserved4[2];
} VAStatsStatisticsParameterH264;
/** \brief VAStatsStatisticsH264. H264 Statistics buffer layout for VAStatsStatisticsBufferType
* and VAStatsStatisticsBottomFieldBufferType(for interlaced only).
* Statistics output is per 16x16 block. Data structure per 16x16 block is defined below.
* The 16x16 block is in raster scan order. The buffer size shall be greater than or equal to
* the number of 16x16 blocks multiplied by sizeof(VAStatsStatisticsH264).
**/
typedef struct _VAStatsStatisticsH264
{
/** \brief past reference */
uint32_t best_inter_distortion0 : 16;
uint32_t inter_mode0 : 16;
/** \brief future reference */
uint32_t best_inter_distortion1 : 16;
uint32_t inter_mode1 : 16;
uint32_t best_intra_distortion : 16;
uint32_t intra_mode : 16;
uint32_t num_non_zero_coef : 16;
uint32_t reserved0 : 16;
uint32_t sum_coef;
/** \brief DWORD 5 flat info **/
uint32_t mb_is_flat : 1;
uint32_t reserved1 : 31;
/** \brief DWORD 6 variance for block16x16**/
uint32_t variance_16x16;
/** \brief DWORD 7 ~ 10, variance for block8x8 **/
uint32_t variance_8x8[4];
/** \brief DWORD 11 pixel_average for block16x16 **/
uint32_t pixel_average_16x16;
/** \brief DWORD 12 ~ 15, pixel_average for block8x8 **/
uint32_t pixel_average_8x8[4];
} VAStatsStatisticsH264; // 64 bytes
#ifdef __cplusplus
}
#endif
#endif /* VA_FEI_H264_H */
|