SiSpatialIndex.h

Go to the documentation of this file.

// Copyright (C) 2002-2017, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Teigha(R) software pursuant to a license 
//   agreement with Open Design Alliance.
//   Teigha(R) Copyright (C) 2002-2017 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
 
#ifndef _SpatialIndex_h_Included_
#define _SpatialIndex_h_Included_
 
#include "OdPlatformSettings.h"
 
#ifdef SPATIALINDEX_DLL_EXPORTS
  #define ODSI_API          OD_TOOLKIT_EXPORT
  #define ODSI_API_STATIC   OD_STATIC_EXPORT
#else
  #define ODSI_API          OD_TOOLKIT_IMPORT
  #define ODSI_API_STATIC   OD_STATIC_IMPORT
#endif
 
 
#include "RxObject.h"
#include "Ge/GeExtents3d.h"
#include "Ge/GeExtents2d.h"
 
#include "TD_PackPush.h"
 
struct ODSI_API OdSiShape
{
  virtual bool contains( const OdGeExtents3d& extents, bool planar, const OdGeTol& tol = OdGeContext::gTol ) const = 0;
  virtual bool intersects( const OdGeExtents3d& extents, bool planar, const OdGeTol& tol = OdGeContext::gTol ) const = 0;
 
  virtual ~OdSiShape() {};
  virtual OdSiShape* clone() const { return 0; }
  virtual void transform(const OdGeMatrix3d&) {};
 
  ODSI_API_STATIC static const OdSiShape& kOverallSpace;
  ODSI_API_STATIC static const OdSiShape& kNoSpace;
};
struct OdSiEntity
{
  virtual bool extents(OdGeExtents3d& extents) const = 0;
};
 
struct OdSiVisitor
{
  virtual void visit( OdSiEntity* entity, bool completelyInside ) = 0;
};
 
class ODSI_API OdSiSpatialIndex;
typedef OdSmartPtr<OdSiSpatialIndex> OdSiSpatialIndexPtr;
 
class ODSI_API OdSiSpatialIndex : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdSiSpatialIndex);
 
  enum CreationFlags
  {
    kSiNoFlags       = 0,
 
    kSiPlanar        = (1 << 0), // Create 2D Spatial Index.
    kSiModifyMtAware = (1 << 1), // Protect insert/remove/clear by mutex object.
    kSiAccessMtAware = (1 << 2), // Protect query/extents/tolerance by mutex object.
 
    kSiFullMtAware   = (kSiModifyMtAware | kSiAccessMtAware)
  };
 
  static OdSiSpatialIndexPtr createObject( OdUInt32 flags, unsigned int initialNumEntity, unsigned int maxDepth = 30, unsigned int maxCount = 20, double eps = 1e-10 );
 
  virtual void insert( OdSiEntity* entity ) = 0;
  virtual bool remove( OdSiEntity* entity ) = 0;
 
  virtual void query( const OdSiShape& shape, OdSiVisitor& visitor ) const = 0;
  virtual void clear() = 0;
  virtual void setMaxTreeDepth( unsigned char maxDepth ) = 0;
  virtual void setMaxNodeSize( unsigned char maxCount ) = 0;
  virtual bool extents(OdGeExtents3d& extents) const = 0;
 
  virtual unsigned maxTreeDepth() const = 0;
 
  virtual unsigned maxNodeSize() const = 0;
 
  virtual const OdGeTol& tolerance() const = 0;
 
  virtual void setTolerance(const OdGeTol& tol) = 0;
};
 
namespace OdSi
{
bool ODSI_API properExtents(const OdGeExtents3d& ext);
}
 
#include "TD_PackPop.h"
 
#endif