/****************************************************************************** * * 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 * * @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 FGC SEI */ typedef struct { /** * Flag to control the presence of FGC SEI params */ UWORD8 u1_film_grain_characteristics_cancel_flag; /** * Specifies the pic order count */ WORD32 i4_poc; /** * Specifies IDR pic ID */ UWORD32 u4_idr_pic_id; /** * Specifies film grain model for simulation */ UWORD8 u1_film_grain_model_id; /** * Specifies separate color format for decoded samples and grain */ UWORD8 u1_separate_colour_description_present_flag; /** * Specifies the bit depth used for the luma component */ UWORD8 u1_film_grain_bit_depth_luma_minus8; /** * Specifies the bit depth used for the Cb and Cr components */ UWORD8 u1_film_grain_bit_depth_chroma_minus8; /** * Specifies the colour space of the FGC in SEI */ UWORD8 u1_film_grain_full_range_flag; /** * Specifies the colour space of the FGC in SEI */ UWORD8 u1_film_grain_colour_primaries; /** * Specifies the colour space of the FGC in SEI */ UWORD8 u1_film_grain_transfer_characteristics; /** * Specifies the colour space of the FGC in SEI */ UWORD8 u1_film_grain_matrix_coefficients; /** * identifies the blending mode used to blend the simulated film grain with the decoded images */ UWORD8 u1_blending_mode_id; /** * Specifies a scale factor used in the film grain characterization equations */ UWORD8 u1_log2_scale_factor; /** * Indicates whether film grain is modelled or not on the colour component */ UWORD8 au1_comp_model_present_flag[SEI_FGC_NUM_COLOUR_COMPONENTS]; /** * Specifies the number of intensity intervals for which * a specific set of model values has been estimated */ UWORD8 au1_num_intensity_intervals_minus1[SEI_FGC_NUM_COLOUR_COMPONENTS]; /** * Specifies the number of model values present for each intensity interval in which * the film grain has been modelled */ UWORD8 au1_num_model_values_minus1[SEI_FGC_NUM_COLOUR_COMPONENTS]; /** * Specifies the lower bound of the interval of intensity levels for which * the set of model values applies */ UWORD8 au1_intensity_interval_lower_bound[SEI_FGC_NUM_COLOUR_COMPONENTS] [SEI_FGC_MAX_NUM_INTENSITY_INTERVALS]; /** * Specifies the upper bound of the interval of intensity levels for which * the set of model values applies */ UWORD8 au1_intensity_interval_upper_bound[SEI_FGC_NUM_COLOUR_COMPONENTS] [SEI_FGC_MAX_NUM_INTENSITY_INTERVALS]; /** * Represents each one of the model values present for * the colour component and intensity interval */ WORD32 ai4_comp_model_value[SEI_FGC_NUM_COLOUR_COMPONENTS][SEI_FGC_MAX_NUM_INTENSITY_INTERVALS] [SEI_FGC_MAX_NUM_MODEL_VALUES]; /** * Specifies the persistence of the film grain characteristics SEI message */ UWORD32 u4_film_grain_characteristics_repetition_period; } sei_fgc_params_t; /** * Structure to hold shutter interval info SEI */ typedef struct { /** * specifies if the sei sii is enabled */ UWORD8 u1_shutter_interval_info_present_flag; /** * specifies the shutter interval temporal sub-layer index * of the current picture */ UWORD32 u4_sii_sub_layer_idx; /** * specify the number of time units that pass in one second */ UWORD32 u4_sii_time_scale; /** * specifies that the indicated shutter interval is the same for all * pictures in the coded video sequence */ UWORD8 u1_fixed_shutter_interval_within_cvs_flag; /** * specifies the the number of time units of a clock operating at the * frequency sii_time_scale Hz that corresponds to the indicated shutter * interval of each picture in the coded video sequence */ UWORD32 u4_sii_num_units_in_shutter_interval; /** * sii_max_sub_layers_minus1 plus 1 specifies the maximum number of * shutter interval temporal sub-layers indexes that may be present * in the coded video sequence */ UWORD8 u1_sii_max_sub_layers_minus1; /* * specifies the number of time units of a clock operating at the * frequency sii_time_scale Hz that corresponds to the shutter * interval of each picture in the coded video sequence */ UWORD32 au4_sub_layer_num_units_in_shutter_interval[SII_MAX_SUB_LAYERS]; } sei_sii_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; /** * film grain characteristics info present flag */ UWORD8 u1_sei_fgc_params_present_flag; /* * Film grain parameters */ sei_fgc_params_t s_sei_fgc_params; /** * shutter interval info present flag */ UWORD8 u1_sei_sii_params_present_flag; /* * Shutter Interval Info parameters */ sei_sii_params_t s_sei_sii_params; } sei_params_t; #endif /* _IH264_STRUCTS_H_ */