wrapper/libavc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
libavc/common/ih264_structs.h
Ram Mohan M 0ab5c42d27 libavc: Remove duplicate code and improve readability 
This commit does not introduce any new functionality w.r.t previous
commit. But it fixes few things. They are listed below
1. Guard Bands in header files are fixed
2. Header files contains function definition comments. These are same
as in source file. Maintaining same comment at two locations is
unnecessary. These are removed.
3. Maintain Indentation consistency across the code.
4. Remove unused code
2023-10-06 16:53:23 -07:00

2149 lines
48 KiB
C
Raw Permalink Blame History

/******************************************************************************
*
* 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_ */
Reference in a new issue View git blame Copy permalink