# Dirac - A Video Codec

Created by the British Broadcasting Corporation.

# block_match.h

Go to the documentation of this file.

    00001 /* ***** BEGIN LICENSE BLOCK *****
    00002 *
    00003 * $Id: block_match.h,v 1.8 2005/09/27 12:52:47 tjdwave Exp $ $Name: Dirac_0_7_0 $
    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): Thomas Davies (Original Author)
    00024 *
    00025 * Alternatively, the contents of this file may be used under the terms of
    00026 * the GNU General Public License Version 2 (the "GPL"), or the GNU Lesser
    00027 * Public License Version 2.1 (the "LGPL"), in which case the provisions of
    00028 * the GPL or the LGPL are applicable instead of those above. If you wish to
    00029 * allow use of your version of this file only under the terms of the either
    00030 * the GPL or LGPL and not to allow others to use your version of this file
    00031 * under the MPL, indicate your decision by deleting the provisions above
    00032 * and replace them with the notice and other provisions required by the GPL
    00033 * or LGPL. If you do not delete the provisions above, a recipient may use
    00034 * your version of this file under the terms of any one of the MPL, the GPL
    00035 * or the LGPL.
    00036 * ***** END LICENSE BLOCK ***** */
    00037
    00038 #ifndef _BLOCK_MATCH_H_
    00039 #define _BLOCK_MATCH_H_
    00040
    00041 #include <libdirac_motionest/me_utils.h>
    00042 #include <vector>
    00043 //handles the business of finding the best block match
    00044
    00045 namespace dirac
    00046 {
    00047
    00048     typedef std::vector< std::vector< MVector > > CandidateList;
    00049
    00051     /*
    00052         Add a new motion vector list to the set of lists consisting of the
    00053         square neighbourhood [mv.x-xr,mv.x+xr] by
    00054         [mv.y-yr,mv.y+yr]. Vectors that already occur in previous lists are
    00055         not added.
    00056     */
    00057     void AddNewVlist( CandidateList& vect_list , const MVector& mv , const int xr , const int yr );
    00058
    00060     /*
    00061         Add a new motion vector list to the set of lists consisting of the
    00062         vectors of the form (mv.x+m*step,mv.y+n*step) where m lies between
    00063         -xr and xr and n lies between -yr and yr.  Vectors that already occur
    00064         in previous lists are not added.
    00065     */
    00066     void AddNewVlist( CandidateList& vect_list , const MVector& mv , const int xr , const int yr , const int step );
    00067
    00069     /*
    00070         Add a new motion vector list to the set of lists consisting of the
    00071         diagonal neighbourhood of height 2yr+1 pixels and width 2xr+1 centred
    00072         on \param mv.
    00073         Vectors that already occur in previous lists are not added.
    00074     */
    00075     void AddNewVlistD( CandidateList& vect_list , const MVector& mv , const int xr, const int yr);
    00076
    00078
    00082     void AddVect( CandidateList& vect_list , const MVector& mv , const int list_num);
    00083
    00085
    00089     ValueType GetVar(const MVector& mv1,const MVector& mv2);
    00090
    00092
    00098     ValueType GetVar(const std::vector<MVector>& pred_list,const MVector& mv);
    00099
    00100
    00102
    00103     // Subsumes FindBestMatch and FindBestMatchSubpel
    00104     class BlockMatcher
    00105     {
    00106     public:
    00108
    00118         BlockMatcher( const PicArray& ref_data ,
    00119                       const PicArray& pic_data ,
    00120                       const OLBParams& bparams ,
    00121                       const int precision ,
    00122                       const MvArray& mv_array ,
    00123                       const TwoDArray< MvCostData >& cost_array);
    00124
    00125         ~BlockMatcher();
    00126
    00128
    00136         void FindBestMatchPel(const int xpos , const int ypos,
    00137                               const CandidateList& cand_list,
    00138                               const MVector& mv_prediction,
    00139                               const float lambda);
    00140
    00142
    00150         void FindBestMatchSubp( const int xpos, const int ypos,
    00151                                 const CandidateList& cand_list,
    00152                                 const MVector& mv_prediction,
    00153                                 const float lambda);
    00154
    00155         void RefineMatchSubp(const int xpos, const int ypos,
    00156                              const MVector& mv_prediction,
    00157                              const float lambda);
    00158
    00160
    00165         ValueType GetVar( const MVector& predmv , const MVector& mv ) const;
    00166
    00168
    00173         ValueType GetVarUp( const MVector& predmv , const MVector& mv ) const;
    00174
    00175         void SetPrecision( const int n ){ m_precision = n; }
    00176
    00177     private:
    00178         // Local copies of the picture and reference
    00179         const PicArray& m_pic_data;
    00180         const PicArray& m_ref_data;
    00181
    00182         // Local copy of the motion vector array being populated
    00183         const MvArray& m_mv_array;
    00184
    00185         // Local copy of the costs being determined through the matching
    00186         const TwoDArray< MvCostData >& m_cost_array;
    00187
    00188         // Block difference elements. Will choose between them depending
    00189         // on whether we're at the edge of the picture
    00190         PelBlockDiff m_peldiff;
    00191
    00192         OneDArray<BlockDiffUp* > m_subpeldiff;
    00193
    00194         // The block parameters we're using
    00195         OLBParams m_bparams;
    00196
    00197         // The maximum variations allowed in calculating motion vector costs
    00198         const int m_var_max;
    00199         const int m_var_max_up;
    00200
    00201         // The motion vector precision
    00202         int m_precision;
    00203
    00204     };
    00205
    00206 } // namespace dirac
    00207 #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.