PxRigidActorExt.h

// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions
// are met:
//  * Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
//  * Redistributions in binary form must reproduce the above copyright
//    notice, this list of conditions and the following disclaimer in the
//    documentation and/or other materials provided with the distribution.
//  * Neither the name of NVIDIA CORPORATION nor the names of its
//    contributors may be used to endorse or promote products derived
//    from this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
// PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
// OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
// Copyright (c) 2008-2022 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_RIGID_ACTOR_EXT_H
#define PX_RIGID_ACTOR_EXT_H
#include "PxPhysXConfig.h"
#include "PxPhysics.h"
#include "PxRigidActor.h"
 
#if !PX_DOXYGEN
namespace physx
{
#endif
 
class PxBVH;
class PxCooking;
 
class PxRigidActorExt
{
public:
 
    static PxShape* createExclusiveShape(PxRigidActor& actor, const PxGeometry& geometry, PxMaterial*const* materials, PxU16 materialCount, 
                                         PxShapeFlags shapeFlags = PxShapeFlag::eVISUALIZATION | PxShapeFlag::eSCENE_QUERY_SHAPE | PxShapeFlag::eSIMULATION_SHAPE)
    {
        PxShape* shape = PxGetPhysics().createShape(geometry, materials, materialCount, true, shapeFlags);
        if(shape)
        {
            bool status = actor.attachShape(*shape);    // attach can fail, if e.g. we try and attach a trimesh simulation shape to a dynamic actor
            shape->release();       // if attach fails, we hold the only counted reference, and so this cleans up properly
            if(!status)
                shape = NULL;
        }
        return shape;
    }
    
    static PX_FORCE_INLINE  PxShape*    createExclusiveShape(PxRigidActor& actor, const PxGeometry& geometry, const PxMaterial& material, 
                                                             PxShapeFlags shapeFlags = PxShapeFlag::eVISUALIZATION | PxShapeFlag::eSCENE_QUERY_SHAPE | PxShapeFlag::eSIMULATION_SHAPE)
    {
        PxMaterial* materialPtr = const_cast<PxMaterial*>(&material);
        return createExclusiveShape(actor, geometry, &materialPtr, 1, shapeFlags);
    }
 
    static PxBounds3*   getRigidActorShapeLocalBoundsList(const PxRigidActor& actor, PxU32& numBounds);
 
    static PxBVH* createBVHFromActor(PxPhysics& physics, const PxRigidActor& actor);
};
 
#if !PX_DOXYGEN
} // namespace physx
#endif
 
#endif