// Copyright (c) 2021 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 _SelectMgr_BaseIntersector_HeaderFile #define _SelectMgr_BaseIntersector_HeaderFile #include #include #include #include #include #include #include #include #include #include class Graphic3d_Camera; class SelectMgr_FrustumBuilder; class SelectMgr_ViewClipRange; //! This class is an interface for different types of selecting intersector, //! defining different selection types, like point, box or polyline //! selection. It contains signatures of functions for detection of //! overlap by sensitive entity and initializes some data for building //! the selecting intersector class SelectMgr_BaseIntersector : public Standard_Transient { public: //! Creates new empty selecting volume Standard_EXPORT SelectMgr_BaseIntersector(); //! Destructor Standard_EXPORT virtual ~SelectMgr_BaseIntersector(); //! Builds intersector according to internal parameters virtual void Build() = 0; //! Returns selection type of this intersector SelectMgr_SelectionType GetSelectionType() const { return mySelectionType; } public: //! Checks if it is possible to scale this intersector. virtual Standard_Boolean IsScalable() const = 0; //! Sets pixel tolerance. //! It makes sense only for scalable intersectors (built on a single point). //! This method does nothing for the base class. Standard_EXPORT virtual void SetPixelTolerance (const Standard_Integer theTol); //! Note that this method does not perform any checks on type of the frustum. //! @param theScaleFactor [in] scale factor for new intersector or negative value if undefined; //! IMPORTANT: scaling makes sense only for scalable ::IsScalable() intersectors (built on a single point)! //! @param theTrsf [in] transformation for new intersector or gp_Identity if undefined //! @param theBuilder [in] an optional argument that represents corresponding settings for re-constructing transformed frustum from scratch; //! could be NULL if reconstruction is not expected furthermore //! @return a copy of the frustum resized according to the scale factor given and transforms it using the matrix given virtual Handle(SelectMgr_BaseIntersector) ScaleAndTransform (const Standard_Integer theScaleFactor, const gp_GTrsf& theTrsf, const Handle(SelectMgr_FrustumBuilder)& theBuilder) const = 0; public: //! Return camera definition. const Handle(Graphic3d_Camera)& Camera() const { return myCamera; } //! Saves camera definition. Standard_EXPORT virtual void SetCamera (const Handle(Graphic3d_Camera)& theCamera); //! Returns current window size. //! This method doesn't set any output values for the base class. Standard_EXPORT virtual void WindowSize (Standard_Integer& theWidth, Standard_Integer& theHeight) const; //! Sets current window size. //! This method does nothing for the base class. Standard_EXPORT virtual void SetWindowSize (const Standard_Integer theWidth, const Standard_Integer theHeight); //! Sets viewport parameters. //! This method does nothing for the base class. Standard_EXPORT virtual void SetViewport (const Standard_Real theX, const Standard_Real theY, const Standard_Real theWidth, const Standard_Real theHeight); //! Returns near point of intersector. //! This method returns zero point for the base class. Standard_EXPORT virtual const gp_Pnt& GetNearPnt() const; //! Returns far point of intersector. //! This method returns zero point for the base class. Standard_EXPORT virtual const gp_Pnt& GetFarPnt() const; //! Returns direction ray of intersector. //! This method returns zero direction for the base class. Standard_EXPORT virtual const gp_Dir& GetViewRayDirection() const; //! Returns current mouse coordinates. //! This method returns infinite point for the base class. Standard_EXPORT virtual const gp_Pnt2d& GetMousePosition() const; //! Stores plane equation coefficients (in the following form: //! Ax + By + Cz + D = 0) to the given vector. //! This method only clears input vector for the base class. virtual void GetPlanes (NCollection_Vector& thePlaneEquations) const { thePlaneEquations.Clear(); } public: //! SAT intersection test between defined volume and given axis-aligned box virtual Standard_Boolean OverlapsBox (const SelectMgr_Vec3& theBoxMin, const SelectMgr_Vec3& theBoxMax, const SelectMgr_ViewClipRange& theClipRange, SelectBasics_PickResult& thePickResult) const = 0; //! Returns true if selecting volume is overlapped by axis-aligned bounding box //! with minimum corner at point theMinPt and maximum at point theMaxPt virtual Standard_Boolean OverlapsBox (const SelectMgr_Vec3& theBoxMin, const SelectMgr_Vec3& theBoxMax, Standard_Boolean* theInside = NULL) const = 0; //! Intersection test between defined volume and given point virtual Standard_Boolean OverlapsPoint (const gp_Pnt& thePnt, const SelectMgr_ViewClipRange& theClipRange, SelectBasics_PickResult& thePickResult) const = 0; //! Intersection test between defined volume and given point //! Does not perform depth calculation, so this method is defined as helper function for inclusion test. //! Therefore, its implementation makes sense only for rectangular frustum with box selection mode activated. virtual Standard_Boolean OverlapsPoint (const gp_Pnt& thePnt) const = 0; //! SAT intersection test between defined volume and given ordered set of points, //! representing line segments. The test may be considered of interior part or //! boundary line defined by segments depending on given sensitivity type virtual Standard_Boolean OverlapsPolygon (const TColgp_Array1OfPnt& theArrayOfPnts, Select3D_TypeOfSensitivity theSensType, const SelectMgr_ViewClipRange& theClipRange, SelectBasics_PickResult& thePickResult) const = 0; //! Checks if line segment overlaps selecting frustum virtual Standard_Boolean OverlapsSegment (const gp_Pnt& thePnt1, const gp_Pnt& thePnt2, const SelectMgr_ViewClipRange& theClipRange, SelectBasics_PickResult& thePickResult) const = 0; //! SAT intersection test between defined volume and given triangle. The test may //! be considered of interior part or boundary line defined by triangle vertices //! depending on given sensitivity type virtual Standard_Boolean OverlapsTriangle (const gp_Pnt& thePnt1, const gp_Pnt& thePnt2, const gp_Pnt& thePnt3, Select3D_TypeOfSensitivity theSensType, const SelectMgr_ViewClipRange& theClipRange, SelectBasics_PickResult& thePickResult) const = 0; public: //! Measures distance between 3d projection of user-picked //! screen point and given point theCOG. //! It makes sense only for intersectors built on a single point. //! This method returns infinite value for the base class. Standard_EXPORT virtual Standard_Real DistToGeometryCenter (const gp_Pnt& theCOG) const; //! Calculates the point on a view ray that was detected during the run of selection algo by given depth. //! It makes sense only for intersectors built on a single point. //! This method returns infinite point for the base class. Standard_EXPORT virtual gp_Pnt DetectedPoint (const Standard_Real theDepth) const; //! Dumps the content of me into the stream Standard_EXPORT virtual void DumpJson (Standard_OStream& theOStream, Standard_Integer theDepth = -1) const; DEFINE_STANDARD_RTTIEXT(SelectMgr_BaseIntersector,Standard_Transient) protected: Handle(Graphic3d_Camera) myCamera; //!< camera definition (if builder isn't NULL it is the same as its camera) SelectMgr_SelectionType mySelectionType; //!< type of selection }; #endif // _SelectMgr_BaseIntersector_HeaderFile