H.264/AVC Reference Software Encoder: parsetcommon.h Source File

00001 
00002 /*!
00003 **************************************************************************************
00004 * \file
00005 *    parsetcommon.h
00006 * \brief
00007 *    Picture and Sequence Parameter Sets, structures common to encoder and decoder
00008 *
00009 * \date 25 November 2002
00010 * \author
00011 *    Main contributors (see contributors.h for copyright, address and affiliation details)
00012 *      - Stephan Wenger        <stewe@cs.tu-berlin.de>
00013 ***************************************************************************************
00014 */
00015 
00016 
00017 
00018 // In the JVT syntax, frequently flags are used that indicate the presence of
00019 // certain pieces of information in the NALU.  Here, these flags are also
00020 // present.  In the encoder, those bits indicate that the values signaled to
00021 // be present are meaningful and that this part of the syntax should be
00022 // written to the NALU.  In the decoder, the flag indicates that information
00023 // was received from the decoded NALU and should be used henceforth.
00024 // The structure names were chosen as indicated in the JVT syntax
00025 
00026 #ifndef _PARSETCOMMON_H_
00027 #define _PARSETCOMMON_H_
00028 
00029 #define MAXIMUMPARSETRBSPSIZE   1500
00030 #define MAXIMUMPARSETNALUSIZE   1500
00031 
00032 #define MAXSPS  32
00033 #define MAXPPS  256
00034 
00035 //! Boolean Type
00036 #ifdef FALSE
00037 #  define Boolean int
00038 #else
00039 typedef enum {
00040   FALSE,
00041   TRUE
00042 } Boolean;
00043 #endif
00044 
00045 #define MAXIMUMVALUEOFcpb_cnt   32
00046 typedef struct
00047 {
00048   unsigned int cpb_cnt_minus1;                                   // ue(v)
00049   unsigned int bit_rate_scale;                                   // u(4)
00050   unsigned int cpb_size_scale;                                   // u(4)
00051   unsigned int bit_rate_value_minus1 [MAXIMUMVALUEOFcpb_cnt];  // ue(v)
00052   unsigned int cpb_size_value_minus1 [MAXIMUMVALUEOFcpb_cnt];  // ue(v)
00053   unsigned int cbr_flag              [MAXIMUMVALUEOFcpb_cnt];  // u(1)
00054   unsigned int initial_cpb_removal_delay_length_minus1;          // u(5)
00055   unsigned int cpb_removal_delay_length_minus1;                  // u(5)
00056   unsigned int dpb_output_delay_length_minus1;                   // u(5)
00057   unsigned int time_offset_length;                               // u(5)
00058 } hrd_parameters_t;
00059 
00060 
00061 typedef struct
00062 {
00063   Boolean      aspect_ratio_info_present_flag;                   // u(1)
00064   unsigned int aspect_ratio_idc;                               // u(8)
00065   unsigned int sar_width;                                    // u(16)
00066   unsigned int sar_height;                                   // u(16)
00067   Boolean      overscan_info_present_flag;                       // u(1)
00068   Boolean      overscan_appropriate_flag;                      // u(1)
00069   Boolean      video_signal_type_present_flag;                   // u(1)
00070   unsigned int video_format;                                   // u(3)
00071   Boolean      video_full_range_flag;                          // u(1)
00072   Boolean      colour_description_present_flag;                // u(1)
00073   unsigned int colour_primaries;                             // u(8)
00074   unsigned int transfer_characteristics;                     // u(8)
00075   unsigned int matrix_coefficients;                          // u(8)
00076   Boolean      chroma_location_info_present_flag;                // u(1)
00077   unsigned int  chroma_sample_loc_type_top_field;               // ue(v)
00078   unsigned int  chroma_sample_loc_type_bottom_field;            // ue(v)
00079   Boolean      timing_info_present_flag;                         // u(1)
00080   unsigned int num_units_in_tick;                              // u(32)
00081   unsigned int time_scale;                                     // u(32)
00082   Boolean      fixed_frame_rate_flag;                          // u(1)
00083   Boolean      nal_hrd_parameters_present_flag;                  // u(1)
00084   hrd_parameters_t nal_hrd_parameters;                      // hrd_paramters_t
00085   Boolean      vcl_hrd_parameters_present_flag;                  // u(1)
00086   hrd_parameters_t vcl_hrd_parameters;                      // hrd_paramters_t
00087   // if ((nal_hrd_parameters_present_flag || (vcl_hrd_parameters_present_flag))
00088   Boolean      low_delay_hrd_flag;                             // u(1)
00089   Boolean      pic_struct_present_flag;                        // u(1)
00090   Boolean      bitstream_restriction_flag;                       // u(1)
00091   Boolean      motion_vectors_over_pic_boundaries_flag;        // u(1)
00092   unsigned int max_bytes_per_pic_denom;                        // ue(v)
00093   unsigned int max_bits_per_mb_denom;                          // ue(v)
00094   unsigned int log2_max_mv_length_vertical;                    // ue(v)
00095   unsigned int log2_max_mv_length_horizontal;                  // ue(v)
00096   unsigned int num_reorder_frames;                             // ue(v)
00097   unsigned int max_dec_frame_buffering;                        // ue(v)
00098 } vui_seq_parameters_t;
00099 
00100 
00101 #define MAXnum_slice_groups_minus1  8
00102 typedef struct
00103 {
00104   Boolean   Valid;                  // indicates the parameter set is valid
00105   unsigned int pic_parameter_set_id;                             // ue(v)
00106   unsigned int seq_parameter_set_id;                             // ue(v)
00107   Boolean   entropy_coding_mode_flag;                         // u(1)
00108 
00109   Boolean   transform_8x8_mode_flag;                          // u(1)
00110 
00111   Boolean   pic_scaling_matrix_present_flag;                  // u(1)
00112   int       pic_scaling_list_present_flag[12];                 // u(1)
00113 
00114   int       ScalingList4x4[6][16];                            // se(v)
00115   int       ScalingList8x8[6][64];                            // se(v)
00116   Boolean   UseDefaultScalingMatrix4x4Flag[6];
00117   Boolean   UseDefaultScalingMatrix8x8Flag[6];
00118 
00119   // if( pic_order_cnt_type < 2 )  in the sequence parameter set
00120   Boolean      bottom_field_pic_order_in_frame_present_flag;                           // u(1)
00121   unsigned int num_slice_groups_minus1;                          // ue(v)
00122   unsigned int slice_group_map_type;                        // ue(v)
00123   // if( slice_group_map_type = = 0 )
00124   unsigned int run_length_minus1[MAXnum_slice_groups_minus1]; // ue(v)
00125   // else if( slice_group_map_type = = 2 )
00126   unsigned int top_left[MAXnum_slice_groups_minus1];         // ue(v)
00127   unsigned int bottom_right[MAXnum_slice_groups_minus1];     // ue(v)
00128   // else if( slice_group_map_type = = 3 || 4 || 5
00129   Boolean   slice_group_change_direction_flag;            // u(1)
00130   unsigned int slice_group_change_rate_minus1;               // ue(v)
00131   // else if( slice_group_map_type = = 6 )
00132   unsigned int pic_size_in_map_units_minus1;                 // ue(v)
00133   byte      *slice_group_id;                              // complete MBAmap u(v)
00134 
00135   char num_ref_idx_l0_active_minus1;                     // ue(v)
00136   char num_ref_idx_l1_active_minus1;                     // ue(v)
00137   byte      weighted_pred_flag;                               // u(1)
00138   byte      weighted_bipred_idc;                              // u(2)
00139   int       pic_init_qp_minus26;                              // se(v)
00140   int       pic_init_qs_minus26;                              // se(v)
00141   int       chroma_qp_index_offset;                           // se(v)
00142 
00143   int       cb_qp_index_offset;                               // se(v)
00144   int       cr_qp_index_offset;                               // se(v)
00145   int       second_chroma_qp_index_offset;                    // se(v)
00146 
00147   Boolean   deblocking_filter_control_present_flag;           // u(1)
00148   Boolean   constrained_intra_pred_flag;                      // u(1)
00149   Boolean   redundant_pic_cnt_present_flag;                   // u(1)
00150   Boolean   vui_pic_parameters_flag;                          // u(1)
00151 } pic_parameter_set_rbsp_t;
00152 
00153 
00154 #define MAXnum_ref_frames_in_pic_order_cnt_cycle  256
00155 typedef struct
00156 {
00157   Boolean   Valid;                  // indicates the parameter set is valid
00158 
00159   unsigned int profile_idc;                                      // u(8)
00160   Boolean   constrained_set0_flag;                            // u(1)
00161   Boolean   constrained_set1_flag;                            // u(1)
00162   Boolean   constrained_set2_flag;                            // u(1)
00163   Boolean   constrained_set3_flag;                            // u(1)
00164   unsigned  int level_idc;                                        // u(8)
00165   unsigned  int seq_parameter_set_id;                             // ue(v)
00166   unsigned  int chroma_format_idc;                                // ue(v)
00167 
00168   Boolean   seq_scaling_matrix_present_flag;                   // u(1)
00169   int       seq_scaling_list_present_flag[12];                 // u(1)
00170 
00171   unsigned int bit_depth_luma_minus8;                            // ue(v)
00172   unsigned int bit_depth_chroma_minus8;                          // ue(v)
00173   unsigned int log2_max_frame_num_minus4;                        // ue(v)
00174   unsigned int pic_order_cnt_type;
00175   // if( pic_order_cnt_type == 0 )
00176   unsigned int log2_max_pic_order_cnt_lsb_minus4;                 // ue(v)
00177   // else if( pic_order_cnt_type == 1 )
00178   Boolean delta_pic_order_always_zero_flag;               // u(1)
00179   int     offset_for_non_ref_pic;                         // se(v)
00180   int     offset_for_top_to_bottom_field;                 // se(v)
00181   unsigned int num_ref_frames_in_pic_order_cnt_cycle;          // ue(v)
00182   // for( i = 0; i < num_ref_frames_in_pic_order_cnt_cycle; i++ )
00183   int   offset_for_ref_frame[MAXnum_ref_frames_in_pic_order_cnt_cycle];   // se(v)
00184   unsigned char num_ref_frames;                                   // ue(v)
00185   Boolean   gaps_in_frame_num_value_allowed_flag;             // u(1)
00186   unsigned int pic_width_in_mbs_minus1;                          // ue(v)
00187   unsigned int pic_height_in_map_units_minus1;                   // ue(v)
00188   Boolean   frame_mbs_only_flag;                              // u(1)
00189   // if( !frame_mbs_only_flag )
00190   Boolean   mb_adaptive_frame_field_flag;                   // u(1)
00191   Boolean   direct_8x8_inference_flag;                        // u(1)
00192   Boolean   frame_cropping_flag;                              // u(1)
00193   unsigned int frame_cropping_rect_left_offset;                // ue(v)
00194   unsigned int frame_cropping_rect_right_offset;               // ue(v)
00195   unsigned int frame_cropping_rect_top_offset;                 // ue(v)
00196   unsigned int frame_cropping_rect_bottom_offset;              // ue(v)
00197   Boolean   vui_parameters_present_flag;                      // u(1)
00198   vui_seq_parameters_t vui_seq_parameters;                  // vui_seq_parameters_t
00199   unsigned  separate_colour_plane_flag;                       // u(1)
00200 } seq_parameter_set_rbsp_t;
00201 
00202 extern pic_parameter_set_rbsp_t *AllocPPS (void);
00203 extern seq_parameter_set_rbsp_t *AllocSPS (void);
00204 
00205 extern void FreePPS (pic_parameter_set_rbsp_t *pps);
00206 extern void FreeSPS (seq_parameter_set_rbsp_t *sps);
00207 
00208 #endif