VA-API  2.22.0
Public Attributes | List of all members
VADecPictureParameterBufferAV1 Struct Reference

AV1 Decoding Picture Parameter Buffer Structure. More...

#include <va_dec_av1.h>

Public Attributes

uint8_t profile
 sequence level information More...
 
uint8_t bit_depth_idx
 bit depth index value range [0..2] 0 - bit depth 8; 1 - bit depth 10; 2 - bit depth 12;
 
uint8_t matrix_coefficients
 corresponds to AV1 spec variable of the same name.
 
VASurfaceID current_frame
 Picture level information. More...
 
VASurfaceID current_display_picture
 display buffer of current picture Used for film grain applied decoded picture. Valid only when apply_grain equals 1.
 
uint8_t anchor_frames_num
 number of anchor frames for large scale tile This parameter gives the number of entries of anchor_frames_list[]. Value range [0..128].
 
VASurfaceID * anchor_frames_list
 anchor frame list for large scale tile For large scale tile applications, the anchor frames could come from previously decoded frames in current sequence (aka. internal), or from external sources. For external anchor frames, application should call API vaCreateBuffer() to generate frame buffers and populate them with pixel frames. And this process may happen multiple times. The array anchor_frames_list[] is used to register all the available anchor frames from both external and internal, up to the current frame instance. If a previously registerred anchor frame is no longer needed, it should be removed from the list. But it does not prevent applications from relacing the frame buffer with new anchor frames. Please note that the internal anchor frames may not still be present in the current DPB buffer. But if it is in the anchor_frames_list[], it should not be replaced with other frames or removed from memory until it is not shown in the list. This number of entries of the list is given by parameter anchor_frames_num.
 
uint16_t frame_width_minus1
 Picture resolution minus 1 Picture original resolution. If SuperRes is enabled, this is the upscaled resolution. value range [0..65535].
 
uint16_t output_frame_width_in_tiles_minus_1
 Output frame buffer size in unit of tiles Valid only when large_scale_tile equals 1. value range [0..65535].
 
VASurfaceID ref_frame_map [8]
 Surface indices of reference frames in DPB. More...
 
uint8_t ref_frame_idx [7]
 Reference frame indices. More...
 
uint8_t primary_ref_frame
 primary reference frame index Index into ref_frame_idx[], specifying which reference frame contains propagated info that should be loaded at the start of the frame. When value equals PRIMARY_REF_NONE (7), it indicates there is no primary reference frame. value range [0..7]
 
uint8_t tile_cols
 tile structure When uniform_tile_spacing_flag == 1, width_in_sbs_minus_1[] and height_in_sbs_minus_1[] should be ignored, which will be generated by driver based on tile_cols and tile_rows.
 
uint16_t tile_count_minus_1
 number of tiles minus 1 in large scale tile list Same as AV1 semantic element. Valid only when large_scale_tiles == 1.
 
uint8_t superres_scale_denominator
 Supper resolution scale denominator. When use_superres=1, superres_scale_denominator must be in the range [9..16]. When use_superres=0, superres_scale_denominator must be 8.
 
uint8_t interp_filter
 Interpolation filter. value range [0..4].
 
uint8_t filter_level [2]
 luma loop filter levels. value range [0..63].
 
uint8_t filter_level_u
 chroma loop filter levels. value range [0..63].
 
int8_t ref_deltas [8]
 The adjustment needed for the filter level based on the chosen reference frame. value range [-64..63].
 
int8_t mode_deltas [2]
 The adjustment needed for the filter level based on the chosen mode. value range [-64..63].
 
uint8_t base_qindex
 quantization More...
 
int8_t y_dc_delta_q
 Y DC delta from Y AC value range [-64..63].
 
int8_t u_dc_delta_q
 U DC delta from Y AC value range [-64..63].
 
int8_t u_ac_delta_q
 U AC delta from Y AC value range [-64..63].
 
int8_t v_dc_delta_q
 V DC delta from Y AC value range [-64..63].
 
int8_t v_ac_delta_q
 V AC delta from Y AC value range [-64..63].
 
union {
qmatrix_fields
 quantization_matrix
 
uint8_t cdef_damping_minus_3
 CDEF parameters.
 
uint8_t cdef_y_strengths [8]
 
union {
loop_restoration_fields
 loop restoration parameters
 
VAWarpedMotionParamsAV1 wm [7]
 global motion
 
uint32_t va_reserved [VA_PADDING_MEDIUM]
 Reserved bytes for future use, must be zero.
 
uint32_t enable_interintra_compound: 1
 
uint32_t reserved: 16
 Reserved bytes for future use, must be zero.
 
uint32_t frame_type: 2
 flags for current picture same syntax and semantic as those in AV1 code More...
 
uint32_t large_scale_tile: 1
 indicate if current frame in large scale tile mode
 
uint8_t sharpness_level: 3
 flags for reference pictures same syntax and semantic as those in AV1 code
 
uint8_t reserved: 3
 Reserved bytes for future use, must be zero.
 
uint16_t qm_y: 4
 qm level value range [0..15] Invalid if using_qmatrix equals 0.
 
uint16_t reserved: 3
 Reserved bytes for future use, must be zero.
 
uint32_t delta_q_present_flag: 1
 delta_q parameters
 
uint32_t delta_lf_present_flag: 1
 delta_lf parameters
 
uint32_t delta_lf_multi: 1
 CONFIG_LOOPFILTER_LEVEL.
 
uint32_t tx_mode: 2
 read_tx_mode value range [0..2]
 

Detailed Description

AV1 Decoding Picture Parameter Buffer Structure.

This structure conveys picture level parameters and should be sent once per frame.

Member Data Documentation

◆ enable_interintra_compound

uint32_t VADecPictureParameterBufferAV1::enable_interintra_compound

read_compound_tools

◆ frame_type

uint32_t VADecPictureParameterBufferAV1::frame_type

flags for current picture same syntax and semantic as those in AV1 code

Frame Type 0: KEY_FRAME; 1: INTER_FRAME; 2: INTRA_ONLY_FRAME; 3: SWITCH_FRAME For SWITCH_FRAME, application shall set error_resilient_mode = 1, refresh_frame_flags, etc. appropriately. And driver will convert it to INTER_FRAME.


The documentation for this struct was generated from the following file: