Initial commit:

PhysX 3.4.0 Update @ 21294896
APEX 1.4.0 Update @ 21275617

[CL 21300167]

1 files changed, 236 insertions, 0 deletions

diff --git a/PhysX_3.4/Include/PxSpatialIndex.h b/PhysX_3.4/Include/PxSpatialIndex.h
new file mode 100644
index 00000000..c705395b
--- /dev/null
+++ b/PhysX_3.4/Include/PxSpatialIndex.h
@@ -0,0 +1,236 @@
+// This code contains NVIDIA Confidential Information and is disclosed to you
+// under a form of NVIDIA software license agreement provided separately to you.
+//
+// Notice
+// NVIDIA Corporation and its licensors retain all intellectual property and
+// proprietary rights in and to this software and related documentation and
+// any modifications thereto. Any use, reproduction, disclosure, or
+// distribution of this software and related documentation without an express
+// license agreement from NVIDIA Corporation is strictly prohibited.
+//
+// ALL NVIDIA DESIGN SPECIFICATIONS, CODE ARE PROVIDED "AS IS.". NVIDIA MAKES
+// NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
+// THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT,
+// MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.
+//
+// Information and code furnished is believed to be accurate and reliable.
+// However, NVIDIA Corporation assumes no responsibility for the consequences of use of such
+// information or for any infringement of patents or other rights of third parties that may
+// result from its use. No license is granted by implication or otherwise under any patent
+// or patent rights of NVIDIA Corporation. Details are subject to change without notice.
+// This code supersedes and replaces all information previously supplied.
+// NVIDIA Corporation products are not authorized for use as critical
+// components in life support devices or systems without express written approval of
+// NVIDIA Corporation.
+//
+// Copyright (c) 2008-2016 NVIDIA Corporation. All rights reserved.
+// Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
+// Copyright (c) 2001-2004 NovodeX AG. All rights reserved.  
+
+
+#ifndef PX_PHYSICS_SPATIAL_INDEX
+#define PX_PHYSICS_SPATIAL_INDEX
+/** \addtogroup physics
+@{ */
+
+#include "PxPhysXConfig.h"
+#include "foundation/PxTransform.h"
+#include "geometry/PxGeometry.h"
+#include "PxQueryReport.h"
+
+#if !PX_DOXYGEN
+namespace physx
+{
+#endif
+
+typedef PxU32 PxSpatialIndexItemId;
+static const PxSpatialIndexItemId PX_SPATIAL_INDEX_INVALID_ITEM_ID = 0xffffffff;
+
+
+class PX_DEPRECATED PxSpatialIndexItem
+{
+};
+
+/**
+\brief Callback class for overlap queries against PxSpatialIndex
+
+\deprecated Spatial index feature has been deprecated in PhysX version 3.4
+
+@see PxSpatialIndex
+*/
+struct PX_DEPRECATED PxSpatialOverlapCallback
+{
+
+	/**
+	\brief callback method invoked when an overlap query hits an item in a PxSpatialIndex structure.
+
+	\param[in] item the item that was hit.
+	\return true if the query should continue, false if it should stop
+	*/
+
+	virtual PxAgain onHit(PxSpatialIndexItem& item) = 0;
+
+	virtual ~PxSpatialOverlapCallback() {}
+};
+
+/**
+\brief Callback class for raycast and sweep queries against PxSpatialIndex
+
+\deprecated Spatial index feature has been deprecated in PhysX version 3.4
+
+@see PxSpatialIndex
+*/
+struct PX_DEPRECATED PxSpatialLocationCallback
+{
+	/**
+	\brief callback method invoked when a sweep or raycast query hits an item in a PxSpatialIndex structure.
+
+	\param[in]  item the item that was hit.
+	\param[in]  distance the current maximum distance of the query.
+	\param[out] shrunkDistance the updated maximum distance of the query. This must be no more than the current maximum distance.
+
+	\return true if the query should continue, false if it should stop
+
+	@see PxAgain
+	*/
+	virtual PxAgain onHit(PxSpatialIndexItem& item, PxReal distance, PxReal& shrunkDistance) = 0;
+
+	virtual ~PxSpatialLocationCallback() {}
+};
+
+
+
+/**
+\brief provides direct access to PhysX' Spatial Query engine
+
+This class allows bounding boxes to be inserted, and then queried using sweep, raycast and overlap
+checks. 
+
+It is not thread-safe and defers handling some updates until queries are invoked, so care must be taken when calling any methods in parallel. Specifically,
+to call query methods (raycast, overlap, sweep) in parallel, first call flush() to force immediate update of internal structures.
+
+\deprecated Spatial index feature has been deprecated in PhysX version 3.4
+
+@see PxCreateSpatialIndex
+*/
+class PX_DEPRECATED PxSpatialIndex
+{
+public:
+
+
+	/**
+	\brief insert a bounding box into a spatial index
+
+	\param[in] item the item to be inserted
+	\param[in] bounds the bounds of the new item
+	*/
+	virtual	PxSpatialIndexItemId	insert(PxSpatialIndexItem& item,
+										   const PxBounds3& bounds)							= 0;
+
+	/**
+	\brief update a bounding box in a spatial index
+
+	\param[in] id the id of the item to be updated
+	\param[in] bounds the new bounds of the item
+	*/
+	virtual	void					update(PxSpatialIndexItemId id,
+										   const PxBounds3& bounds)							= 0;
+
+	/**
+	\brief remove an item from a spatial index
+
+	\param[in] id the id of the item to be removed
+	*/
+	virtual	void					remove(PxSpatialIndexItemId id)							= 0;
+
+
+	/**
+	\brief make an overlap query against a spatial index
+
+	\param[in] aabb the axis aligned bounding box for the query
+	\param[in] callback the callback to invoke when an overlap is found
+	*/
+	virtual void					overlap(const PxBounds3 &aabb,
+											PxSpatialOverlapCallback& callback)	const	= 0;
+
+	/**
+	\brief make a raycast query against a spatial index
+
+	\param[in] origin the origin of the ray
+	\param[in] unitDir a unit vector in the direction of the ray
+	\param[in] maxDist the maximum distance to cast the ray
+	\param[in] callback the callback to invoke when an item is hit by the ray
+	*/
+	virtual void					raycast(const PxVec3& origin, 
+											const PxVec3& unitDir, 
+											PxReal maxDist, 
+											PxSpatialLocationCallback& callback)	const	= 0;
+
+	/**
+	\brief make a sweep query against a spatial index
+
+	\param[in] aabb the axis aligned bounding box to sweep
+	\param[in] unitDir a unit vector in the direction of the sweep
+	\param[in] maxDist the maximum distance to apply the sweep
+	\param[in] callback the callback to invoke when an item is hit by the sweep
+	*/
+	virtual	void					sweep(const PxBounds3& aabb, 
+										  const PxVec3& unitDir, 
+										  PxReal maxDist, 
+										  PxSpatialLocationCallback& callback)		const	= 0;
+
+	/**
+	\brief force an immediate update of the internal structures of the index
+
+	For reasons of efficiency an index structure may be lazily updated at the point of query if this method is not called. Once this method
+	has been called, subsequent queries (sweeps, overlaps, raycasts) may be executed in parallel until the next write call to the index (insertion,
+	removal, update, rebuild)
+	*/
+	virtual void					flush()													= 0;
+
+	/**
+	\brief force a full optimized rebuild of the index. 
+	*/
+	virtual void					rebuildFull()											= 0;
+
+	/**
+	\brief set the incremental rebuild rate for the index. 
+	
+	The index builds gradually in the background each time a rebuild step is taken; this value determines the number of steps required to rebuild the index.
+	
+	See PxScene::setDynamicTreeRebuildRateHint() for more information.
+
+	\param[in] rate the rebuild rate
+
+	@see PxScene::setDynamicTreeRebuildRateHint()
+	*/
+	virtual void					setIncrementalRebuildRate(PxU32 rate)					= 0;
+
+	/**
+	\brief take one step in rebuilding the tree. See setIncrementalRebuildRate()
+	*/
+	virtual void					rebuildStep()											= 0;
+
+	/**
+	\brief release this object
+	*/
+	virtual void					release()												= 0;
+protected:
+	virtual							~PxSpatialIndex(){}
+};
+
+/**
+\brief Creates a spatial index.
+
+\deprecated Spatial index feature has been deprecated in PhysX version 3.4
+
+@see PxSpatialIndex
+*/
+PX_DEPRECATED PX_PHYSX_CORE_API PxSpatialIndex* PxCreateSpatialIndex();
+
+#if !PX_DOXYGEN
+} // namespace physx
+#endif
+
+/** @} */
+#endif