libavcodec/evc_ps.h

   1 /*
   2  * This file is part of FFmpeg.
   3  *
   4  * FFmpeg is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * FFmpeg is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with FFmpeg; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  17  */
  18
  19 /**
  20  * @file
  21  * EVC decoder/parser shared code
  22  */
  23
  24 #ifndef AVCODEC_EVC_PS_H
  25 #define AVCODEC_EVC_PS_H
  26
  27 #include <stdint.h>
  28
  29 #include "evc.h"
  30 #include "get_bits.h"
  31
  32 #define EVC_MAX_QP_TABLE_SIZE   58
  33 #define NUM_CPB                 32
  34
  35 // rpl structure
  36 typedef struct RefPicListStruct {
  37     uint32_t ref_pic_num;
  38     uint32_t ref_pics[EVC_MAX_NUM_REF_PICS];
  39 } RefPicListStruct;
  40
  41 // chromaQP table structure to be signalled in SPS
  42 typedef struct ChromaQpTable {
  43     uint8_t chroma_qp_table_present_flag;            // u(1)
  44     uint8_t same_qp_table_for_chroma;                // u(1)
  45     uint8_t global_offset_flag;                      // u(1)
  46     uint8_t num_points_in_qp_table_minus1[2];        // ue(v)
  47     uint8_t delta_qp_in_val_minus1[2][EVC_MAX_QP_TABLE_SIZE]; // u(6)
  48     int delta_qp_out_val[2][EVC_MAX_QP_TABLE_SIZE];         // se(v)
  49 } ChromaQpTable;
  50
  51 // Hypothetical Reference Decoder (HRD) parameters, part of VUI
  52 typedef struct HRDParameters {
  53     uint8_t cpb_cnt_minus1;                          // ue(v)
  54     uint8_t bit_rate_scale;                          // u(4)
  55     uint8_t cpb_size_scale;                          // u(4)
  56     uint32_t bit_rate_value_minus1[NUM_CPB];         // ue(v)
  57     uint32_t cpb_size_value_minus1[NUM_CPB];         // ue(v)
  58     uint8_t cbr_flag[NUM_CPB];                       // u(1)
  59     uint8_t initial_cpb_removal_delay_length_minus1; // u(5)
  60     uint8_t cpb_removal_delay_length_minus1;         // u(5)
  61     uint8_t dpb_output_delay_length_minus1;          // u(5)
  62     uint8_t time_offset_length;                      // u(5)
  63 } HRDParameters;
  64
  65 // video usability information (VUI) part of SPS
  66 typedef struct VUIParameters {
  67     uint8_t aspect_ratio_info_present_flag;          // u(1)
  68     uint8_t aspect_ratio_idc;                        // u(8)
  69     uint16_t sar_width;                              // u(16)
  70     uint16_t sar_height;                             // u(16)
  71     uint8_t overscan_info_present_flag;              // u(1)
  72     uint8_t overscan_appropriate_flag;               // u(1)
  73     uint8_t video_signal_type_present_flag;          // u(1)
  74     uint8_t video_format;                            // u(3)
  75     uint8_t video_full_range_flag;                   // u(1)
  76     uint8_t colour_description_present_flag;         // u(1)
  77     uint8_t colour_primaries;                        // u(8)
  78     uint8_t transfer_characteristics;                // u(8)
  79     uint8_t matrix_coefficients;                     // u(8)
  80     uint8_t chroma_loc_info_present_flag;            // u(1)
  81     uint8_t chroma_sample_loc_type_top_field;        // ue(v)
  82     uint8_t chroma_sample_loc_type_bottom_field;     // ue(v)
  83     uint8_t neutral_chroma_indication_flag;          // u(1)
  84     uint8_t field_seq_flag;                          // u(1)
  85     uint8_t timing_info_present_flag;                // u(1)
  86     uint32_t num_units_in_tick;                      // u(32)
  87     uint32_t time_scale;                             // u(32)
  88     uint8_t fixed_pic_rate_flag;                     // u(1)
  89     uint8_t nal_hrd_parameters_present_flag;         // u(1)
  90     uint8_t vcl_hrd_parameters_present_flag;         // u(1)
  91     uint8_t low_delay_hrd_flag;                      // u(1)
  92     uint8_t pic_struct_present_flag;                 // u(1)
  93     uint8_t bitstream_restriction_flag;              // u(1)
  94     uint8_t motion_vectors_over_pic_boundaries_flag; // u(1)
  95     uint8_t max_bytes_per_pic_denom;                 // ue(v)
  96     uint8_t max_bits_per_mb_denom;                   // ue(v)
  97     uint8_t log2_max_mv_length_horizontal;           // ue(v)
  98     uint8_t log2_max_mv_length_vertical;             // ue(v)
  99     uint32_t num_reorder_pics;                       // ue(v)
 100     uint32_t max_dec_pic_buffering;                  // ue(v)
 101
 102     HRDParameters hrd_parameters;
 103 } VUIParameters;
 104
 105 // The sturcture reflects SPS RBSP(raw byte sequence payload) layout
 106 // @see ISO_IEC_23094-1 section 7.3.2.1
 107 //
 108 // The following descriptors specify the parsing process of each element
 109 // u(n) - unsigned integer using n bits
 110 // ue(v) - unsigned integer 0-th order Exp_Golomb-coded syntax element with the left bit first
 111 typedef struct EVCParserSPS {
 112     uint8_t sps_seq_parameter_set_id;                // ue(v)
 113     uint8_t profile_idc;                             // u(8)
 114     uint8_t level_idc;                               // u(8)
 115     uint32_t toolset_idc_h;                          // u(32)
 116     uint32_t toolset_idc_l;                          // u(32)
 117     uint8_t chroma_format_idc;                       // ue(v)
 118     uint32_t pic_width_in_luma_samples;              // ue(v)
 119     uint32_t pic_height_in_luma_samples;             // ue(v)
 120     uint8_t bit_depth_luma_minus8;                  // ue(v)
 121     uint8_t bit_depth_chroma_minus8;                // ue(v)
 122
 123     uint8_t sps_btt_flag;                            // u(1)
 124     uint32_t log2_ctu_size_minus2;                   // ue(v)
 125     uint32_t log2_min_cb_size_minus2;                // ue(v)
 126     uint32_t log2_diff_ctu_max_14_cb_size;           // ue(v)
 127     uint32_t log2_diff_ctu_max_tt_cb_size;           // ue(v)
 128     uint32_t log2_diff_min_cb_min_tt_cb_size_minus2; // ue(v)
 129
 130     uint8_t sps_suco_flag;                           // u(1)
 131     uint32_t log2_diff_ctu_size_max_suco_cb_size;    // ue(v)
 132     uint32_t log2_diff_max_suco_min_suco_cb_size;    // ue(v)
 133
 134     uint8_t sps_admvp_flag;                          // u(1)
 135     uint8_t sps_affine_flag;                         // u(1)
 136     uint8_t sps_amvr_flag;                           // u(1)
 137     uint8_t sps_dmvr_flag;                           // u(1)
 138     uint8_t sps_mmvd_flag;                           // u(1)
 139     uint8_t sps_hmvp_flag;                           // u(1)
 140
 141     uint8_t sps_eipd_flag;                           // u(1)
 142     uint8_t sps_ibc_flag;                            // u(1)
 143     uint32_t log2_max_ibc_cand_size_minus2;          // ue(v)
 144
 145     uint8_t sps_cm_init_flag;                        // u(1)
 146     uint8_t sps_adcc_flag;                           // u(1)
 147
 148     uint8_t sps_iqt_flag;                            // u(1)
 149     uint8_t sps_ats_flag;                            // u(1)
 150
 151     uint8_t sps_addb_flag;                           // u(1)
 152     uint8_t sps_alf_flag;                            // u(1)
 153     uint8_t sps_htdf_flag;                           // u(1)
 154     uint8_t sps_rpl_flag;                            // u(1)
 155     uint8_t sps_pocs_flag;                           // u(1)
 156     uint8_t sps_dquant_flag;                         // u(1)
 157     uint8_t sps_dra_flag;                            // u(1)
 158
 159     uint32_t log2_max_pic_order_cnt_lsb_minus4;      // ue(v)
 160     uint32_t log2_sub_gop_length;                    // ue(v)
 161     uint32_t log2_ref_pic_gap_length;                // ue(v)
 162
 163     uint8_t max_num_tid0_ref_pics;                   // ue(v)
 164
 165     uint32_t sps_max_dec_pic_buffering_minus1;       // ue(v)
 166     uint8_t long_term_ref_pic_flag;                  // u(1)
 167     uint8_t rpl1_same_as_rpl0_flag;                  // u(1)
 168     uint8_t num_ref_pic_list_in_sps[2];             // ue(v)
 169     struct RefPicListStruct rpls[2][EVC_MAX_NUM_RPLS];
 170
 171     uint8_t picture_cropping_flag;                   // u(1)
 172     uint32_t picture_crop_left_offset;               // ue(v)
 173     uint32_t picture_crop_right_offset;              // ue(v)
 174     uint32_t picture_crop_top_offset;                // ue(v)
 175     uint32_t picture_crop_bottom_offset;             // ue(v)
 176
 177     struct ChromaQpTable chroma_qp_table_struct;
 178
 179     uint8_t vui_parameters_present_flag;             // u(1)
 180
 181     struct VUIParameters vui_parameters;
 182
 183 } EVCParserSPS;
 184
 185 typedef struct EVCParserPPS {
 186     uint8_t pps_pic_parameter_set_id;                              // ue(v)
 187     uint8_t pps_seq_parameter_set_id;                              // ue(v)
 188     uint8_t num_ref_idx_default_active_minus1[2];                  // ue(v)
 189     uint8_t additional_lt_poc_lsb_len;                             // ue(v)
 190     uint8_t rpl1_idx_present_flag;                                 // u(1)
 191     uint8_t single_tile_in_pic_flag;                               // u(1)
 192     uint32_t num_tile_columns_minus1;                              // ue(v)
 193     uint32_t num_tile_rows_minus1;                                 // ue(v)
 194     uint8_t uniform_tile_spacing_flag;                             // u(1)
 195     uint32_t tile_column_width_minus1[EVC_MAX_TILE_COLUMNS];       // ue(v)
 196     uint32_t tile_row_height_minus1[EVC_MAX_TILE_ROWS];            // ue(v)
 197     uint8_t loop_filter_across_tiles_enabled_flag;                 // u(1)
 198     uint32_t tile_offset_len_minus1;                               // ue(v)
 199     uint8_t tile_id_len_minus1;                                    // ue(v)
 200     uint8_t explicit_tile_id_flag;                                 // u(1)
 201     uint32_t tile_id_val[EVC_MAX_TILE_ROWS][EVC_MAX_TILE_COLUMNS]; // u(v)
 202     uint8_t pic_dra_enabled_flag;                                  // u(1)
 203     uint8_t pic_dra_aps_id;                                        // u(5)
 204     uint8_t arbitrary_slice_present_flag;                          // u(1)
 205     uint8_t constrained_intra_pred_flag;                           // u(1)
 206     uint8_t cu_qp_delta_enabled_flag;                              // u(1)
 207     uint32_t log2_cu_qp_delta_area_minus6;                         // ue(v)
 208
 209 } EVCParserPPS;
 210
 211 typedef struct EVCParamSets {
 212     EVCParserSPS *sps[EVC_MAX_SPS_COUNT];
 213     EVCParserPPS *pps[EVC_MAX_PPS_COUNT];
 214 } EVCParamSets;
 215
 216 // @see ISO_IEC_23094-1 (7.3.2.1 SPS RBSP syntax)
 217 int ff_evc_parse_sps(GetBitContext *gb, EVCParamSets *ps);
 218
 219 // @see ISO_IEC_23094-1 (7.3.2.2 SPS RBSP syntax)
 220 int ff_evc_parse_pps(GetBitContext *gb, EVCParamSets *ps);
 221
 222 void ff_evc_ps_free(EVCParamSets *ps);
 223
 224 #endif /* AVCODEC_EVC_PS_H */