Dirac - A Video Codec

Created by the British Broadcasting Corporation.


rate_control.h

Go to the documentation of this file.
00001 /* ***** BEGIN LICENSE BLOCK *****
00002 *
00003 * $Id: rate_control.h,v 1.7 2008/01/31 11:25:18 tjdwave Exp $ $Name: Dirac_1_0_2 $
00004 *
00005 * Version: MPL 1.1/GPL 2.0/LGPL 2.1
00006 *
00007 * The contents of this file are subject to the Mozilla Public License
00008 * Version 1.1 (the "License"); you may not use this file except in compliance
00009 * with the License. You may obtain a copy of the License at
00010 * http://www.mozilla.org/MPL/
00011 *
00012 * Software distributed under the License is distributed on an "AS IS" basis,
00013 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
00014 * the specific language governing rights and limitations under the License.
00015 *
00016 * The Original Code is BBC Research and Development code.
00017 *
00018 * The Initial Developer of the Original Code is the British Broadcasting
00019 * Corporation.
00020 * Portions created by the Initial Developer are Copyright (C) 2004.
00021 * All Rights Reserved.
00022 *
00023 * Contributor(s): Myo Tun (Original Author, myo.tun@brunel.ac.uk)
00024 *                 Jonathan Loo (Jonathan.Loo@brunel.ac.uk)
00025 *          School of Engineering and Design, Brunel University, UK
00026 *
00027 * Alternatively, the contents of this file may be used under the terms of
00028 * the GNU General Public License Version 2 (the "GPL"), or the GNU Lesser
00029 * Public License Version 2.1 (the "LGPL"), in which case the provisions of
00030 * the GPL or the LGPL are applicable instead of those above. If you wish to
00031 * allow use of your version of this file only under the terms of the either
00032 * the GPL or LGPL and not to allow others to use your version of this file
00033 * under the MPL, indicate your decision by deleting the provisions above
00034 * and replace them with the notice and other provisions required by the GPL
00035 * or LGPL. If you do not delete the provisions above, a recipient may use
00036 * your version of this file under the terms of any one of the MPL, the GPL
00037 * or the LGPL.
00038 * ***** END LICENSE BLOCK ***** */
00039 
00040 
00041 //Compression of an individual component,
00042 //after motion compensation if appropriate
00044 
00045 #ifndef _RATE_CONTROL_H_
00046 #define _RATE_CONTROL_H_
00047 
00048 #include <libdirac_common/common.h>
00049 
00050 namespace dirac
00051 {
00052     class FrameComplexity
00053     {
00054     public:
00056         FrameComplexity();
00057 
00059         int IComplexity() {return m_XI;}
00060 
00062         int L1Complexity() {return m_XL1;}
00063 
00065         int L2Complexity() {return m_XL2;}
00066 
00068         void SetIComplexity(int cpx) {m_XI = cpx;}
00069 
00071         void SetL1Complexity(int cpx) {m_XL1 = cpx;}
00072 
00074         void SetL2Complexity(int cpx) {m_XL2 = cpx;}
00075 
00076 
00077     private:
00078 
00080         int m_XI;
00081 
00083         int m_XL1;
00084 
00086         int m_XL2;
00087     };
00088 
00089 
00091     class RateController
00092     {
00093     public:
00094 
00096         RateController(int trate, SourceParams& srcp, EncoderParams& encp);
00097 
00098 
00100         void CalcNextQualFactor(const PictureParams& fparams, int num_bits);
00101 
00103         void CalcNextIntraQualFactor();
00104 
00106         void SetCutPictureQualFactor();
00107 
00109         double IntraQualFactor() {return m_I_qf;}
00110 
00112         double QualFactor() {return m_qf;}
00113         
00115         void Report();
00116 
00117 
00118     private:
00119 
00120         double TargetSubgroupRate();
00121 
00122         double ProjectedSubgroupRate();
00123 
00125         void Allocate(const int fnum);
00126 
00128         void CalcTotalBits(const SourceParams& sourceparams);
00129 
00131         void SetIntraQualFactor(double value){m_I_qf = value;}
00132 
00134         void SetFrameDistribution();
00135 
00137         float ReviewQualityFactor( const float qfac, const long int num_bits );
00138 
00140         float ClipQualityFactor( const float qfac );
00141 
00143         void UpdateBuffer( const long int num_bits );
00144 
00145 
00146     private:
00147 
00149         double m_qf;
00150 
00152         double m_I_qf;
00153 
00155         double m_I_qf_long_term;
00156 
00158         const int m_target_rate;
00159 
00161         long int m_Iframe_bits;
00162 
00164         long int m_L1frame_bits;
00165 
00167         long int m_L2frame_bits;
00168 
00170         int m_num_Iframe;
00171 
00173         int m_num_L1frame;
00174 
00176         int m_num_L2frame;
00177 
00179         long int m_total_GOP_bits;
00180 
00182         long int m_picture_bits;
00183 
00185         const long int m_buffer_size;
00186 
00188         long int m_buffer_bits;
00189 
00191         long int m_old_buffer_bits;
00192 
00194         double m_buffer_rate_of_change;
00195 
00197         long int m_GOP_target;
00198 
00200         double m_GOP_duration;
00201 
00203         EncoderParams& m_encparams;
00204 
00206         FrameComplexity m_frame_complexity;
00207 
00209         int m_fcount;
00210 
00211         // Indicated whether a sequence is being coded intra only or not
00212         bool m_intra_only;
00213 
00214         // Sum of complexity of L2 frames
00215         int m_L2_complexity_sum;
00216 
00217     };
00218 
00219 
00220 }// namespace dirac
00221 #endif

© 2004 British Broadcasting Corporation. Dirac code licensed under the Mozilla Public License (MPL) Version 1.1.
HTML documentation generated by Dimitri van Heesch's excellent Doxygen tool.