OCCT3D OCCT 8.0.1
OCCT documentation

Search guides and API reference

Enter at least two characters.

    Open CASCADE Technology Reference Manual 8.0.1
    GeomAPI_ProjectPointOnSurf Class Reference

    This class implements methods for computing all the orthogonal projections of a point onto a surface. More...

    #include <GeomAPI_ProjectPointOnSurf.hxx>

    Public Member Functions

     GeomAPI_ProjectPointOnSurf ()
     Creates an empty object. Use the Init function for further initialization.
     GeomAPI_ProjectPointOnSurf (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
     Create the projection of a point.
     GeomAPI_ProjectPointOnSurf (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const double Tolerance, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
     Create the projection of a point.
     GeomAPI_ProjectPointOnSurf (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const double Umin, const double Usup, const double Vmin, const double Vsup, const double Tolerance, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
     GeomAPI_ProjectPointOnSurf (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const double Umin, const double Usup, const double Vmin, const double Vsup, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
     Init the projection of a point.
    void Init (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const double Tolerance, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
    void Init (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
     Init the projection of a point.
    void Init (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const double Umin, const double Usup, const double Vmin, const double Vsup, const double Tolerance, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
    void Init (const gp_Pnt &P, const occ::handle< Geom_Surface > &Surface, const double Umin, const double Usup, const double Vmin, const double Vsup, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
     Init the projection for many points on a surface <Surface>. The solutions will be computed in the domain [Umin,Usup] [Vmin,Vsup] of the surface.
    void Init (const occ::handle< Geom_Surface > &Surface, const double Umin, const double Usup, const double Vmin, const double Vsup, const double Tolerance, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
    void Init (const occ::handle< Geom_Surface > &Surface, const double Umin, const double Usup, const double Vmin, const double Vsup, const Extrema_ExtAlgo Algo=Extrema_ExtAlgo_Grad)
    void SetExtremaAlgo (const Extrema_ExtAlgo theAlgo)
     Sets the Extrema search algorithm - Grad or Tree. By default the Extrema is initialized with Grad algorithm.
    void SetExtremaFlag (const Extrema_ExtFlag theExtFlag)
     Sets the Extrema search flag - MIN or MAX or MINMAX. By default the Extrema is set to search the MinMax solutions.
    void Perform (const gp_Pnt &P)
     Performs the projection of a point on the current surface.
    bool IsDone () const
    int NbPoints () const
     Returns the number of computed orthogonal projection points. Note: if projection fails, NbPoints returns 0.
     operator int () const
    gp_Pnt Point (const int Index) const
     Returns the orthogonal projection on the surface. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.
    void Parameters (const int Index, double &U, double &V) const
     Returns the parameters (U,V) on the surface of the orthogonal projection. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.
    double Distance (const int Index) const
     Computes the distance between the point and its orthogonal projection on the surface. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.
    gp_Pnt NearestPoint () const
     Returns the nearest orthogonal projection of the point on the surface. Exceptions StdFail_NotDone if projection fails.
     operator gp_Pnt () const
    void LowerDistanceParameters (double &U, double &V) const
     Returns the parameters (U,V) on the surface of the nearest computed orthogonal projection of the point. Exceptions StdFail_NotDone if projection fails.
    double LowerDistance () const
     Computes the distance between the point and its nearest orthogonal projection on the surface. Exceptions StdFail_NotDone if projection fails.
     operator double () const
    const Extrema_ExtPSExtrema () const
     return the algorithmic object from Extrema

    Detailed Description

    This class implements methods for computing all the orthogonal projections of a point onto a surface.

    Constructor & Destructor Documentation

    ◆ GeomAPI_ProjectPointOnSurf() [1/5]

    GeomAPI_ProjectPointOnSurf::GeomAPI_ProjectPointOnSurf ( )

    Creates an empty object. Use the Init function for further initialization.

    ◆ GeomAPI_ProjectPointOnSurf() [2/5]

    GeomAPI_ProjectPointOnSurf::GeomAPI_ProjectPointOnSurf ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    Create the projection of a point.

    on a surface <Surface>

    ◆ GeomAPI_ProjectPointOnSurf() [3/5]

    GeomAPI_ProjectPointOnSurf::GeomAPI_ProjectPointOnSurf ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const double Tolerance,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    Create the projection of a point.

    on a surface <Surface> Create the projection of a point

    on a surface <Surface>. The solution are computed in the domain [Umin,Usup] [Vmin,Vsup] of the surface.

    ◆ GeomAPI_ProjectPointOnSurf() [4/5]

    GeomAPI_ProjectPointOnSurf::GeomAPI_ProjectPointOnSurf ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const double Umin,
    const double Usup,
    const double Vmin,
    const double Vsup,
    const double Tolerance,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    ◆ GeomAPI_ProjectPointOnSurf() [5/5]

    GeomAPI_ProjectPointOnSurf::GeomAPI_ProjectPointOnSurf ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const double Umin,
    const double Usup,
    const double Vmin,
    const double Vsup,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    Init the projection of a point.

    on a surface <Surface>

    Member Function Documentation

    ◆ Distance()

    double GeomAPI_ProjectPointOnSurf::Distance ( const int Index) const

    Computes the distance between the point and its orthogonal projection on the surface. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.

    ◆ Extrema()

    const Extrema_ExtPS & GeomAPI_ProjectPointOnSurf::Extrema ( ) const

    return the algorithmic object from Extrema

    ◆ Init() [1/6]

    void GeomAPI_ProjectPointOnSurf::Init ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const double Tolerance,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    ◆ Init() [2/6]

    void GeomAPI_ProjectPointOnSurf::Init ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const double Umin,
    const double Usup,
    const double Vmin,
    const double Vsup,
    const double Tolerance,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    ◆ Init() [3/6]

    void GeomAPI_ProjectPointOnSurf::Init ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const double Umin,
    const double Usup,
    const double Vmin,
    const double Vsup,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    Init the projection for many points on a surface <Surface>. The solutions will be computed in the domain [Umin,Usup] [Vmin,Vsup] of the surface.

    ◆ Init() [4/6]

    void GeomAPI_ProjectPointOnSurf::Init ( const gp_Pnt & P,
    const occ::handle< Geom_Surface > & Surface,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    Init the projection of a point.

    on a surface <Surface>. The solution are computed in the domain [Umin,Usup] [Vmin,Vsup] of the surface.

    ◆ Init() [5/6]

    void GeomAPI_ProjectPointOnSurf::Init ( const occ::handle< Geom_Surface > & Surface,
    const double Umin,
    const double Usup,
    const double Vmin,
    const double Vsup,
    const double Tolerance,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    ◆ Init() [6/6]

    void GeomAPI_ProjectPointOnSurf::Init ( const occ::handle< Geom_Surface > & Surface,
    const double Umin,
    const double Usup,
    const double Vmin,
    const double Vsup,
    const Extrema_ExtAlgo Algo = Extrema_ExtAlgo_Grad )

    ◆ IsDone()

    bool GeomAPI_ProjectPointOnSurf::IsDone ( ) const

    ◆ LowerDistance()

    double GeomAPI_ProjectPointOnSurf::LowerDistance ( ) const

    Computes the distance between the point and its nearest orthogonal projection on the surface. Exceptions StdFail_NotDone if projection fails.

    ◆ LowerDistanceParameters()

    void GeomAPI_ProjectPointOnSurf::LowerDistanceParameters ( double & U,
    double & V ) const

    Returns the parameters (U,V) on the surface of the nearest computed orthogonal projection of the point. Exceptions StdFail_NotDone if projection fails.

    ◆ NbPoints()

    int GeomAPI_ProjectPointOnSurf::NbPoints ( ) const

    Returns the number of computed orthogonal projection points. Note: if projection fails, NbPoints returns 0.

    ◆ NearestPoint()

    gp_Pnt GeomAPI_ProjectPointOnSurf::NearestPoint ( ) const

    Returns the nearest orthogonal projection of the point on the surface. Exceptions StdFail_NotDone if projection fails.

    ◆ operator double()

    GeomAPI_ProjectPointOnSurf::operator double ( ) const

    ◆ operator gp_Pnt()

    GeomAPI_ProjectPointOnSurf::operator gp_Pnt ( ) const

    ◆ operator int()

    GeomAPI_ProjectPointOnSurf::operator int ( ) const

    ◆ Parameters()

    void GeomAPI_ProjectPointOnSurf::Parameters ( const int Index,
    double & U,
    double & V ) const

    Returns the parameters (U,V) on the surface of the orthogonal projection. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.

    ◆ Perform()

    void GeomAPI_ProjectPointOnSurf::Perform ( const gp_Pnt & P)

    Performs the projection of a point on the current surface.

    ◆ Point()

    gp_Pnt GeomAPI_ProjectPointOnSurf::Point ( const int Index) const

    Returns the orthogonal projection on the surface. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.

    ◆ SetExtremaAlgo()

    void GeomAPI_ProjectPointOnSurf::SetExtremaAlgo ( const Extrema_ExtAlgo theAlgo)
    inline

    Sets the Extrema search algorithm - Grad or Tree. By default the Extrema is initialized with Grad algorithm.

    ◆ SetExtremaFlag()

    void GeomAPI_ProjectPointOnSurf::SetExtremaFlag ( const Extrema_ExtFlag theExtFlag)
    inline

    Sets the Extrema search flag - MIN or MAX or MINMAX. By default the Extrema is set to search the MinMax solutions.


    The documentation for this class was generated from the following file: