lib/maracasVisuLib/src/kernel/include/curve.hxx

   1 /*# ---------------------------------------------------------------------
   2 #
   3 # Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image
   4 #                        pour la Sant�)
   5 # Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
   6 # Previous Authors : Laurent Guigues, Jean-Pierre Roux
   7 # CreaTools website : www.creatis.insa-lyon.fr/site/fr/creatools_accueil
   8 #
   9 #  This software is governed by the CeCILL-B license under French law and
  10 #  abiding by the rules of distribution of free software. You can  use,
  11 #  modify and/ or redistribute the software under the terms of the CeCILL-B
  12 #  license as circulated by CEA, CNRS and INRIA at the following URL
  13 #  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
  14 #  or in the file LICENSE.txt.
  15 #
  16 #  As a counterpart to the access to the source code and  rights to copy,
  17 #  modify and redistribute granted by the license, users are provided only
  18 #  with a limited warranty  and the software's author,  the holder of the
  19 #  economic rights,  and the successive licensors  have only  limited
  20 #  liability.
  21 #
  22 #  The fact that you are presently reading this means that you have had
  23 #  knowledge of the CeCILL-B license and that you accept its terms.
  24 # ------------------------------------------------------------------------ */
  25
  26 /*=========================================================================
  27
  28   Program:   wxMaracas
  29   Module:    $RCSfile: curve.hxx,v $
  30   Language:  C++
  31   Date:      $Date: 2012/11/15 14:15:31 $
  32   Version:   $Revision: 1.3 $
  33
  34   Copyright: (c) 2002, 2003
  35   License:
  36
  37      This software is distributed WITHOUT ANY WARRANTY; without even
  38      the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  39      PURPOSE.  See the above copyright notice for more information.
  40
  41 =========================================================================*/
  42
  43 #ifndef KGFO__CURVE__HXX
  44 #define KGFO__CURVE__HXX
  45
  46 #include <vector>
  47 #include "marTypes.h"
  48
  49 /*! \brief Parametrized n-dimensional curve.
  50  *
  51  *  This class realizes a parametric curve model, given some control points.
  52  */
  53 class MAR_KERNEL_EXPORT kCurve
  54 {
  55     public:
  56
  57     kCurve( size_t dim = 3, size_t sdim = 0 );
  58     ~kCurve( );
  59
  60     kCurve& operator=( const kCurve& r );
  61
  62     uint32_t getDimension( ) const
  63     {
  64       return( _dimension );
  65     }
  66
  67     uint32_t getStateDimension( ) const
  68     {
  69       return( _stateDim );
  70     }
  71
  72     uint32_t getClosestControlPoint( double* p );
  73
  74     void getPoint( double* p, double s );
  75     void getState( double* st, double s );
  76     void getTangent( double* tg, double s );
  77     void getNormal( double* n, double s );
  78     void getBinormal( double* b, double s );
  79
  80     void addControlPoint( double* cp, double* sp );
  81     void getControlPoint( int i, double* cp, double* sp );
  82     void setControlPoint( int i, double* cp, double* sp );
  83     uint32_t getNumberOfControlPoints( )
  84     {
  85       return( _controlPoints.size( ) );
  86     }
  87
  88     double length( double step = 0.01 );
  89
  90     double projectOverControlPoints( double* pr, double* pt );
  91     double projectOverCurve( double* pr, double* pt );
  92
  93     void evaluate( double* p, int i, double t );
  94     void evalState( double* s, int i, double t );
  95
  96     void derivative1( double* d, int i, double t );
  97     void derivative2( double* d, int i, double t );
  98
  99     void reset( );
 100
 101     public:
 102
 103     static int MAX_DIMENSION;
 104     static int MAX_STATE_DIMENSION;
 105
 106     protected:
 107
 108     std::vector< double* > _controlPoints;
 109     std::vector< double* > _controlState;
 110     uint32_t _dimension;
 111     uint32_t _stateDim;
 112
 113     private:
 114
 115     void loadCatmullControlMatrix( int i );
 116     void loadCatmullStateMatrix( int i );
 117     void calculeSplineArguments( double s, int& i, double& t );
 118
 119     std::vector< double > _controlT;
 120     std::vector< double > _controlL;
 121
 122     double* _mC;
 123     double* _mS;
 124
 125 };
 126
 127 #endif // KGFO__CURVE__HXX
 128
 129 // eof - curve.hxx