OCCT

// Created on: 1994-02-01
// Created by: Jean Yves LEBEY
// 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 _TopOpeBRepTool_ShapeClassifier_HeaderFile
#define _TopOpeBRepTool_ShapeClassifier_HeaderFile

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

#include <TopoDS_Shape.hxx>
#include <TopTools_ShapeMapHasher.hxx>
#include <NCollection_IndexedMap.hxx>
#include <TopAbs_State.hxx>
#include <TopoDS_Edge.hxx>
#include <TopoDS_Face.hxx>
#include <gp_Pnt.hxx>
#include <gp_Pnt2d.hxx>
#include <TopOpeBRepTool_SolidClassifier.hxx>
#include <NCollection_List.hxx>

class TopOpeBRepTool_ShapeClassifier
{
public:
  DEFINE_STANDARD_ALLOC

  Standard_EXPORT TopOpeBRepTool_ShapeClassifier();

  //! SRef is the reference shape.
  //! StateShapeShape(S) calls will classify S with SRef.
  Standard_EXPORT TopOpeBRepTool_ShapeClassifier(const TopoDS_Shape& SRef);

  //! reset all internal data (SolidClassifier included)
  Standard_EXPORT void ClearAll();

  //! reset all internal data (except SolidClassified)
  Standard_EXPORT void ClearCurrent();

  //! Set SRef as reference shape
  //! the next StateShapeReference(S,AvoidS) calls will classify S with SRef.
  Standard_EXPORT void SetReference(const TopoDS_Shape& SRef);

  //! classify shape S compared with shape SRef.
  //! samedomain = 0 : S1,S2 are not same domain
  //! samedomain = 1 : S1,S2 are same domain
  Standard_EXPORT TopAbs_State StateShapeShape(const TopoDS_Shape& S,
                                               const TopoDS_Shape& SRef,
                                               const int           samedomain = 0);

  Standard_EXPORT int SameDomain() const;

  //! set mode for next StateShapeShape call
  //! samedomain = true --> S,Sref are same domain --> point
  //! on restriction (ON S) is used to classify S.
  //! samedomain = false --> S,Sref are not domain --> point
  //! not on restriction of S (IN S) is used to classify S.
  //! samedomain value is used only in next StateShapeShape call
  Standard_EXPORT void SameDomain(const int samedomain);

  //! classify shape S compared with shape SRef.
  //! AvoidS is not used in classification; AvoidS may be IsNull().
  //! (useful to avoid ON or UNKNOWN state in special cases)
  Standard_EXPORT TopAbs_State StateShapeShape(const TopoDS_Shape& S,
                                               const TopoDS_Shape& AvoidS,
                                               const TopoDS_Shape& SRef);

  //! classify shape S compared with shape SRef.
  //! LAvoidS is list of S subshapes to avoid in classification
  //! AvoidS is not used in classification; AvoidS may be IsNull().
  //! (useful to avoid ON or UNKNOWN state in special cases)
  Standard_EXPORT TopAbs_State StateShapeShape(const TopoDS_Shape&                   S,
                                               const NCollection_List<TopoDS_Shape>& LAvoidS,
                                               const TopoDS_Shape&                   SRef);

  //! classify shape S compared with reference shape.
  //! AvoidS is not used in classification; AvoidS may be IsNull().
  //! (useful to avoid ON or UNKNOWN state in special cases)
  Standard_EXPORT TopAbs_State StateShapeReference(const TopoDS_Shape& S,
                                                   const TopoDS_Shape& AvoidS);

  //! classify shape S compared with reference shape.
  //! LAvoidS is list of S subshapes to avoid in classification
  //! (useful to avoid ON or UNKNOWN state in special cases)
  Standard_EXPORT TopAbs_State StateShapeReference(const TopoDS_Shape&                   S,
                                                   const NCollection_List<TopoDS_Shape>& LAvoidS);

  Standard_EXPORT TopOpeBRepTool_SolidClassifier& ChangeSolidClassifier();

  //! classify point P2D with myRef
  Standard_EXPORT void StateP2DReference(const gp_Pnt2d& P2D);

  //! classify point P3D with myRef
  Standard_EXPORT void StateP3DReference(const gp_Pnt& P3D);

  //! return field myState
  Standard_EXPORT TopAbs_State State() const;

  Standard_EXPORT const gp_Pnt2d& P2D() const;

  Standard_EXPORT const gp_Pnt& P3D() const;

private:
  Standard_EXPORT void MapRef();

  Standard_EXPORT void FindEdge();

  Standard_EXPORT void FindEdge(const TopoDS_Shape& S);

  Standard_EXPORT void FindFace(const TopoDS_Shape& S);

  Standard_EXPORT void Perform();

  //! classify myEdge with myRef
  Standard_EXPORT void StateEdgeReference();

  Standard_EXPORT bool HasAvLS() const;

  TopoDS_Shape                                                  myS;
  TopoDS_Shape                                                  myRef;
  TopoDS_Shape                                                  myAvS;
  NCollection_List<TopoDS_Shape>*                               myPAvLS;
  NCollection_IndexedMap<TopoDS_Shape, TopTools_ShapeMapHasher> myMapAvS;
  NCollection_IndexedMap<TopoDS_Shape, TopTools_ShapeMapHasher> mymre;
  int                                                           mymren;
  bool                                                          mymredone;
  TopAbs_State                                                  myState;
  TopoDS_Edge                                                   myEdge;
  TopoDS_Face                                                   myFace;
  bool                                                          myP3Ddef;
  gp_Pnt                                                        myP3D;
  bool                                                          myP2Ddef;
  gp_Pnt2d                                                      myP2D;
  TopOpeBRepTool_SolidClassifier                                mySolidClassifier;
  int                                                           mySameDomain;
};

#endif // _TopOpeBRepTool_ShapeClassifier_HeaderFile