/****************************************************************************** * * 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 * ih264e_defs.h * * @brief * Definitions used in the encoder * * @author * ittiam * * @remarks * None * ******************************************************************************* */ #ifndef IH264E_DEFS_H_ #define IH264E_DEFS_H_ #define PARSE_COEFF_DATA_BLOCK_4x4(pv_mb_coeff_data, ps_mb_coeff_data, u4_nnz, u4_sig_coeff_map, pi2_res_block) \ { \ ps_mb_coeff_data = pv_mb_coeff_data; \ u4_nnz = ps_mb_coeff_data->i4_sig_map_nnz & 0xff; \ if (u4_nnz) \ { \ u4_sig_coeff_map = ps_mb_coeff_data->i4_sig_map_nnz >> 16; \ pi2_res_block = ps_mb_coeff_data->ai2_residue; \ pv_mb_coeff_data = ps_mb_coeff_data->ai2_residue + ALIGN2(u4_nnz); \ } \ else \ { \ pv_mb_coeff_data = ps_mb_coeff_data->ai2_residue; \ } \ } /*****************************************************************************/ /* Width and height restrictions */ /*****************************************************************************/ /** * Minimum width supported by codec */ #define MIN_WD 16 /** * Maximum width supported by codec */ #define MAX_WD 1920 /** * Minimum height supported by codec */ #define MIN_HT 16 /** * Maximum height supported by codec */ #define MAX_HT 1920 /*****************************************************************************/ /* Padding sizes */ /*****************************************************************************/ /** * Padding used for top of the frame */ #define PAD_TOP 32 /** * Padding used for bottom of the frame */ #define PAD_BOT 32 /** * Padding used at left of the frame */ #define PAD_LEFT 32 /** * Padding used at right of the frame */ #define PAD_RIGHT 32 /** * Padding for width */ #define PAD_WD (PAD_LEFT + PAD_RIGHT) /** * Padding for height */ #define PAD_HT (PAD_TOP + PAD_BOT) /* * buffer width and height for half pel buffers */ #define HP_BUFF_WD 24 #define HP_BUFF_HT 18 /*****************************************************************************/ /* Number of frame restrictions */ /*****************************************************************************/ /** * Maximum number of reference pictures */ #define MAX_REF_PIC_CNT 2 /** * Minimum number of reference pictures */ #define MIN_REF_PIC_CNT 1 /** * Maximum number of B pictures between two I/P pictures */ #define MAX_NUM_BFRAMES 10 /** * Maximum number of reference buffers in DPB manager */ #define MAX_REF_CNT 32 /*****************************************************************************/ /* Minimum size of inter prediction unit supported by encoder */ /*****************************************************************************/ #define ENC_MIN_PU_SIZE 16 /*****************************************************************************/ /* Num cores releated defs */ /*****************************************************************************/ /** * Maximum number of cores */ #define MAX_NUM_CORES 8 /** * Maximum number of threads for pixel processing */ #define MAX_PROCESS_THREADS MAX_NUM_CORES /** * Maximum process context sets * Used to stagger encoding of MAX_CTXT_SETS in parallel */ #define MAX_CTXT_SETS 1 /** * Maximum number of contexts * Kept as twice the number of threads, to make it easier to initialize the contexts * from master thread */ #define MAX_PROCESS_CTXT MAX_NUM_CORES * MAX_CTXT_SETS /*****************************************************************************/ /* Profile and level restrictions */ /*****************************************************************************/ /** * Max level supported by the codec */ #define MAX_LEVEL IH264_LEVEL_51 /** * Min level supported by the codec */ #define MIN_LEVEL IH264_LEVEL_10 /** * Maximum number of slice headers that are held in memory simultaneously * For single core implementation only 1 slice header is enough. * But for multi-core parsing thread needs to ensure that slice headers are * stored till the last CB in a slice is decoded. * Parsing thread has to wait till last CB of a slice is consumed before reusing * overwriting the slice header * MAX_SLICE_HDR_CNT is assumed to be a power of 2 */ #define LOG2_MAX_SLICE_HDR_CNT 8 #define MAX_SLICE_HDR_CNT (1 << LOG2_MAX_SLICE_HDR_CNT) /* Generic declarations */ #define DEFAULT_MAX_LEVEL 40 #define DEFAULT_RECON_ENABLE 0 #define DEFAULT_RC IVE_RC_STORAGE #define DEFAULT_MAX_FRAMERATE 120000 #define DEFAULT_MAX_BITRATE 20000000 #define DEFAULT_MAX_NUM_BFRAMES 0 #define DEFAULT_MAX_SRCH_RANGE_X 256 #define DEFAULT_MAX_SRCH_RANGE_Y 256 #define DEFAULT_SLICE_PARAM 256 #define DEFAULT_SRC_FRAME_RATE 30000 #define DEFAULT_TGT_FRAME_RATE 30000 #define DEFAULT_BITRATE 6000000 #define DEFAULT_QP_MIN 10 #define DEFAULT_QP_MAX 51 #define DEFAULT_I_QP 25 #define DEFAULT_P_QP 28 #define DEFAULT_B_QP 28 #define DEFAULT_AIR_MODE IVE_AIR_MODE_NONE #define DEFAULT_AIR_REFRESH_PERIOD 30 #define DEFAULT_VBV_DELAY 1000 #define DEFAULT_VBV_SIZE 16800000 /* level 3.1 */ #define DEFAULT_NUM_CORES 1 #define DEFAULT_ME_SPEED_PRESET 100 #define DEFAULT_HPEL 1 #define DEFAULT_QPEL 1 #define DEFAULT_I4 1 #define DEFAULT_I8 0 #define DEFAULT_I16 1 #define DEFAULT_ENABLE_FAST_SAD 0 #define DEFAULT_ENABLE_SATQD 1 #define DEFAULT_MIN_SAD_ENABLE 0 #define DEFAULT_MIN_SAD_DISABLE -1 #define DEFAULT_SRCH_RNG_X 64 #define DEFAULT_SRCH_RNG_Y 48 #define DEFAULT_I_INTERVAL 30 #define DEFAULT_IDR_INTERVAL 1000 #define DEFAULT_B_FRAMES 0 #define DEFAULT_DISABLE_DEBLK_LEVEL 0 #define DEFAULT_PROFILE IV_PROFILE_BASE #define DEFAULT_MIN_INTRA_FRAME_RATE 1 #define DEFAULT_MAX_INTRA_FRAME_RATE 2147483647 #define DEFAULT_MIN_BUFFER_DELAY 30 #define DEFAULT_MAX_BUFFER_DELAY 20000 #define DEFAULT_STRIDE 0 #define DEFAULT_ENC_SPEED_PRESET IVE_USER_DEFINED #define DEFAULT_PRE_ENC_ME 0 #define DEFAULT_PRE_ENC_IPE 0 #define DEFAULT_ENTROPY_CODING_MODE 0 /** Maximum number of entries in input buffer list */ #define MAX_INP_BUF_LIST_ENTRIES 32 /** Maximum number of entries in output buffer list */ #define MAX_OUT_BUF_LIST_ENTRIES 32 /** Maximum number of entries in recon buffer list used within the encoder */ #define MAX_REC_LIST_ENTRIES 16 /** Number of buffers created to hold half-pel planes for every reference buffer */ #define HPEL_PLANES_CNT 1 /** Number of buffers Needed for SUBPEL and BIPRED computation */ #define SUBPEL_BUFF_CNT 4 /** ***************************************************************************** * Macro to compute total size required to hold on set of scaling matrices ***************************************************************************** */ #define SCALING_MAT_SIZE(m_scaling_mat_size) \ { \ m_scaling_mat_size = 6 * TRANS_SIZE_4 * TRANS_SIZE_4; \ m_scaling_mat_size += 6 * TRANS_SIZE_8 * TRANS_SIZE_8; \ m_scaling_mat_size += 6 * TRANS_SIZE_16 * TRANS_SIZE_16; \ m_scaling_mat_size += 2 * TRANS_SIZE_32 * TRANS_SIZE_32; \ } /** ****************************************************************************** * @brief Macros to get raster scan position of a block[8x8] / sub block[4x4] ****************************************************************************** */ #define GET_BLK_RASTER_POS_X(x) ((x & 0x01)) #define GET_BLK_RASTER_POS_Y(y) ((y >> 1)) #define GET_SUB_BLK_RASTER_POS_X(x) ((x & 0x01)) #define GET_SUB_BLK_RASTER_POS_Y(y) ((y >> 1)) #define NUM_RC_MEMTABS 17 /** *************************************************************************** * Enum to hold various mem records being request **************************************************************************** */ enum { /** * Codec Object at API level */ MEM_REC_IV_OBJ, /** * Codec context */ MEM_REC_CODEC, /** * Cabac context */ MEM_REC_CABAC, /** * Cabac context_mb_info */ MEM_REC_CABAC_MB_INFO, /** * entropy context */ MEM_REC_ENTROPY, /** * Buffer to hold coeff data */ MEM_REC_MB_COEFF_DATA, /** * Buffer to hold coeff data */ MEM_REC_MB_HEADER_DATA, /** * Motion vector bank */ MEM_REC_MVBANK, /** * Motion vector bits */ MEM_REC_MVBITS, /** * Holds mem records passed to the codec. */ MEM_REC_BACKUP, /** * Holds SPS */ MEM_REC_SPS, /** * Holds PPS */ MEM_REC_PPS, /** * Holds Slice Headers */ MEM_REC_SLICE_HDR, /** * Contains map indicating slice index per MB basis */ MEM_REC_SLICE_MAP, /** * Holds thread handles */ MEM_REC_THREAD_HANDLE, /** * Holds control call mutex */ MEM_REC_CTL_MUTEX, /** * Holds entropy call mutex */ MEM_REC_ENTROPY_MUTEX, /** * Holds memory for Process JOB Queue */ MEM_REC_PROC_JOBQ, /** * Holds memory for Entropy JOB Queue */ MEM_REC_ENTROPY_JOBQ, /** * Contains status map indicating processing status per MB basis */ MEM_REC_PROC_MAP, /** * Contains status map indicating deblocking status per MB basis */ MEM_REC_DBLK_MAP, /* * Contains AIR map and mask */ MEM_REC_AIR_MAP, /** * Contains status map indicating ME status per MB basis */ MEM_REC_ME_MAP, /** * Holds dpb manager context */ MEM_REC_DPB_MGR, /** * Holds intermediate buffers needed during processing stage * Memory for process contexts is allocated in this memtab */ MEM_REC_PROC_SCRATCH, /** * Holds buffers for vert_bs, horz_bs and QP (all frame level) */ MEM_REC_QUANT_PARAM, /** * Holds top row syntax information */ MEM_REC_TOP_ROW_SYN_INFO, /** * Holds buffers for vert_bs, horz_bs and QP (all frame level) */ MEM_REC_BS_QP, /** * Holds input buffer manager context */ MEM_REC_INP_PIC, /** * Holds output buffer manager context */ MEM_REC_OUT, /** * Holds picture buffer manager context and array of pic_buf_ts * Also holds reference picture buffers in non-shared mode */ MEM_REC_REF_PIC, /* * Mem record for color space conversion */ MEM_REC_CSC, /** * NMB info struct */ MEM_REC_MB_INFO_NMB, /** * Rate control of memory records. */ MEM_REC_RC, /** * Place holder to compute number of memory records. */ MEM_REC_CNT = MEM_REC_RC + NUM_RC_MEMTABS, /* * Do not add anything below */ }; #define DISABLE_DEBLOCK_INTERVAL 8 /** **************************************************************************** * Disable deblock levels * Level 0 enables deblocking completely and level 4 disables completely * Other levels are intermediate values to control deblocking level **************************************************************************** */ enum { /** * Enable deblocking completely */ DISABLE_DEBLK_LEVEL_0, /** * Disable only within MB edges - Not supported currently */ DISABLE_DEBLK_LEVEL_1, /** * Enable deblocking once in DEBLOCK_INTERVAL number of pictures * and for I slices */ DISABLE_DEBLK_LEVEL_2, /** * Enable deblocking only for I slices */ DISABLE_DEBLK_LEVEL_3, /** * Disable deblocking completely */ DISABLE_DEBLK_LEVEL_4 }; /** **************************************************************************** * Number of buffers for I/O based on format **************************************************************************** */ /** Minimum number of input buffers */ #define MIN_INP_BUFS 2 /** Minimum number of output buffers */ #define MIN_OUT_BUFS 1 /** Minimum number of components in bitstream buffer */ #define MIN_BITS_BUFS_COMP 1 /** Minimum number of components in raw buffer */ #define MIN_RAW_BUFS_420_COMP 3 #define MIN_RAW_BUFS_422ILE_COMP 1 #define MIN_RAW_BUFS_RGB565_COMP 1 #define MIN_RAW_BUFS_RGBA8888_COMP 1 #define MIN_RAW_BUFS_420SP_COMP 2 /** Maximum number of active config paramter sets */ #define MAX_ACTIVE_CONFIG_PARAMS 32 /** ****************************************************************************** * @brief Thresholds for luma & chroma to determine if the 8x8 subblock needs * to be encoded or skipped ****************************************************************************** */ #define LUMA_SUB_BLOCK_SKIP_THRESHOLD 4 #define LUMA_BLOCK_SKIP_THRESHOLD 5 #define CHROMA_BLOCK_SKIP_THRESHOLD 4 /** ****************************************************************************** * @brief defines the first byte of a NAL unit * forbidden zero bit - nal_ref_idc - nal_unit_type ****************************************************************************** */ /* [0 - 11 - 00111] */ #define NAL_SPS_FIRST_BYTE 0x67 /* [0 - 11 - 01000] */ #define NAL_PPS_FIRST_BYTE 0x68 /* [0 - 11 - 00001] */ #define NAL_SLICE_FIRST_BYTE 0x61 /* [0 - 00 - 00001] */ #define NAL_NON_REF_SLICE_FIRST_BYTE 0x01 /* [0 - 11 - 00101] */ #define NAL_IDR_SLICE_FIRST_BYTE 0x65 /* [0 - 00 - 01100] */ #define NAL_FILLER_FIRST_BYTE 0x0C /* [0 - 00 - 00110] */ #define NAL_SEI_FIRST_BYTE 0x06 #define H264_ALLOC_INTER_FRM_INTV 2 #define H264_MPEG_QP_MAP 255 #define MPEG2_QP_ELEM (H264_MPEG_QP_MAP + 1) #define H264_QP_ELEM (MAX_H264_QP + 1) #define H264_INIT_QUANT_I 26 #define H264_INIT_QUANT_P 34 #endif /*IH264E_DEFS_H_*/