va_dec_av1.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019 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.
 */
 
#ifndef VA_DEC_AV1_H
#define VA_DEC_AV1_H
 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef union VAConfigAttribValDecAV1Features {
    struct {
        uint32_t lst_support     : 2;
        /* Reserved for future use. */
        uint32_t reserved        : 30;
    } bits;
    uint32_t value;
} VAConfigAttribValDecAV1Features;
 
typedef struct _VASegmentationStructAV1 {
    union {
        struct {
            uint32_t         enabled                                     : 1;
            uint32_t         update_map                                  : 1;
            uint32_t         temporal_update                             : 1;
            uint32_t         update_data                                 : 1;
 
            uint32_t         reserved                                    : 28;
        } bits;
        uint32_t             value;
    } segment_info_fields;
 
    int16_t                 feature_data[8][8];
 
    uint8_t                 feature_mask[8];
 
    uint32_t                va_reserved[VA_PADDING_LOW];
 
} VASegmentationStructAV1;
 
typedef struct _VAFilmGrainStructAV1 {
    union {
        struct {
            uint32_t        apply_grain                                 : 1;
            uint32_t        chroma_scaling_from_luma                    : 1;
            uint32_t        grain_scaling_minus_8                       : 2;
            uint32_t        ar_coeff_lag                                : 2;
            uint32_t        ar_coeff_shift_minus_6                      : 2;
            uint32_t        grain_scale_shift                           : 2;
            uint32_t        overlap_flag                                : 1;
            uint32_t        clip_to_restricted_range                    : 1;
            uint32_t        reserved                                    : 20;
        } bits;
        uint32_t            value;
    } film_grain_info_fields;
 
    uint16_t                grain_seed;
    /*  value range [0..14] */
    uint8_t                 num_y_points;
    uint8_t                 point_y_value[14];
    uint8_t                 point_y_scaling[14];
    /*  value range [0..10] */
    uint8_t                 num_cb_points;
    uint8_t                 point_cb_value[10];
    uint8_t                 point_cb_scaling[10];
    /*  value range [0..10] */
    uint8_t                 num_cr_points;
    uint8_t                 point_cr_value[10];
    uint8_t                 point_cr_scaling[10];
    /*  value range [-128..127] */
    int8_t                  ar_coeffs_y[24];
    int8_t                  ar_coeffs_cb[25];
    int8_t                  ar_coeffs_cr[25];
    uint8_t                 cb_mult;
    uint8_t                 cb_luma_mult;
    uint16_t                cb_offset;
    uint8_t                 cr_mult;
    uint8_t                 cr_luma_mult;
    uint16_t                cr_offset;
 
    uint32_t                va_reserved[VA_PADDING_LOW];
 
} VAFilmGrainStructAV1;
 
typedef enum {
    VAAV1TransformationIdentity           = 0,
    VAAV1TransformationTranslation        = 1,
    VAAV1TransformationRotzoom            = 2,
    VAAV1TransformationAffine             = 3,
    VAAV1TransformationCount
} VAAV1TransformationType;
 
typedef struct _VAWarpedMotionParamsAV1 {
 
    VAAV1TransformationType  wmtype;
 
    int32_t                 wmmat[8];
 
    /* valid or invalid on affine set */
    uint8_t  invalid;
 
    uint32_t                va_reserved[VA_PADDING_LOW];
 
} VAWarpedMotionParamsAV1;
 
typedef struct  _VADecPictureParameterBufferAV1 {
    uint8_t                 profile;
 
    uint8_t                 order_hint_bits_minus_1;
 
    uint8_t                 bit_depth_idx;
 
    uint8_t                 matrix_coefficients;
 
    union {
        struct {
            uint32_t        still_picture                               : 1;
            uint32_t        use_128x128_superblock                      : 1;
            uint32_t        enable_filter_intra                         : 1;
            uint32_t        enable_intra_edge_filter                    : 1;
 
            uint32_t        enable_interintra_compound                  : 1;
            uint32_t        enable_masked_compound                      : 1;
 
            uint32_t        enable_dual_filter                          : 1;
            uint32_t        enable_order_hint                           : 1;
            uint32_t        enable_jnt_comp                             : 1;
            uint32_t        enable_cdef                                 : 1;
            uint32_t        mono_chrome                                 : 1;
            uint32_t        color_range                                 : 1;
            uint32_t        subsampling_x                               : 1;
            uint32_t        subsampling_y                               : 1;
            va_deprecated uint32_t        chroma_sample_position        : 1;
            uint32_t        film_grain_params_present                   : 1;
            uint32_t        reserved                                    : 16;
        } fields;
        uint32_t value;
    } seq_info_fields;
 
    VASurfaceID             current_frame;
 
    VASurfaceID             current_display_picture;
 
    uint8_t                anchor_frames_num;
 
    VASurfaceID             *anchor_frames_list;
 
    uint16_t                frame_width_minus1;
    uint16_t                frame_height_minus1;
 
    uint16_t                output_frame_width_in_tiles_minus_1;
    uint16_t                output_frame_height_in_tiles_minus_1;
 
    VASurfaceID             ref_frame_map[8];
 
    uint8_t                 ref_frame_idx[7];
 
    uint8_t                 primary_ref_frame;
 
    uint8_t                 order_hint;
 
    VASegmentationStructAV1 seg_info;
    VAFilmGrainStructAV1    film_grain_info;
 
    uint8_t                 tile_cols;
    uint8_t                 tile_rows;
 
    /* The width/height of a tile minus 1 in units of superblocks. Though the
     * maximum number of tiles is 64, since ones of the last tile are computed
     * from ones of the other tiles and frame_width/height, they are not
     * necessarily specified.
     */
    uint16_t                width_in_sbs_minus_1[63];
    uint16_t                height_in_sbs_minus_1[63];
 
    uint16_t                tile_count_minus_1;
 
    /* specify the tile index for context updating */
    uint16_t                context_update_tile_id;
 
    union {
        struct {
            uint32_t        frame_type                                  : 2;
            uint32_t        show_frame                                  : 1;
            uint32_t        showable_frame                              : 1;
            uint32_t        error_resilient_mode                        : 1;
            uint32_t        disable_cdf_update                          : 1;
            uint32_t        allow_screen_content_tools                  : 1;
            uint32_t        force_integer_mv                            : 1;
            uint32_t        allow_intrabc                               : 1;
            uint32_t        use_superres                                : 1;
            uint32_t        allow_high_precision_mv                     : 1;
            uint32_t        is_motion_mode_switchable                   : 1;
            uint32_t        use_ref_frame_mvs                           : 1;
            /* disable_frame_end_update_cdf is coded as refresh_frame_context. */
            uint32_t        disable_frame_end_update_cdf                : 1;
            uint32_t        uniform_tile_spacing_flag                   : 1;
            uint32_t        allow_warped_motion                         : 1;
            uint32_t        large_scale_tile                            : 1;
 
            uint32_t        reserved                                    : 15;
        } bits;
        uint32_t            value;
    } pic_info_fields;
 
    uint8_t                 superres_scale_denominator;
 
    uint8_t                 interp_filter;
 
    uint8_t                 filter_level[2];
 
    uint8_t                 filter_level_u;
    uint8_t                 filter_level_v;
 
    union {
        struct {
            uint8_t         sharpness_level                             : 3;
            uint8_t         mode_ref_delta_enabled                      : 1;
            uint8_t         mode_ref_delta_update                       : 1;
 
            uint8_t         reserved                                    : 3;
        } bits;
        uint8_t             value;
    } loop_filter_info_fields;
 
    int8_t                  ref_deltas[8];
 
    int8_t                  mode_deltas[2];
 
    uint8_t                base_qindex;
    int8_t                  y_dc_delta_q;
    int8_t                  u_dc_delta_q;
    int8_t                  u_ac_delta_q;
    int8_t                  v_dc_delta_q;
    int8_t                  v_ac_delta_q;
 
    union {
        struct {
            uint16_t        using_qmatrix                               : 1;
            uint16_t        qm_y                                        : 4;
            uint16_t        qm_u                                        : 4;
            uint16_t        qm_v                                        : 4;
 
            uint16_t        reserved                                    : 3;
        } bits;
        uint16_t            value;
    } qmatrix_fields;
 
    union {
        struct {
            uint32_t        delta_q_present_flag                        : 1;
            uint32_t        log2_delta_q_res                            : 2;
 
            uint32_t        delta_lf_present_flag                       : 1;
            uint32_t        log2_delta_lf_res                           : 2;
 
            uint32_t        delta_lf_multi                              : 1;
 
            uint32_t        tx_mode                                     : 2;
 
            /* AV1 frame reference mode semantic */
            uint32_t        reference_select                            : 1;
 
            uint32_t        reduced_tx_set_used                         : 1;
 
            uint32_t        skip_mode_present                           : 1;
 
            uint32_t        reserved                                    : 20;
        } bits;
        uint32_t            value;
    } mode_control_fields;
 
    /*  value range [0..3]  */
    uint8_t                 cdef_damping_minus_3;
    /*  value range [0..3]  */
    uint8_t                 cdef_bits;
 
    /*  value range [0..63]  */
    uint8_t                 cdef_y_strengths[8];
    /*  value range [0..63]  */
    uint8_t                 cdef_uv_strengths[8];
 
    union {
        struct {
            uint16_t        yframe_restoration_type                     : 2;
            uint16_t        cbframe_restoration_type                    : 2;
            uint16_t        crframe_restoration_type                    : 2;
            uint16_t        lr_unit_shift                               : 2;
            uint16_t        lr_uv_shift                                 : 1;
 
            uint16_t        reserved                                    : 7;
        } bits;
        uint16_t            value;
    } loop_restoration_fields;
 
    VAWarpedMotionParamsAV1 wm[7];
 
    uint32_t                va_reserved[VA_PADDING_MEDIUM];
} VADecPictureParameterBufferAV1;
 
 
typedef struct _VASliceParameterBufferAV1 {
    uint32_t                slice_data_size;
    uint32_t                slice_data_offset;
    uint32_t                slice_data_flag;
 
    uint16_t                tile_row;
    uint16_t                tile_column;
 
    va_deprecated uint16_t  tg_start;
    va_deprecated uint16_t  tg_end;
    uint8_t                 anchor_frame_idx;
 
    uint16_t                tile_idx_in_tile_list;
 
    uint32_t                va_reserved[VA_PADDING_LOW];
} VASliceParameterBufferAV1;
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* VA_DEC_AV1_H */