va_enc_h264.h

Go to the documentation of this file.

/*
 * Copyright (c) 2007-2011 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_ENC_H264_H
#define VA_ENC_H264_H

#ifdef __cplusplus
extern "C" {
#endif

#define H264_LAST_PICTURE_EOSEQ     0x01

#define H264_LAST_PICTURE_EOSTREAM  0x02

typedef enum {
    VAEncPackedHeaderH264_SPS   = VAEncPackedHeaderSequence,
    VAEncPackedHeaderH264_PPS   = VAEncPackedHeaderPicture,
    VAEncPackedHeaderH264_Slice = VAEncPackedHeaderSlice,
    VAEncPackedHeaderH264_SEI va_deprecated_enum  = (0x80000000 | 1),
} VAEncPackedHeaderTypeH264;

typedef struct _VAEncSequenceParameterBufferH264 {
    uint8_t   seq_parameter_set_id;
    uint8_t   level_idc;
    uint32_t    intra_period;
    uint32_t    intra_idr_period;
    uint32_t    ip_period;
    uint32_t    bits_per_second;
    uint32_t    max_num_ref_frames;
    uint16_t  picture_width_in_mbs;
    uint16_t  picture_height_in_mbs;

    union {
        struct {
            uint32_t chroma_format_idc                      : 2;
            uint32_t frame_mbs_only_flag                    : 1;
            uint32_t mb_adaptive_frame_field_flag           : 1;
            uint32_t seq_scaling_matrix_present_flag        : 1;
            uint32_t direct_8x8_inference_flag              : 1;
            uint32_t log2_max_frame_num_minus4              : 4;
            uint32_t pic_order_cnt_type                     : 2;
            uint32_t log2_max_pic_order_cnt_lsb_minus4      : 4;
            uint32_t delta_pic_order_always_zero_flag       : 1;
        } bits;
        uint32_t value;
    } seq_fields;

    uint8_t   bit_depth_luma_minus8;
    uint8_t   bit_depth_chroma_minus8;

    uint8_t   num_ref_frames_in_pic_order_cnt_cycle;
    int32_t             offset_for_non_ref_pic;
    int32_t             offset_for_top_to_bottom_field;
    int32_t             offset_for_ref_frame[256];
    uint8_t   frame_cropping_flag;
    uint32_t    frame_crop_left_offset;
    uint32_t    frame_crop_right_offset;
    uint32_t    frame_crop_top_offset;
    uint32_t    frame_crop_bottom_offset;
    uint8_t   vui_parameters_present_flag;
    union {
        struct {
            uint32_t aspect_ratio_info_present_flag         : 1;
            uint32_t timing_info_present_flag               : 1;
            uint32_t bitstream_restriction_flag             : 1;
            uint32_t log2_max_mv_length_horizontal          : 5;
            uint32_t log2_max_mv_length_vertical            : 5;
            uint32_t fixed_frame_rate_flag                  : 1;
            uint32_t low_delay_hrd_flag                     : 1;
            uint32_t motion_vectors_over_pic_boundaries_flag: 1;
            uint32_t reserved                               : 16;
        } bits;
        uint32_t value;
    } vui_fields;
    uint8_t   aspect_ratio_idc;
    uint32_t    sar_width;
    uint32_t    sar_height;
    uint32_t    num_units_in_tick;
    uint32_t    time_scale;

    uint32_t                va_reserved[VA_PADDING_LOW];
} VAEncSequenceParameterBufferH264;

typedef struct _VAEncPictureParameterBufferH264 {
    VAPictureH264   CurrPic;
    VAPictureH264   ReferenceFrames[16];
    VABufferID      coded_buf;

    uint8_t   pic_parameter_set_id;
    uint8_t   seq_parameter_set_id;

    uint8_t   last_picture;

    uint16_t  frame_num;

    uint8_t   pic_init_qp;
    uint8_t   num_ref_idx_l0_active_minus1;
    uint8_t   num_ref_idx_l1_active_minus1;

    int8_t     chroma_qp_index_offset;
    int8_t     second_chroma_qp_index_offset;

    union {
        struct {
            uint32_t idr_pic_flag                           : 1;
            uint32_t reference_pic_flag                     : 2;
            uint32_t entropy_coding_mode_flag               : 1;
            uint32_t weighted_pred_flag                     : 1;
            uint32_t weighted_bipred_idc                    : 2;
            uint32_t constrained_intra_pred_flag            : 1;
            uint32_t transform_8x8_mode_flag                : 1;
            uint32_t deblocking_filter_control_present_flag : 1;
            uint32_t redundant_pic_cnt_present_flag         : 1;
            uint32_t pic_order_present_flag                 : 1;
            uint32_t pic_scaling_matrix_present_flag        : 1;
        } bits;
        uint32_t value;
    } pic_fields;

    uint32_t                va_reserved[VA_PADDING_LOW];
} VAEncPictureParameterBufferH264;

typedef struct _VAEncQPBufferH264 {
    /*
     * \brief This structure holds QP per 16x16 macroblock. Buffer size shall be
     * sufficient to fit the slice or frame to be encoded depending on if it is a
     * slice level or frame level encoding.
     */
    uint8_t qp;
} VAEncQPBufferH264;

typedef struct _VAEncSliceParameterBufferH264 {
    uint32_t    macroblock_address;
    uint32_t    num_macroblocks;
    VABufferID      macroblock_info;
    uint8_t   slice_type;
    uint8_t   pic_parameter_set_id;
    uint16_t  idr_pic_id;

    uint16_t  pic_order_cnt_lsb;
    int32_t             delta_pic_order_cnt_bottom;
    int32_t             delta_pic_order_cnt[2];
    uint8_t   direct_spatial_mv_pred_flag;
    uint8_t   num_ref_idx_active_override_flag;
    uint8_t   num_ref_idx_l0_active_minus1;
    uint8_t   num_ref_idx_l1_active_minus1;
    VAPictureH264   RefPicList0[32];
    VAPictureH264   RefPicList1[32];
    uint8_t   luma_log2_weight_denom;
    uint8_t   chroma_log2_weight_denom;
    uint8_t   luma_weight_l0_flag;
    signed short    luma_weight_l0[32];
    signed short    luma_offset_l0[32];
    uint8_t   chroma_weight_l0_flag;
    signed short    chroma_weight_l0[32][2];
    signed short    chroma_offset_l0[32][2];
    uint8_t   luma_weight_l1_flag;
    signed short    luma_weight_l1[32];
    signed short    luma_offset_l1[32];
    uint8_t   chroma_weight_l1_flag;
    signed short    chroma_weight_l1[32][2];
    signed short    chroma_offset_l1[32][2];
    uint8_t   cabac_init_idc;
    int8_t     slice_qp_delta;
    uint8_t   disable_deblocking_filter_idc;
    int8_t     slice_alpha_c0_offset_div2;
    int8_t     slice_beta_offset_div2;

    uint32_t                va_reserved[VA_PADDING_LOW];
} VAEncSliceParameterBufferH264;

#define VA_MB_PRED_AVAIL_TOP_LEFT         (1 << 2)

#define VA_MB_PRED_AVAIL_TOP              (1 << 4)

#define VA_MB_PRED_AVAIL_TOP_RIGHT        (1 << 3)

#define VA_MB_PRED_AVAIL_LEFT             (1 << 6)

typedef struct _VAEncMacroblockParameterBufferH264 {
    uint8_t   qp;

    union {
        union {
            struct {
                uint32_t    pred_avail_override_flag        : 1;
                uint32_t    pred_avail_flags                : 8;
            } bits;
            uint32_t value;
        } intra_fields;
        union {
            struct {
                uint32_t reserved;
            } bits;
            uint32_t value;
        } inter_fields;
    } info;

    uint32_t                va_reserved[VA_PADDING_LOW];
} VAEncMacroblockParameterBufferH264;

typedef struct _VAEncMiscParameterSubMbPartPelH264 {
    uint32_t disable_inter_sub_mb_partition;
    union {
        struct {
            uint32_t disable_16x16_inter_mb_partition        : 1;
            uint32_t disable_16x8_inter_mb_partition         : 1;
            uint32_t disable_8x16_inter_mb_partition         : 1;
            uint32_t disable_8x8_inter_mb_partition          : 1;
            uint32_t disable_8x4_inter_mb_partition          : 1;
            uint32_t disable_4x8_inter_mb_partition          : 1;
            uint32_t disable_4x4_inter_mb_partition          : 1;
            uint32_t reserved                                : 1;
        } bits;
        uint8_t value;
    } inter_sub_mb_partition_mask;

    uint32_t enable_sub_pel_mode;
    uint8_t sub_pel_mode;
    uint8_t reserved[3];
} VAEncMiscParameterSubMbPartPelH264;
#ifdef __cplusplus
}
#endif

#endif /* VA_ENC_H264_H */