/****************************************************************************** * * 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 Name : ih264d_sei.h */ /* */ /* Description : This file contains routines to parse SEI NAL's */ /* */ /* List of Functions : */ /* */ /* Issues / Problems : None */ /* */ /* Revision History : */ /* */ /* DD MM YYYY Author(s) Changes (Describe the changes made) */ /* 25 05 2005 NS Draft */ /* */ /*****************************************************************************/ #ifndef _IH264D_SEI_H_ #define _IH264D_SEI_H_ #include "ih264_typedefs.h" #include "ih264_macros.h" #include "ih264_platform_macros.h" #include "ih264d_bitstrm.h" #include "ih264d_structs.h" #include "ih264d.h" #define SEI_BUF_PERIOD 0 #define SEI_PIC_TIMING 1 #define SEI_PAN_SCAN_RECT 2 #define SEI_FILLER 3 #define SEI_UD_REG_T35 4 #define SEI_UD_UN_REG 5 #define SEI_RECOVERY_PT 6 #define SEI_DEC_REF_MARK 7 #define SEI_SPARE_PIC 8 #define SEI_SCENE_INFO 9 #define SEI_SUB_SEQN_INFO 10 #define SEI_SUB_SEQN_LAY_CHAR 11 #define SEI_SUB_SEQN_CHAR 12 #define SEI_FULL_FRAME_FREEZE 13 #define SEI_FULL_FRAME_FREEZE_REL 14 #define SEI_FULL_FRAME_SNAP_SHOT 15 #define SEI_PROG_REF_SEGMENT_START 16 #define SEI_PROG_REF_SEGMENT_END 17 #define SEI_MOT_CON_SLICE_GRP_SET 18 #define SEI_FILM_GRAIN_CHARACTERISTICS 19 #define SEI_MASTERING_DISP_COL_VOL 137 #define SEI_CONTENT_LIGHT_LEVEL_DATA 144 #define SEI_AMBIENT_VIEWING_ENVIRONMENT 148 #define SEI_CONTENT_COLOR_VOLUME 149 #define SEI_SHUTTER_INTERVAL_INFO 205 /* Declaration of dec_struct_t to avoid CCS compilation Error */ struct _DecStruct; WORD32 ih264d_parse_sei_message(struct _DecStruct *ps_dec, dec_bit_stream_t *ps_bitstrm); typedef struct { UWORD8 u1_seq_parameter_set_id; UWORD32 u4_initial_cpb_removal_delay; UWORD32 u4_nitial_cpb_removal_delay_offset; } buf_period_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 illuminance 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 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; 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; struct _sei { UWORD8 u1_seq_param_set_id; buf_period_t s_buf_period; UWORD8 u1_pic_struct; UWORD16 u2_recovery_frame_cnt; UWORD8 u1_exact_match_flag; UWORD8 u1_broken_link_flag; UWORD8 u1_changing_slice_grp_idc; UWORD8 u1_is_valid; /** * 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; /** * shutter interval info present flag */ UWORD8 u1_sei_sii_params_present_flag; /* * SII parameters */ sei_sii_params_t s_sei_sii_params; /** * film grain params info present flag */ UWORD8 u1_sei_fgc_params_present_flag; /* * film grain characteristics parameters */ sei_fgc_params_t s_sei_fgc_params; }; typedef struct _sei sei; WORD32 ih264d_export_sei_mdcv_params(ivd_sei_decode_op_t *ps_sei_decode_op, sei *ps_sei, sei *ps_sei_export); WORD32 ih264d_export_sei_cll_params(ivd_sei_decode_op_t *ps_sei_decode_op, sei *ps_sei, sei *ps_sei_export); WORD32 ih264d_export_sei_ave_params(ivd_sei_decode_op_t *ps_sei_decode_op, sei *ps_sei, sei *ps_sei_export); WORD32 ih264d_export_sei_ccv_params(ivd_sei_decode_op_t *ps_sei_decode_op, sei *ps_sei, sei *ps_sei_export); WORD32 ih264d_export_sei_sii_params(ivd_sei_decode_op_t *ps_sei_decode_op, sei *ps_sei, sei *ps_sei_export); WORD32 ih264d_export_sei_fgc_params(ivd_sei_decode_op_t *ps_sei_decode_op, sei *ps_sei, sei *ps_sei_export); #endif /* _IH264D_SEI_H_ */