NurbsCurve.h

Go to the documentation of this file.

/*

             *
            ***
           *****
   *********************       Mercenaries Engineering SARL
     *****************              Copyright (C) 2018
       *************
         *********        http://www.mercenaries-engineering.com
        ***********
       ****     ****
      **           **

*/
#pragma once

#include "Points.h"

  namespace maquina
  {
    class NurbsCurveParamFromLengthCache
    {};


    class MAQUINA_EXPORT NurbsCurve : public Points
    {
    public:
      enum Mode
      {
        Open = 0,     
        Closed = 1,   
        Periodic = 2  
      };


      NurbsCurve();

      NurbsCurve(const BufferConstV3f &points, const BufferConstFloat &knots, int degree, Mode mode);
      NurbsCurve(const BufferConstV3f &points, const BufferConstFloat &knots, const BufferConstFloat &weights, int degree, Mode mode);


      NurbsCurve(const Value &v);


      static NurbsCurve fit_closed(const BufferConstV3f& points, const BufferConstFloat& points_parameter, const BufferConstFloat& knots, int degree);


      static NurbsCurve fit_open(const BufferConstV3f& points, const BufferConstFloat& points_parameter, const BufferConstFloat& knots, int degree);


      static NurbsCurve fit_open2(const BufferConstV3f& points, const BufferConstFloat& points_parameter, const BufferConstFloat& knots, int degree);


      static NurbsCurve fit_open(const BufferConstV3f& points, const BufferConstFloat& points_parameter, const BufferConstFloat& knots, const Imath::V3f& d0, const Imath::V3f& dn, int degree);



      const BufferConstFloat read_knots() const;

      BufferFloat write_knots();

      const BufferConstFloat read_weights() const;

      BufferFloat write_weights();

      int degree() const;

      Mode mode() const;

      int span() const;


      Imath::V2f range() const;


      Imath::V3f evaluate(float u) const;

      Imath::V3d evaluate(double u) const;


      Imath::V3f evaluate_dp(float u) const;


      void derivatives(float u, const gsl::span<Imath::V3f>& derivatives) const;

      float length(
        float error = 0.001f  
      ) const;

      float length(
        float start,  
        float end,    
        float error = 0.001f  
      ) const;

      float param_from_length(
        float length,             
        bool relative = false,    
        float error = 0.001f,     
        int max_try = 100,        
        const std::shared_ptr<const NurbsCurveParamFromLengthCache>& cache = nullptr 
      ) const;


      std::shared_ptr<const NurbsCurveParamFromLengthCache> param_from_length_cache(float error = 0.001f, int n=100) const;


      float closest(
        const Imath::V3f& p,  
        Imath::V3f* r = nullptr,  
        float error = 0.001f, 
        int max_try = 10,     
        const gsl::span<const Imath::V3f>& cache = {} 
      ) const;




      void resample( const gsl::span<const float> &knots, int degree);


      void set_range(const Imath::V2f& range);

      void reverse();

      void split(float u, NurbsCurve& lower, NurbsCurve& upper) const;


      static const NurbsCurve default_value;

      NurbsCurve(std::shared_ptr<Impl> impl) { _impl=impl; }
    };
  }