NurbsSurface.h

Go to the documentation of this file.

/*

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

*/
#pragma once

#include "NurbsCurve.h"
#include "Points.h"
#include "Mesh.h"

  namespace maquina
  {
    class NurbsCurve;
    class NurbsSurfaceClosestCache {};


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

      NurbsSurface();


      NurbsSurface(const Value &v);


      NurbsSurface(
        const gsl::span<const NurbsCurve> &curves,  
        int degree_v,                           
        Mode mode,                              
        bool use_u_direction,                   
        bool uniform                            
      );


      NurbsSurface(
        const gsl::span<const NurbsCurve> &curves,  
        const gsl::span<const float> &parameters,  
        int degree_v,                           
        Mode mode,                              
        bool use_u_direction                    
      );

      NurbsSurface(
        const BufferConstV3f &points,
        const BufferConstFloat &knots_u,
        const BufferConstFloat &knots_v,
        int degree_u,
        int degree_v,
        Mode mode_u,
        Mode mode_v
      );

      static NurbsSurface fit_open(const gsl::span<const Imath::V3f>& points, const gsl::span<const float>& parameters_u, const gsl::span<const float>& parameters_v, const gsl::span<const float>& knots_u, const gsl::span<const float>& knots_v, int pu, int pv, int du, int dv);

      static NurbsSurface fit_close_u(const gsl::span<const Imath::V3f>& points, const gsl::span<const float>& parameters_u, const gsl::span<const float>& parameters_v, const gsl::span<const float>& knots_u, const gsl::span<const float>& knots_v, int pu, int pv, int du, int dv);

      static NurbsSurface fit_close_v(const gsl::span<const Imath::V3f>& points, const gsl::span<const float>& parameters_u, const gsl::span<const float>& parameters_v, const gsl::span<const float>& knots_u, const gsl::span<const float>& knots_v, int pu, int pv, int du, int dv);

      const BufferConstFloat read_knots_u() const;

      BufferFloat write_knots_u();

      const BufferConstFloat read_knots_v() const;

      BufferFloat write_knots_v();

      int control_points_u() const;

      int control_points_v() const;

      int degree_u() const;

      int degree_v() const;

      Mode mode_u() const;

      Mode mode_v() const;

      int span_u() const;

      int span_v() const;

      Imath::V2f range_u() const;

      void set_range_u(const Imath::V2f& r);

      Imath::V2f range_v() const;

      void set_range_v(const Imath::V2f& r);

      Imath::V3f control_point(int u, int v) const;

      Imath::V3f evaluate(float u, float v) const;

      Imath::V3d evaluate(double u, double v) const;

      Imath::M44d matrix_at(double u, double v, double n) const;


      NurbsCurve iso_curve(float u, bool use_v) const;


      std::pair<Imath::V3f,Imath::V3f> evaluate_dp(float u, float v, bool previous_u=false, bool previous_v=false) const;


      Imath::V2f closest(
        const Imath::V3f& p,      
        Imath::V3f* r = nullptr,  
        float error = 0.001f,     
        int max_try = 10,         
        const std::shared_ptr<const NurbsSurfaceClosestCache>& cache = nullptr  
      ) const;


      std::shared_ptr<const NurbsSurfaceClosestCache> closest_cache() const;

      Mesh tessellate(int subdivision_u, int subdivision_v, bool compute_uv_and_normals = false) const;

      void remap_knots_u(float new_min, float new_max);

      void remap_knots_v(float new_min, float new_max);

      void swap_u_v();

      void refine_knots_u(const gsl::span<const float>& new_knots);

      void refine_knots_v(const gsl::span<const float>& new_knots);

      static const NurbsSurface default_value;

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