1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-21 10:13:43 +03:00
occt/src/BRepClass3d/BRepClass3d_SClassifier.hxx
isn 58e14d59e7 0027117: BRepClass3d_SolidClassifier doesn't take into account vertex/edge/face tolerances
Various improvements in point-solid classifier:

1) Refactoring.
2) BndBoxTree is extracted into separate class.
3) UB-tree calculation is cashed to improve point-solid classification speed.
4) Ray / curve intersection improved by trimmed parameters and correct order.
5) Fixes in logic.
6) Calculation caching at the classifier level.

3D-claasifier now takes into the account the vertex/edges tolerances. If the given point lays inside the tolerance area of vertex or edge of the solid it's classified as TopAbs_ON.
The behavior of IntCurvesFace_Intersector::Perform was changed. Now it may use optional null-tolerance to classify 2d-point relatively to the given face.
UBTreeFiller is used to speedup intersection process between edges/vertices and the point.
The test case 'boolean gdml_private ZH2' extensively uses the SolidClassifier. After this fix it returns the correct classification statuses, which leads to incorrect result shape (reported by checkshape). Yet the result shape without this fix also seems to be incorrect (one of the isolines goes out of boundary of the face). Thats why it's marked with 'TODO'.

Corrections in test cases.

Test case is added.
2016-04-08 11:50:38 +03:00

114 lines
3.0 KiB
C++

// Created on: 1996-07-15
// Created by: Laurent BUCHARD
// Copyright (c) 1996-1999 Matra Datavision
// Copyright (c) 1999-2014 OPEN CASCADE SAS
//
// This file is part of Open CASCADE Technology software library.
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Lesser General Public License version 2.1 as published
// by the Free Software Foundation, with special exception defined in the file
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
// distribution for complete text of the license and disclaimer of any warranty.
//
// Alternatively, this file may be used under the terms of Open CASCADE
// commercial license or contractual agreement.
#ifndef _BRepClass3d_SClassifier_HeaderFile
#define _BRepClass3d_SClassifier_HeaderFile
#include <Standard.hxx>
#include <Standard_DefineAlloc.hxx>
#include <Standard_Handle.hxx>
#include <TopoDS_Face.hxx>
#include <Standard_Integer.hxx>
#include <Standard_Real.hxx>
#include <Standard_Boolean.hxx>
#include <TopAbs_State.hxx>
class Standard_DomainError;
class BRepClass3d_SolidExplorer;
class gp_Pnt;
class TopoDS_Face;
//! Provides an algorithm to classify a point in a solid.
class BRepClass3d_SClassifier
{
public:
DEFINE_STANDARD_ALLOC
//! Empty constructor.
Standard_EXPORT BRepClass3d_SClassifier();
//! Constructor to classify the point P with the
//! tolerance Tol on the solid S.
Standard_EXPORT BRepClass3d_SClassifier(BRepClass3d_SolidExplorer& S, const gp_Pnt& P, const Standard_Real Tol);
//! Classify the point P with the
//! tolerance Tol on the solid S.
Standard_EXPORT void Perform (BRepClass3d_SolidExplorer& S, const gp_Pnt& P, const Standard_Real Tol);
//! Classify an infinite point with the
//! tolerance Tol on the solid S.
Standard_EXPORT void PerformInfinitePoint (BRepClass3d_SolidExplorer& S, const Standard_Real Tol);
//! Returns True if the classification has been
//! computed by rejection.
//! The State is then OUT.
Standard_EXPORT Standard_Boolean Rejected() const;
//! Returns the result of the classification.
Standard_EXPORT TopAbs_State State() const;
//! Returns True when the point is a point of a face.
Standard_EXPORT Standard_Boolean IsOnAFace() const;
//! Returns the face used to determine the
//! classification. When the state is ON, this is the
//! face containing the point.
//!
//! When Rejected() returns True, Face() has no signification.
Standard_EXPORT TopoDS_Face Face() const;
protected:
Standard_EXPORT void ForceIn();
Standard_EXPORT void ForceOut();
private:
TopoDS_Face myFace;
//! This variable stores information about algorithm internal state.
//! Type of this variable differs from TopAbs_State since it contains
//! additional information about error status.
//! 1 - Error inside of the algorithm.
//! 2 - ON.
//! 3 - IN.
//! 4 - OUT.
Standard_Integer myState;
};
#endif // _BRepClass3d_SClassifier_HeaderFile