// Created on: 1994-03-10
// Created by: Laurent BUCHARD
// Copyright (c) 1994-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_SolidExplorer_HeaderFile
#define _BRepClass3d_SolidExplorer_HeaderFile

#include <Standard.hxx>
#include <Standard_DefineAlloc.hxx>
#include <Standard_Handle.hxx>

#include <Bnd_Box.hxx>
#include <TopoDS_Shape.hxx>
#include <Standard_Boolean.hxx>
#include <Standard_Integer.hxx>
#include <Standard_Real.hxx>
#include <TopExp_Explorer.hxx>
#include <BRepClass3d_MapOfInter.hxx>
#include <TopAbs_State.hxx>
#include <BRepClass3d_BndBoxTree.hxx>
#include <TopTools_IndexedMapOfShape.hxx>

class TopoDS_Shape;
class gp_Pnt;
class TopoDS_Face;
class gp_Vec;
class BRepAdaptor_HSurface;
class TopoDS_Shell;
class gp_Lin;
class Bnd_Box;
class IntCurvesFace_Intersector;

//! Provide an exploration of a BRep Shape for the classification.
//! Provide access to the special UB tree to obtain fast search.
class BRepClass3d_SolidExplorer 
{
public:

  DEFINE_STANDARD_ALLOC

  
  Standard_EXPORT BRepClass3d_SolidExplorer();
  
  Standard_EXPORT BRepClass3d_SolidExplorer(const TopoDS_Shape& S);
  
  Standard_EXPORT virtual ~BRepClass3d_SolidExplorer();
  
  Standard_EXPORT void InitShape (const TopoDS_Shape& S);
  
  //! Should return True if P outside of bounding vol. of the shape
  Standard_EXPORT virtual Standard_Boolean Reject (const gp_Pnt& P) const;
  
  //! compute a point P in the face  F. Param is a Real in
  //! ]0,1[ and   is  used to  initialise  the algorithm. For
  //! different values , different points are returned.
  Standard_EXPORT static Standard_Boolean FindAPointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& Param);
  
  Standard_EXPORT static Standard_Boolean FindAPointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& u, Standard_Real& v, Standard_Real& Param);
  
  Standard_EXPORT static Standard_Boolean FindAPointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& u, Standard_Real& v, Standard_Real& Param, gp_Vec& theVecD1U, gp_Vec& theVecD1V);
  
  Standard_EXPORT static Standard_Boolean FindAPointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& u, Standard_Real& v);
  
  Standard_EXPORT static Standard_Boolean FindAPointInTheFace (const TopoDS_Face& F, gp_Pnt& P);
  
  Standard_EXPORT static Standard_Boolean FindAPointInTheFace (const TopoDS_Face& F, Standard_Real& u, Standard_Real& v);
  
  Standard_EXPORT Standard_Boolean PointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& u, Standard_Real& v, Standard_Real& Param, Standard_Integer& Index) const;
  
  Standard_EXPORT Standard_Boolean PointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& u, Standard_Real& v, Standard_Real& Param, Standard_Integer& Index, const Handle(BRepAdaptor_HSurface)& surf, const Standard_Real u1, const Standard_Real v1, const Standard_Real u2, const Standard_Real v2) const;
  
  //! <Index> gives point index  to  search from and returns
  //! point index of succeseful search
  Standard_EXPORT Standard_Boolean PointInTheFace (const TopoDS_Face& F, gp_Pnt& P, Standard_Real& u, Standard_Real& v, Standard_Real& Param, Standard_Integer& Index, const Handle(BRepAdaptor_HSurface)& surf, const Standard_Real u1, const Standard_Real v1, const Standard_Real u2, const Standard_Real v2, gp_Vec& theVecD1U, gp_Vec& theVecD1V) const;
  
  //! Starts an exploration of the shells.
  Standard_EXPORT void InitShell();
  
  //! Returns True if there is a current shell.
  Standard_EXPORT Standard_Boolean MoreShell() const;
  
  //! Sets the explorer to the next shell.
  Standard_EXPORT void NextShell();
  
  //! Returns the current shell.
  Standard_EXPORT TopoDS_Shell CurrentShell() const;
  
  //! Returns True if the Shell is rejected.
  Standard_EXPORT virtual Standard_Boolean RejectShell (const gp_Lin& L) const;
  
  //! Starts an exploration of the faces of the current shell.
  Standard_EXPORT void InitFace();
  
  //! Returns True if current face in current shell.
  Standard_EXPORT Standard_Boolean MoreFace() const;
  
  //! Sets the explorer to the next Face of the current shell.
  Standard_EXPORT void NextFace();
  
  //! Returns the current face.
  Standard_EXPORT TopoDS_Face CurrentFace() const;
  
  //! returns True if the face is rejected.
  Standard_EXPORT virtual Standard_Boolean RejectFace (const gp_Lin& L) const;
  
  //! Returns  in <L>, <Par>  a segment having at least
  //! one  intersection  with  the  shape  boundary  to
  //! compute  intersections.
  Standard_EXPORT Standard_Integer Segment (const gp_Pnt& P, gp_Lin& L, Standard_Real& Par);
  
  //! Returns  in <L>, <Par>  a segment having at least
  //! one  intersection  with  the  shape  boundary  to
  //! compute  intersections.
  //!
  //! The First Call to this method returns a line which
  //! point to a point of the first face of the shape.
  //! The Second Call provide a line to the second face
  //! and so on.
  Standard_EXPORT Standard_Integer OtherSegment (const gp_Pnt& P, gp_Lin& L, Standard_Real& Par);
  
  //! Returns the index of face for which
  //! last segment is calculated.
  Standard_EXPORT Standard_Integer GetFaceSegmentIndex() const;
  
  Standard_EXPORT virtual void DumpSegment (const gp_Pnt& P, const gp_Lin& L, const Standard_Real Par, const TopAbs_State S) const;
  
  Standard_EXPORT const Bnd_Box& Box() const;

  Standard_EXPORT const TopoDS_Shape& GetShape() const;
  
  Standard_EXPORT IntCurvesFace_Intersector& Intersector (const TopoDS_Face& F) const;

  //! Return UB-tree instance which is used for edge / vertex checks.
  const BRepClass3d_BndBoxTree& GetTree () {return myTree;}
  //! Return edge/vertices map for current shape.
  const TopTools_IndexedMapOfShape& GetMapEV () {return myMapEV;}
  
  Standard_EXPORT void Destroy();

private:

  Standard_EXPORT BRepClass3d_SolidExplorer(const BRepClass3d_SolidExplorer& Oth);

protected:

  Standard_EXPORT TopAbs_State ClassifyUVPoint
                   (const IntCurvesFace_Intersector& theIntersector,
                    const Handle(BRepAdaptor_HSurface)& theSurf,
                    const gp_Pnt2d& theP2d) const;

private:



  Bnd_Box myBox;
  TopoDS_Shape myShape;
  Standard_Boolean myReject;
  Standard_Integer myFirstFace;
  Standard_Real myParamOnEdge;
  TopExp_Explorer myShellExplorer;
  TopExp_Explorer myFaceExplorer;
  BRepClass3d_MapOfInter myMapOfInter;
  BRepClass3d_BndBoxTree myTree;
  TopTools_IndexedMapOfShape myMapEV;


};







#endif // _BRepClass3d_SolidExplorer_HeaderFile
