Cemu/dependencies/ih264d/common/ih264_structs.h

1919 lines
43 KiB
C
Raw Permalink Normal View History

2022-08-22 22:21:23 +02:00
/******************************************************************************
*
* Copyright (C) 2015 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*****************************************************************************
* Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore
*/
/**
*******************************************************************************
* @file
* ih264_structs.h
*
* @brief
* Structure definitions used in the code
*
* @author
* Ittiam
*
* @par List of Functions:
*
* @remarks
* None
*
*******************************************************************************
*/
#ifndef _IH264_STRUCTS_H_
#define _IH264_STRUCTS_H_
/** MB Type info for Intra MBs */
typedef struct
{
UWORD32 u4_num_mbpart;
MBPART_PREDMODE_T e_mbpart_predmode;
MBMODES_I16x16 e_intra_predmode;
UWORD32 u4_cpb_chroma;
UWORD32 u4_cpb_luma;
}intra_mbtype_info_t;
/** MB Type info for Inter MBs */
typedef struct
{
UWORD32 u4_num_mbpart;
MBPART_PREDMODE_T e_mbpart_predmode_0;
MBPART_PREDMODE_T e_mbpart_predmode_1;
UWORD32 u4_mbpart_wd;
UWORD32 u4_mbpart_ht;
}inter_mbtype_info_t;
/** Sub MB Type info for Inter MBs */
typedef struct
{
UWORD32 u4_num_mbpart;
MBPART_PREDMODE_T e_mbpart_predmode;
UWORD32 u4_mbpart_wd;
UWORD32 u4_mbpart_ht;
}submbtype_info_t;
/**
* Picture buffer
*/
typedef struct
{
UWORD8* pu1_luma;
UWORD8* pu1_chroma;
WORD32 i4_abs_poc;
WORD32 i4_poc_lsb;
/** Lower 32 bit of time stamp */
UWORD32 u4_timestamp_low;
/** Upper 32 bit of time stamp */
UWORD32 u4_timestamp_high;
WORD32 i4_used_as_ref;
/**
* frame_num in the slice header
*/
WORD32 i4_frame_num;
/**
* Long-term frame idx
* TODO: store in frame_num
*/
WORD32 i4_long_term_frame_idx;
/*
* 0: Top Field
* 1: Bottom Field
*/
WORD8 i1_field_type;
/**
* buffer ID from frame buffer manager
*/
WORD32 i4_buf_id;
} pic_buf_t;
/**
* Reference List
*/
typedef struct
{
void *pv_pic_buf;
void *pv_mv_buf;
} ref_list_t;
/**
* Motion vector
*/
typedef struct
{
/**
* Horizontal Motion Vector
*/
WORD16 i2_mvx;
/**
* Vertical Motion Vector
*/
WORD16 i2_mvy;
} mv_t;
/*****************************************************************************/
/* Following results in packed 48 bit structure. If mv_t included */
/* ref_pic_buf_id, then 8 bits will be wasted for each mv for aligning. */
/* Also using mv_t as elements directly instead of a pointer to l0 and l1 */
/* mvs. Since pointer takes 4 bytes and MV itself is 4 bytes. It does not */
/* really help using pointers. */
/*****************************************************************************/
/**
* PU Motion Vector info
*/
typedef struct
{
/**
* L0 Motion Vector
*/
mv_t s_l0_mv;
/**
* L1 Motion Vector
*/
mv_t s_l1_mv;
/**
* L0 Ref index
*/
WORD8 i1_l0_ref_idx;
/**
* L1 Ref index
*/
WORD8 i1_l1_ref_idx;
/**
* L0 Ref Pic Buf ID
*/
WORD8 i1_l0_ref_pic_buf_id;
/**
* L1 Ref Pic Buf ID
*/
WORD8 i1_l1_ref_pic_buf_id;
} pu_mv_t;
/**
* PU information
*/
typedef struct
{
/**
* Motion Vectors
*/
pu_mv_t s_mv;
/**
* PU X position in terms of min PU (4x4) units
*/
UWORD32 b2_pos_x : 2;
/**
* PU Y position in terms of min PU (4x4) units
*/
UWORD32 b2_pos_y : 2;
/**
* PU width in pixels = (b2_wd + 1) << 2
*/
UWORD32 b2_wd : 2;
/**
* PU height in pixels = (b2_ht + 1) << 2
*/
UWORD32 b2_ht : 2;
/**
* Intra or Inter flag for each partition - 0 or 1
*/
UWORD32 b1_intra_flag : 1;
/**
* PRED_L0, PRED_L1, PRED_BI
*/
UWORD32 b2_pred_mode : 2;
} pu_t;
/**
* MB information to be stored for entire frame
*/
typedef struct
{
/**
* Transform sizes 0: 4x4, 1: 8x8,
*/
UWORD32 b1_trans_size : 1;
/**
* CBP - 4 bits for Y, 1 for U and 1 for V
*/
UWORD32 b6_cbp: 6;
/**
* Intra pred sizes 0: 4x4, 1: 8x8, 2: 16x16
*/
UWORD32 b2_intra_pred_size : 2;
/**
* Flag to signal if the current MB is IPCM
*/
UWORD32 b1_ipcm : 1;
}mb_t;
/*****************************************************************************/
/* Info from last TU row of MB is stored in a row level neighbour buffer */
/* , which will be used for Boundary Strength computation */
/*****************************************************************************/
/**
* MB neighbor info
*/
typedef struct
{
/**
* Slice index of the mb
*/
UWORD16 u2_slice_idx;
/*************************************************************************/
/* CBF of bottom TU row (replicated in 4 pixel boundary) */
/* MSB contains CBF of first TU in the last row and LSB contains CBF */
/* of last TU in the last row */
/*************************************************************************/
/**
* CBF of bottom TU row
*/
UWORD16 u2_packed_cbf;
/*************************************************************************/
/* QP of bottom TU row (replicated at 8 pixel boundary (Since QP can */
/* not change at less than min CU granularity) */
/*************************************************************************/
/**
* QP of bottom TU row
*/
UWORD8 u1_qp;
} mb_top_ny_info_t;
/**
* MB level context
*/
typedef struct _mb_ctxt_t
{
/*************************************************************************/
/* Tile boundary can be detected by looking at tile start x and tile */
/* start y. And based on the tile, slice and frame boundary the */
/* following will be initialized. */
/*************************************************************************/
/**
* Pointer to left MB
*/
/* If not available, this will be set to NULL */
struct _mb_ctxt_t *ps_mb_left;
/**
* Pointer to top-left MB
*/
/* If not available, this will be set to NULL */
mb_top_ny_info_t *ps_mb_ny_topleft;
/**
* Pointer to top MB
*/
/* If not available, this will be set to NULL */
mb_top_ny_info_t *ps_mb_ny_top;
/**
* Pointer to top-right MB
*/
/* If not available, this will be set to NULL */
mb_top_ny_info_t *ps_mb_ny_topright;
/*************************************************************************/
/* Pointer to PU data. */
/* This points to a MV Bank stored at frame level. Though this */
/* pointer can be derived by reading offset at frame level, it is */
/* stored here for faster access. Can be removed if storage of MB */
/* structure is critical */
/*************************************************************************/
/**
* Pointer to PU data
*/
pu_t *ps_pu;
/*************************************************************************/
/* Pointer to a PU map stored at frame level, */
/* Though this pointer can be derived by multiplying MB address with */
/* number of minTUs in a MB, it is stored here for faster access. */
/* Can be removed if storage of MB structure is critical */
/*************************************************************************/
/**
* Pointer to a PU map stored at frame level
*/
UWORD8 *pu1_pu_map;
/**
* Number of TUs filled in as_tu
*/
/*************************************************************************/
/* Having the first entry as 32 bit data, helps in keeping each of */
/* the structures aligned to 32 bits at MB level */
/*************************************************************************/
WORD32 i4_tu_cnt;
/**
* Pointer to transform coeff data
*/
/*************************************************************************/
/* Following format is repeated for every coded TU */
/* Luma Block */
/* num_coeffs : 16 bits */
/* zero_cols : 8 bits ( 1 bit per 4 columns) */
/* sig_coeff_map : ((TU Size * TU Size) + 31) >> 5 number of WORD32s */
/* coeff_data : Non zero coefficients */
/* Cb Block (only for last TU in 4x4 case else for every luma TU) */
/* num_coeffs : 16 bits */
/* zero_cols : 8 bits ( 1 bit per 4 columns) */
/* sig_coeff_map : ((TU Size * TU Size) + 31) >> 5 number of WORD32s */
/* coeff_data : Non zero coefficients */
/* Cr Block (only for last TU in 4x4 case else for every luma TU) */
/* num_coeffs : 16 bits */
/* zero_cols : 8 bits ( 1 bit per 4 columns) */
/* sig_coeff_map : ((TU Size * TU Size) + 31) >> 5 number of WORD32s */
/* coeff_data : Non zero coefficients */
/*************************************************************************/
void *pv_coeff_data;
/**
* Slice to which the MB belongs to
*/
WORD32 i4_slice_idx;
/**
* MB column position
*/
WORD32 i4_pos_x;
/**
* MB row position
*/
WORD32 i4_pos_y;
/**
* Number of PUs filled in ps_pu
*/
WORD32 i4_pu_cnt;
/**
* Index of current PU being processed in ps_pu
*/
/* Scratch variable set to 0 at the start of any PU processing function */
WORD32 i4_pu_idx;
/**
* Vertical Boundary strength
*/
/* Two bits per edge.
Stored in format. BS[15] | BS[14] | .. |BS[0]*/
UWORD32 *pu4_vert_bs;
/**
* Horizontal Boundary strength
*/
/* Two bits per edge.
Stored in format. BS[15] | BS[14] | .. |BS[0]*/
UWORD32 *pu4_horz_bs;
/**
* Qp array stored for each 8x8 pixels
*/
UWORD8 *pu1_qp;
/**
* Pointer to current frame's pu_t array
*/
pu_t *ps_frm_pu;
/**
* Pointer to current frame's pu_t index array, which stores starting index
* of pu_t for every MB
*/
UWORD32 *pu4_frm_pu_idx;
/**
* Pointer to current frame's pu map array
*/
UWORD8 *pu1_frm_pu_map;
/*************************************************************************/
/* Need to add encoder specific elements for identifying the order of */
/* coding for CU, TU and PU if any */
/*************************************************************************/
} mb_ctxt_t;
/*************************************************************************/
/* The following describes how each of the CU cases are handled */
/*************************************************************************/
/*************************************************************************/
/* For SKIP MB */
/* One Inter PU with appropriate MV */
/* One TU which says CBP is zero and size is 16x16 */
/*************************************************************************/
/*************************************************************************/
/* For Inter MB */
/* M Inter PU with appropriate MVs (M between 1 to 4) */
/* Number of TUs derived based on transform size */
/*************************************************************************/
/*************************************************************************/
/* For Intra MB */
/* Number of TUs derived based on transform size */
/* N Intra Modes are signaled along with coeff data at the start */
/*************************************************************************/
/*************************************************************************/
/* For Intra PCM MB */
/* One TU which says ipcm is 1 */
/*************************************************************************/
/**
* Structure to hold quantization parameters of an mb
*/
typedef struct
{
/*
* mb qp
*/
UWORD8 u1_mb_qp;
/*
* mb qp / 6
*/
UWORD8 u1_qp_div;
/*
* mb qp mod 6
*/
UWORD8 u1_qp_rem;
/*
* QP bits
*/
UWORD8 u1_qbits;
/*
* forward scale matrix
*/
const UWORD16 *pu2_scale_mat;
/*
* threshold matrix for quantization
*/
UWORD16 *pu2_thres_mat;
/*
* Threshold to compare the sad with
*/
UWORD16 *pu2_sad_thrsh;
/*
* qp dependent rounding constant
*/
UWORD32 u4_dead_zone;
/*
* inverse scale matrix
*/
const UWORD16 *pu2_iscale_mat;
/*
* Weight matrix in iquant
*/
UWORD16 *pu2_weigh_mat;
}quant_params_t;
/**
* Structure to hold Profile tier level info for a given layer
*/
typedef struct
{
/**
* NAL unit type
*/
WORD8 i1_nal_unit_type;
/**
* NAL ref idc
*/
WORD8 i1_nal_ref_idc;
} nal_header_t;
/**
* HRD parameters Info
*/
typedef struct
{
/**
* Specifies the number of alternative CPB specifications in the
* bitstream
*/
UWORD8 u1_cpb_cnt_minus1;
/**
* (together with bit_rate_value_minus1) specifies the
* maximum input bit rate of the i-th CPB
*/
UWORD32 u4_bit_rate_scale;
/**
* (together with cpb_size_du_value_minus1) specifies
* CPB size of the i-th CPB when the CPB operates
* at the access unit level
*/
UWORD32 u4_cpb_size_scale;
/**
* (together with bit_rate_scale) specifies the
* maximum input bit rate for the i-th CPB
*/
UWORD32 au4_bit_rate_value_minus1[32];
/**
* together with cpb_size_scale to specify the
* CPB size when the CPB operates at the access unit level.
*/
UWORD32 au4_cpb_size_value_minus1[32];
/**
* if 1, specifies that the HSS operates in a constant bit rate (CBR) mode
* if 0, specifies that the HSS operates in a intermittent bit rate (CBR) mode
*/
UWORD8 au1_cbr_flag[32];
/**
* specifies the length, in bits for initial cpb delay (nal/vcl)syntax in bp sei
*/
UWORD8 u1_initial_cpb_removal_delay_length_minus1;
/**
* specifies the length, in bits for the cpb delay syntax in pt_sei
*/
UWORD8 u1_cpb_removal_delay_length_minus1;
/**
* specifies the length, in bits, of the pic_dpb_output_delay syntax element in the pt SEI message
*/
UWORD8 u1_dpb_output_delay_length_minus1;
/**
* Specifies length of the time offset parameter
*/
UWORD8 u1_time_offset_length;
}hrd_params_t;
/**
* Structure to hold VUI parameters Info
*/
typedef struct
{
/**
* indicates the presence of aspect_ratio
*/
UWORD8 u1_aspect_ratio_info_present_flag;
/**
* specifies the aspect ratio of the luma samples
*/
UWORD8 u1_aspect_ratio_idc;
/**
* width of the luma samples. user dependent
*/
UWORD16 u2_sar_width;
/**
* Height of the luma samples. user dependent
*/
UWORD16 u2_sar_height;
/**
* if 1, specifies that the overscan_appropriate_flag is present
* if 0, the preferred display method for the video signal is unspecified
*/
UWORD8 u1_overscan_info_present_flag;
/**
* if 1,indicates that the cropped decoded pictures output
* are suitable for display using overscan
*/
UWORD8 u1_overscan_appropriate_flag;
/**
* if 1 specifies that video_format, video_full_range_flag and
* colour_description_present_flag are present
*/
UWORD8 u1_video_signal_type_present_flag;
/**
* pal, secam, ntsc, ...
*/
UWORD8 u1_video_format;
/**
* indicates the black level and range of the luma and chroma signals
*/
UWORD8 u1_video_full_range_flag;
/**
* if 1,to 1 specifies that colour_primaries, transfer_characteristics
* and matrix_coefficients are present
*/
UWORD8 u1_colour_description_present_flag;
/**
* indicates the chromaticity coordinates of the source primaries
*/
UWORD8 u1_colour_primaries;
/**
* indicates the opto-electronic transfer characteristic of the source picture
*/
UWORD8 u1_transfer_characteristics;
/**
* the matrix coefficients used in deriving luma and chroma signals
* from the green, blue, and red primaries
*/
UWORD8 u1_matrix_coefficients;
/**
* if 1, specifies that chroma_sample_loc_type_top_field and
* chroma_sample_loc_type_bottom_field are present
*/
UWORD8 u1_chroma_loc_info_present_flag;
/**
* location of chroma samples
*/
UWORD8 u1_chroma_sample_loc_type_top_field;
UWORD8 u1_chroma_sample_loc_type_bottom_field;
/**
* Indicates the presence of the
* num_units_in_ticks, time_scale flag
*/
UWORD8 u1_vui_timing_info_present_flag;
/**
* Number of units that
* correspond to one increment of the
* clock. Indicates the resolution
*/
UWORD32 u4_vui_num_units_in_tick;
/**
* The number of time units that pass in one second
*/
UWORD32 u4_vui_time_scale;
/**
* Flag indicating that time difference between two frames is a constant
*/
UWORD8 u1_fixed_frame_rate_flag;
/**
* Indicates the presence of NAL HRD parameters
*/
UWORD8 u1_nal_hrd_parameters_present_flag;
/**
* NAL level HRD parameters
*/
hrd_params_t s_nal_hrd_parameters;
/**
* Indicates the presence of VCL HRD parameters
*/
UWORD8 u1_vcl_hrd_parameters_present_flag;
/**
* VCL level HRD parameters
*/
hrd_params_t s_vcl_hrd_parameters;
/**
* Specifies the HRD operational mode
*/
UWORD8 u1_low_delay_hrd_flag;
/**
* Indicates presence of SEI messages which include pic_struct syntax element
*/
UWORD8 u1_pic_struct_present_flag;
/**
* 1, specifies that the following cvs bitstream restriction parameters are present
*/
UWORD8 u1_bitstream_restriction_flag;
/**
* if 0, indicates that no pel outside the pic boundaries and
* no sub-pels derived using pels outside the pic boundaries is used for inter prediction
*/
UWORD8 u1_motion_vectors_over_pic_boundaries_flag;
/**
* Indicates a number of bytes not exceeded by the sum of the sizes of the VCL NAL units
* associated with any coded picture
*/
UWORD8 u1_max_bytes_per_pic_denom;
/**
* Indicates an upper bound for the number of bits of coding_unit() data
*/
UWORD8 u1_max_bits_per_mb_denom;
/**
* Indicate the maximum absolute value of a decoded horizontal MV component
* in quarter-pel luma units
*/
UWORD8 u1_log2_max_mv_length_horizontal;
/**
* Indicate the maximum absolute value of a decoded vertical MV component
* in quarter-pel luma units
*/
UWORD8 u1_log2_max_mv_length_vertical;
/**
* Max number of frames that are not synchronized in display and decode order
*/
UWORD8 u1_num_reorder_frames;
/**
* specifies required size of the HRD DPB in units of frame buffers.
*/
UWORD8 u1_max_dec_frame_buffering;
} vui_t;
/**
* Structure to hold SPS info
*/
typedef struct
{
/**
* profile_idc
*/
UWORD8 u1_profile_idc;
/** constraint_set0_flag */
UWORD8 u1_constraint_set0_flag;
/** constraint_set1_flag */
UWORD8 u1_constraint_set1_flag;
/** constraint_set2_flag */
UWORD8 u1_constraint_set2_flag;
/** constraint_set3_flag */
UWORD8 u1_constraint_set3_flag;
/**
* level_idc
*/
UWORD8 u1_level_idc;
/**
* seq_parameter_set_id
*/
UWORD8 u1_sps_id;
/**
* chroma_format_idc
*/
UWORD8 u1_chroma_format_idc;
/**
* residual_colour_transform_flag
*/
WORD8 i1_residual_colour_transform_flag;
/**
* bit_depth_luma_minus8
*/
WORD8 i1_bit_depth_luma;
/**
* bit_depth_chroma_minus8
*/
WORD8 i1_bit_depth_chroma;
/**
* qpprime_y_zero_transform_bypass_flag
*/
WORD8 i1_qpprime_y_zero_transform_bypass_flag;
/**
* seq_scaling_matrix_present_flag
*/
WORD8 i1_seq_scaling_matrix_present_flag;
/**
* seq_scaling_list_present_flag
*/
WORD8 ai1_seq_scaling_list_present_flag[8];
/**
* log2_max_frame_num_minus4
*/
WORD8 i1_log2_max_frame_num;
/**
* MaxFrameNum in the standard
* 1 << i1_log2_max_frame_num
*/
WORD32 i4_max_frame_num;
/**
* pic_order_cnt_type
*/
WORD8 i1_pic_order_cnt_type;
/**
* log2_max_pic_order_cnt_lsb_minus4
*/
WORD8 i1_log2_max_pic_order_cnt_lsb;
/**
* MaxPicOrderCntLsb in the standard.
* 1 << log2_max_pic_order_cnt_lsb_minus4
*/
WORD32 i4_max_pic_order_cnt_lsb;
/**
* delta_pic_order_always_zero_flag
*/
WORD8 i1_delta_pic_order_always_zero_flag;
/**
* offset_for_non_ref_pic
*/
WORD32 i4_offset_for_non_ref_pic;
/**
* offset_for_top_to_bottom_field
*/
WORD32 i4_offset_for_top_to_bottom_field;
/**
* num_ref_frames_in_pic_order_cnt_cycle
*/
UWORD8 u1_num_ref_frames_in_pic_order_cnt_cycle;
/**
* Offset_for_ref_frame
*/
WORD32 ai4_offset_for_ref_frame[256];
/**
* max_num_ref_frames
*/
UWORD8 u1_max_num_ref_frames;
/**
* gaps_in_frame_num_value_allowed_flag
*/
WORD8 i1_gaps_in_frame_num_value_allowed_flag;
/**
* pic_width_in_mbs_minus1
*/
WORD16 i2_pic_width_in_mbs_minus1;
/**
* pic_height_in_map_units_minus1
*/
WORD16 i2_pic_height_in_map_units_minus1;
/**
* frame_mbs_only_flag
*/
WORD8 i1_frame_mbs_only_flag;
/**
* mb_adaptive_frame_field_flag
*/
WORD8 i1_mb_adaptive_frame_field_flag;
/**
* direct_8x8_inference_flag
*/
WORD8 i1_direct_8x8_inference_flag;
/**
* frame_cropping_flag
*/
WORD8 i1_frame_cropping_flag;
/**
* frame_crop_left_offset
*/
WORD16 i2_frame_crop_left_offset;
/**
* frame_crop_right_offset
*/
WORD16 i2_frame_crop_right_offset;
/**
* frame_crop_top_offset
*/
WORD16 i2_frame_crop_top_offset;
/**
* frame_crop_bottom_offset
*/
WORD16 i2_frame_crop_bottom_offset;
/**
* vui_parameters_present_flag
*/
WORD8 i1_vui_parameters_present_flag;
/**
* vui_parameters_Structure_info
*/
vui_t s_vui_parameters;
/**
* Flag to give status of SPS structure
*/
WORD8 i1_sps_valid;
/**
* Coded Picture width
*/
WORD32 i2_pic_wd;
/**
* Coded Picture height
*/
WORD32 i2_pic_ht;
/**
* Picture width in MB units
*/
WORD16 i2_pic_wd_in_mb;
/**
* Picture height in MB units
*/
WORD16 i2_pic_ht_in_mb;
/**
* useDefaultScalingMatrixFlag
*/
WORD8 ai1_use_default_scaling_matrix_flag[8];
/**
* 4x4 Scaling lists after inverse zig zag scan
*/
UWORD16 au2_4x4_weight_scale[6][16];
/**
* 4x4 Scaling lists after inverse zig zag scan
*/
UWORD16 au2_8x8_weight_scale[2][64];
} sps_t;
/**
* Structure to hold PPS info
*/
typedef struct
{
/**
* pic_parameter_set_id
*/
UWORD8 u1_pps_id;
/**
* seq_parameter_set_id
*/
UWORD8 u1_sps_id;
/**
* Entropy coding : 0-VLC; 1 - CABAC
*/
UWORD8 u1_entropy_coding_mode_flag;
/*
* Pic order present flag
*/
UWORD8 u1_pic_order_present_flag;
/*
* Number of slice groups
*/
UWORD8 u1_num_slice_groups;
/*
* Slice group map type
*/
UWORD8 u1_slice_group_map_type;
/*
* Maximum reference picture index in the reference list 0 : range [0 - 31]
*/
WORD8 i1_num_ref_idx_l0_default_active;
/*
* Maximum reference picture index in the reference list 1 : range [0 - 31]
*/
WORD8 i1_num_ref_idx_l1_default_active;
/**
* weighted_pred_flag
*/
WORD8 i1_weighted_pred_flag;
/**
* weighted_bipred_flag
*/
WORD8 i1_weighted_bipred_idc;
/**
* pic_init_qp_minus26
*/
WORD8 i1_pic_init_qp;
/**
* pic_init_qs_minus26
*/
WORD8 i1_pic_init_qs;
/*
* Chroma QP offset w.r.t QPY {-12,12}
*/
WORD8 i1_chroma_qp_index_offset;
/**
* deblocking_filter_control_present_flag
*/
WORD8 i1_deblocking_filter_control_present_flag;
/**
* constrained_intra_pred_flag
*/
WORD8 i1_constrained_intra_pred_flag;
/**
* redundant_pic_cnt_present_flag
*/
WORD8 i1_redundant_pic_cnt_present_flag;
/**
* transform_8x8_mode_flag
*/
WORD8 i1_transform_8x8_mode_flag;
/**
* pic_scaling_matrix_present_flag
*/
WORD8 i1_pic_scaling_matrix_present_flag;
/*
* Second chroma QP offset
*/
WORD8 i1_second_chroma_qp_index_offset;
/**
* useDefaultScalingMatrixFlag
*/
WORD8 ai1_use_default_scaling_matrix_flag[8];
/**
* 4x4 Scaling lists after inverse zig zag scan
*/
UWORD16 au2_4x4_weight_scale[6][16];
/**
* 4x4 Scaling lists after inverse zig zag scan
*/
UWORD16 au2_8x8_weight_scale[2][64];
/**
* pic_scaling_list_present_flag
*/
WORD8 ai1_pic_scaling_list_present_flag[8];
/**
* Flag to give status of PPS structure
*/
WORD8 i1_pps_valid;
} pps_t;
/**
* MMCO commands and params.
*/
typedef struct
{
/* memory management control operation command */
UWORD8 u1_memory_management_control_operation;
/*
* Contains difference of pic nums of short-term pic/frame
* 1. To signal it as "unused for reference" if mmco = 1
* 2. To signal it as "used for long-term reference" if mmco = 3
*/
UWORD32 u4_difference_of_pic_nums_minus1;
/* Long-term pic num to be set as "unused for reference" */
UWORD8 u1_long_term_pic_num;
/*
* Assign a long-term idx to a picture as follows
* 1. Assign to a short-term pic if mmco = 3
* 2. Assign to the current pic if mmco = 6
*/
UWORD8 u1_long_term_frame_idx;
/*
* The max long-term idx. The long-term pics having idx above
* are set as "unused for reference
*/
UWORD8 u1_max_long_term_frame_idx_plus1;
}mmco_prms_t;
/**
* Structure to hold Reference picture list modification info
*/
typedef struct
{
/* ref_pic_list_modification_flag_l0 */
WORD8 i1_ref_pic_list_modification_flag_l0;
/* Modification required in list0 */
WORD8 i1_modification_of_pic_nums_idc_l0[MAX_MODICATION_IDC];
/*
* The absolute difference between the picture number of
* the picture being moved to the current index in
* list0 and the picture number prediction value
*/
UWORD32 u4_abs_diff_pic_num_minus1_l0[MAX_MODICATION_IDC];
/*
* The long-term picture number of the picture being moved
* to the current index in list0
*/
UWORD8 u1_long_term_pic_num_l0[MAX_MODICATION_IDC];
/* ref_pic_list_modification_flag_l1 */
WORD8 i1_ref_pic_list_modification_flag_l1;
/* Modification required in list1 */
WORD8 i1_modification_of_pic_nums_idc_l1[MAX_MODICATION_IDC];
/*
* The absolute difference between the picture number of
* the picture being moved to the current index in
* list1 and the picture number prediction value
*/
UWORD32 u4_abs_diff_pic_num_minus1_l1[MAX_MODICATION_IDC];
/*
* The long-term picture number of the picture being moved
* to the current index in list1
*/
UWORD8 u1_long_term_pic_num_l1[MAX_MODICATION_IDC];
}rplm_t;
/**
* Structure to hold Slice Header info
*/
typedef struct
{
/*
* nal_unit_type
*/
WORD8 i1_nal_unit_type;
/*
* nal_unit_idc
*/
WORD8 i1_nal_unit_idc;
/*
* first_mb_in_slice
*/
UWORD16 u2_first_mb_in_slice;
/*
* slice_type
*/
UWORD8 u1_slice_type;
/*
* pic_parameter_set_id
*/
UWORD8 u1_pps_id;
/*
* frame_num
*/
WORD32 i4_frame_num;
/*
* field_pic_flag
*/
WORD8 i1_field_pic_flag;
/*
* bottom_field_flag
*/
WORD8 i1_bottom_field_flag;
/*
* second_field
*/
WORD8 i1_second_field_flag;
/*
* idr_pic_id
*/
UWORD16 u2_idr_pic_id ;
/*
* pic_order_cnt_lsb
*/
UWORD16 i4_pic_order_cnt_lsb;
/*
* delta_pic_order_cnt_bottom
*/
WORD32 i4_delta_pic_order_cnt_bottom;
/*
* delta_pic_order_cnt
*/
WORD32 ai4_delta_pic_order_cnt[2];
/*
* redundant_pic_cnt
*/
UWORD8 u1_redundant_pic_cnt;
/*
* direct_spatial_mv_pred_flag
*/
UWORD8 u1_direct_spatial_mv_pred_flag;
/*
* num_ref_idx_active_override_flag
*/
UWORD8 u1_num_ref_idx_active_override_flag;
/*
* num_ref_idx_l0_active
*/
WORD8 i1_num_ref_idx_l0_active;
/*
* num_ref_idx_l1_active_minus1
*/
WORD8 i1_num_ref_idx_l1_active;
/*
* ref_pic_list_reordering_flag_l0
*/
UWORD8 u1_ref_idx_reordering_flag_l0;
/*
* ref_pic_list_reordering_flag_l1
*/
UWORD8 u1_ref_idx_reordering_flag_l1;
/**
* Reference prediction list modification
*/
rplm_t s_rplm;
/**
* L0 Reference pic lists
*/
ref_list_t as_ref_pic_list0[MAX_DPB_SIZE];
/**
* L1 Reference pic lists
*/
ref_list_t as_ref_pic_list1[MAX_DPB_SIZE];
/*
* no_output_of_prior_pics_flag
*/
UWORD8 u1_no_output_of_prior_pics_flag;
/*
* long_term_reference_flag
*/
UWORD8 u1_long_term_reference_flag;
/*
* adaptive_ref_pic_marking_mode_flag
*/
UWORD8 u1_adaptive_ref_pic_marking_mode_flag;
/*
* Array to structures to store mmco commands
* and parameters.
*/
mmco_prms_t as_mmco_prms[MAX_MMCO_COMMANDS];
/*
* entropy_coding_mode_flag
*/
WORD8 u1_entropy_coding_mode_flag;
/*
* cabac_init_idc
*/
WORD8 i1_cabac_init_idc;
/*
* i1_slice_qp
*/
WORD8 i1_slice_qp;
/*
* sp_for_switch_flag
*/
UWORD8 u1_sp_for_switch_flag;
/*
* slice_qs_delta
*/
UWORD8 u1_slice_qs;
/*
* disable_deblocking_filter_idc
*/
WORD8 u1_disable_deblocking_filter_idc;
/*
* slice_alpha_c0_offset_div2
*/
WORD8 i1_slice_alpha_c0_offset_div2;
/*
* slice_beta_offset_div2
*/
WORD8 i1_slice_beta_offset_div2;
/*
* num_slice_groups_minus1
*/
WORD8 u1_num_slice_groups_minus1;
/*
* slice_group_change_cycle
*/
WORD8 u1_slice_group_change_cycle;
/**
* Start MB X
*/
UWORD16 i2_mb_x;
/**
* Start MB Y
*/
UWORD16 i2_mb_y;
/**
* Absolute POC. Contains minimum of top and bottom POC.
*/
WORD32 i4_abs_pic_order_cnt;
/**
* Absolute top POC. Contains top poc for frame or top
* field. Invalid for bottom field.
*/
WORD32 i4_abs_top_pic_order_cnt;
/**
* Absolute top POC. Contains bottom poc for frame or bottom
* field. Invalid for top field.
*/
WORD32 i4_abs_bottom_pic_order_cnt;
/** Flag signaling if the current slice is ref slice */
UWORD8 i1_nal_ref_idc;
/** Flag to indicate if the current slice is MBAFF Frame */
UWORD8 u1_mbaff_frame_flag;
/** luma_log2_weight_denom */
UWORD8 u1_luma_log2_weight_denom;
/** chroma_log2_weight_denom */
UWORD8 u1_chroma_log2_weight_denom;
/** luma_weight_l0_flag */
UWORD8 au1_luma_weight_l0_flag[MAX_DPB_SIZE];
/** luma_weight_l0 : (-128, 127 )is the range of weights
* when weighted pred is enabled, 128 is default value */
WORD16 ai2_luma_weight_l0[MAX_DPB_SIZE];
/** luma_offset_l0 : (-128, 127 )is the range of offset
* when weighted pred is enabled, 0 is default value */
WORD8 ai1_luma_offset_l0[MAX_DPB_SIZE];
/** chroma_weight_l0_flag */
UWORD8 au1_chroma_weight_l0_flag[MAX_DPB_SIZE];
/** chroma_weight_l0 : (-128, 127 )is the range of weights
* when weighted pred is enabled, 128 is default value*/
WORD16 ai2_chroma_weight_l0[MAX_DPB_SIZE][2];
/** chroma_offset_l0 : (-128, 127 )is the range of offset
* when weighted pred is enabled, 0 is default value*/
WORD8 ai1_chroma_offset_l0[MAX_DPB_SIZE][2];
/** luma_weight_l0_flag */
UWORD8 au1_luma_weight_l1_flag[MAX_DPB_SIZE];
/** luma_weight_l1 : (-128, 127 )is the range of weights
* when weighted pred is enabled, 128 is default value */
WORD16 ai2_luma_weight_l1[MAX_DPB_SIZE];
/** luma_offset_l1 : (-128, 127 )is the range of offset
* when weighted pred is enabled, 0 is default value */
WORD8 ai1_luma_offset_l1[MAX_DPB_SIZE];
/** chroma_weight_l1_flag */
UWORD8 au1_chroma_weight_l1_flag[MAX_DPB_SIZE];
/** chroma_weight_l1 : (-128, 127 )is the range of weights
* when weighted pred is enabled, 128 is default value */
WORD16 ai2_chroma_weight_l1[MAX_DPB_SIZE][2];
/** chroma_offset_l1 :(-128, 127 )is the range of offset
* when weighted pred is enabled, 0 is default value */
WORD8 ai1_chroma_offset_l1[MAX_DPB_SIZE][2];
}slice_header_t;
/*****************************************************************************/
/* The following can be used to type cast coefficient data that is stored */
/* per subblock. Note that though i2_level is shown as an array that */
/* holds 16 coefficients, only the first few entries will be valid. Next */
/* subblocks data starts after the valid number of coefficients. Number */
/* of non-zero coefficients will be derived using number of non-zero bits */
/* in sig coeff map */
/*****************************************************************************/
/**
* Structure to hold coefficient info for a 2x2 chroma DC transform
*/
typedef struct
{
/**
* significant coefficient map
*/
UWORD8 u1_sig_coeff_map;
/**
* sub block position
*/
UWORD8 u1_subblk_pos;
/**
* holds coefficients
*/
WORD16 ai2_level[2 * 2];
}tu_sblk2x2_coeff_data_t;
/**
* Structure to hold coefficient info for a 4x4 transform
*/
typedef struct
{
/**
* significant coefficient map
*/
UWORD16 u2_sig_coeff_map;
/**
* sub block position
*/
UWORD16 u2_subblk_pos;
/**
* holds coefficients
*/
WORD16 ai2_level[SUBBLK_COEFF_CNT];
}tu_sblk4x4_coeff_data_t;
/**
* Structure to hold coefficient info for a 8x8 transform
*/
typedef struct
{
/**
* significant coefficient map
*/
UWORD32 au4_sig_coeff_map[2];
/**
* sub block position
*/
UWORD16 u2_subblk_pos;
/**
* holds coefficients
*/
WORD16 ai2_level[TRANS_SIZE_8 * TRANS_SIZE_8];
}tu_blk8x8_coeff_data_t;
/**
* Structure to hold coefficient info for a 16x16 IPCM MB
*/
typedef struct
{
/**
* holds coefficients
*/
UWORD8 au1_level[MB_SIZE * MB_SIZE * 3 / 2];
}tu_ipcm_coeff_data_t;
typedef struct
{
/**
* Transform sizes 0: 4x4, 1: 8x8,
*/
UWORD32 b1_trans_size : 1;
/**
* Flag to signal if the current MB is IPCM
*/
UWORD32 b1_ipcm : 1;
/**
* Intra pred sizes 0: 4x4, 1: 8x8, 2: 16x16
*/
UWORD32 b2_intra_pred_size : 2;
/**
* Chroma intra mode
*/
UWORD32 b2_intra_chroma_pred_mode: 2;
/**
* Number of coded subblocks in the current MB, for which
* tu data is sent. Maximum of 27 subblocks in the following
* order.
* 1 4x4 luma DC(for intra16x16),
* 16 4x4 luma,
* 2 2x2 chroma DC,
* 8 4x4 chroma,
*/
WORD32 b5_num_coded_sblks: 5;
/**
* Flag to signal if 4x4 subblock for DC values (in INTRA 16x16 MB)
* is coded
*/
UWORD32 b1_luma_dc_coded: 1;
/**
* Flag to signal if 4x4 subblock for DC values (in INTRA 16x16 MB)
* is coded
*/
UWORD32 b1_chroma_dc_coded: 1;
/**
* CSBP - 16 bits, 1 bit for each 4x4
* for intra16x16 mb_type only ac coefficients are
*/
UWORD32 b16_luma_csbp: 16;
/**
* CSBP - 16 bits, 1 bit for each 4x4
* for intra16x16 mb_type only ac coefficients are
*/
UWORD32 b8_chroma_csbp: 8;
/**
* Luma Intra pred modes,
* Based on intra pred size either 16, 4 or 1 entry will be
* populated below.
*/
UWORD8 au1_luma_intra_modes[16];
}intra_mb_t;
typedef struct
{
/**
* Transform sizes 0: 4x4, 1: 8x8,
*/
UWORD8 b1_trans_size : 1;
/**
* Skip flag
*/
UWORD8 b1_skip : 1;
/**
* Number of coded subblocks in the current MB, for which
* tu data is sent. Maximum of 26 subblocks in the following
* order.
* 16 4x4 luma,
* 2 2x2 chroma DC,
* 8 4x4 chroma,
*/
WORD32 b5_num_coded_sblks: 5;
/**
* CSBP - 16 bits, 1 bit for each 4x4
* for intra16x16 mb_type only ac coefficients are
*/
UWORD32 b16_luma_csbp: 16;
/**
* CSBP - 16 bits, 1 bit for each 4x4
* for intra16x16 mb_type only ac coefficients are
*/
UWORD32 b16_chroma_csbp: 8;
}inter_mb_t;
/**
* Structure to hold Mastering Display Color Volume SEI
*/
typedef struct
{
/**
* Array to store the display_primaries_x values
*/
UWORD16 au2_display_primaries_x[NUM_SEI_MDCV_PRIMARIES];
/**
* Array to store the display_primaries_y values
*/
UWORD16 au2_display_primaries_y[NUM_SEI_MDCV_PRIMARIES];
/**
* Variable to store the white point x value
*/
UWORD16 u2_white_point_x;
/**
* Variable to store the white point y value
*/
UWORD16 u2_white_point_y;
/**
* Variable to store the max display mastering luminance value
*/
UWORD32 u4_max_display_mastering_luminance;
/**
* Variable to store the min display mastering luminance value
*/
UWORD32 u4_min_display_mastering_luminance;
}sei_mdcv_params_t;
/**
* Structure for Content Light Level Info
*
*/
typedef struct
{
/**
* The maximum pixel intensity of all samples
*/
UWORD16 u2_max_content_light_level;
/**
* The average pixel intensity of all samples
*/
UWORD16 u2_max_pic_average_light_level;
}sei_cll_params_t;
/**
* Structure to hold Ambient viewing environment SEI
*/
typedef struct
{
/**
* specifies the environmental illluminance of the ambient viewing environment
*/
UWORD32 u4_ambient_illuminance;
/*
* specify the normalized x chromaticity coordinates of the
* environmental ambient light in the nominal viewing environment
*/
UWORD16 u2_ambient_light_x;
/*
* specify the normalized y chromaticity coordinates of the
* environmental ambient light in the nominal viewing environment
*/
UWORD16 u2_ambient_light_y;
}sei_ave_params_t;
/**
* Structure to hold Content color volume SEI
*/
typedef struct
{
/*
* Flag used to control persistence of CCV SEI messages
*/
UWORD8 u1_ccv_cancel_flag;
/*
* specifies the persistence of the CCV SEI message for the current layer
*/
UWORD8 u1_ccv_persistence_flag;
/*
* specifies the presence of syntax elements ccv_primaries_x and ccv_primaries_y
*/
UWORD8 u1_ccv_primaries_present_flag;
/*
* specifies that the syntax element ccv_min_luminance_value is present
*/
UWORD8 u1_ccv_min_luminance_value_present_flag;
/*
* specifies that the syntax element ccv_max_luminance_value is present
*/
UWORD8 u1_ccv_max_luminance_value_present_flag;
/*
* specifies that the syntax element ccv_avg_luminance_value is present
*/
UWORD8 u1_ccv_avg_luminance_value_present_flag;
/*
* shall be equal to 0 in bitstreams conforming to this version. Other values
* for reserved_zero_2bits are reserved for future use
*/
UWORD8 u1_ccv_reserved_zero_2bits;
/*
* specify the normalized x chromaticity coordinates of the colour
* primary component c of the nominal content colour volume
*/
WORD32 ai4_ccv_primaries_x[NUM_SEI_CCV_PRIMARIES];
/*
* specify the normalized y chromaticity coordinates of the colour
* primary component c of the nominal content colour volume
*/
WORD32 ai4_ccv_primaries_y[NUM_SEI_CCV_PRIMARIES];
/*
* specifies the normalized minimum luminance value
*/
UWORD32 u4_ccv_min_luminance_value;
/*
* specifies the normalized maximum luminance value
*/
UWORD32 u4_ccv_max_luminance_value;
/*
* specifies the normalized average luminance value
*/
UWORD32 u4_ccv_avg_luminance_value;
}sei_ccv_params_t;
/**
* Structure to hold SEI parameters Info
*/
typedef struct
{
/**
* mastering display color volume info present flag
*/
UWORD8 u1_sei_mdcv_params_present_flag;
/*
* MDCV parameters
*/
sei_mdcv_params_t s_sei_mdcv_params;
/**
* content light level info present flag
*/
UWORD8 u1_sei_cll_params_present_flag;
/*
* CLL parameters
*/
sei_cll_params_t s_sei_cll_params;
/**
* ambient viewing environment info present flag
*/
UWORD8 u1_sei_ave_params_present_flag;
/*
* AVE parameters
*/
sei_ave_params_t s_sei_ave_params;
/**
* content color volume info present flag
*/
UWORD8 u1_sei_ccv_params_present_flag;
/*
* CCV parameters
*/
sei_ccv_params_t s_sei_ccv_params;
} sei_params_t;
#endif /* _IH264_STRUCTS_H_ */