1 // Created on: 2013-12-20
2 // Created by: Denis BOGOLEPOV
3 // Copyright (c) 2013-2014 OPEN CASCADE SAS
5 // This file is part of Open CASCADE Technology software library.
7 // This library is free software; you can redistribute it and/or modify it under
8 // the terms of the GNU Lesser General Public License version 2.1 as published
9 // by the Free Software Foundation, with special exception defined in the file
10 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
11 // distribution for complete text of the license and disclaimer of any warranty.
13 // Alternatively, this file may be used under the terms of Open CASCADE
14 // commercial license or contractual agreement.
16 #ifndef _BVH_PrimitiveSet_Header
17 #define _BVH_PrimitiveSet_Header
19 #include <BVH_Object.hxx>
20 #include <BVH_Builder.hxx>
21 #include <BVH_BinnedBuilder.hxx>
23 //! Set of abstract geometric primitives organized with bounding
24 //! volume hierarchy (BVH). Unlike an object set, this collection
25 //! is designed for storing structural elements of a single object
26 //! (such as triangles in the object triangulation). Because there
27 //! may be a large number of such elements, the implementations of
28 //! this interface should be sufficiently optimized.
29 //! \tparam T Numeric data type
30 //! \tparam N Vector dimension
31 template<class T, int N>
32 class BVH_PrimitiveSet : public BVH_Object<T, N>, public BVH_Set<T, N>
36 using BVH_Set<T, N>::Box;
39 static const Standard_Integer MaxTreeDepth = BVH_Constants_MaxTreeDepth;
41 //! Creates set of abstract primitives.
43 : myBVH (new BVH_Tree<T, N>()),
44 // set default builder - binned SAH split
45 myBuilder (new BVH_BinnedBuilder<T, N, BVH_Constants_NbBinsBest> (BVH_Constants_LeafNodeSizeDefault, BVH_Constants_MaxTreeDepth))
50 //! Creates set of abstract primitives.
51 BVH_PrimitiveSet (const opencascade::handle<BVH_Builder<T, N> >& theBuilder)
52 : myBVH (new BVH_Tree<T, N>()),
53 myBuilder (theBuilder)
58 //! Releases resources of set of abstract primitives.
59 virtual ~BVH_PrimitiveSet()
67 //! Returns AABB of primitive set.
68 virtual BVH_Box<T, N> Box() const Standard_OVERRIDE
70 if (BVH_Object<T, N>::myIsDirty)
72 myBox = BVH_Set<T, N>::Box();
77 //! Returns BVH tree (and builds it if necessary).
78 virtual const opencascade::handle<BVH_Tree<T, N> >& BVH()
80 if (BVH_Object<T, N>::myIsDirty)
87 //! Returns the method (builder) used to construct BVH.
88 virtual const opencascade::handle<BVH_Builder<T, N> >& Builder() const { return myBuilder; }
90 //! Sets the method (builder) used to construct BVH.
91 virtual void SetBuilder (const opencascade::handle<BVH_Builder<T, N> >& theBuilder) { myBuilder = theBuilder; }
95 //! Updates BVH of primitive set.
98 if (BVH_Object<T, N>::myIsDirty)
100 myBuilder->Build (this, myBVH.operator->(), Box());
101 BVH_Object<T, N>::myIsDirty = Standard_False;
107 opencascade::handle<BVH_Tree<T, N> > myBVH; //!< Constructed bottom-level BVH
108 opencascade::handle<BVH_Builder<T, N> > myBuilder; //!< Builder for bottom-level BVH
110 mutable BVH_Box<T, N> myBox; //!< Cached bounding box of geometric primitives
114 #endif // _BVH_PrimitiveSet_Header