From 3dfe2108cfab31ba3ee5527e217d0d8e99a51162 Mon Sep 17 00:00:00 2001 From: git perforce import user Date: Tue, 25 Oct 2016 12:29:14 -0600 Subject: Initial commit: PhysX 3.4.0 Update @ 21294896 APEX 1.4.0 Update @ 21275617 [CL 21300167] --- PhysX_3.4/Samples/SampleBase/ParticleSystem.h | 163 ++++++++++++++++++++++++++ 1 file changed, 163 insertions(+) create mode 100644 PhysX_3.4/Samples/SampleBase/ParticleSystem.h (limited to 'PhysX_3.4/Samples/SampleBase/ParticleSystem.h') diff --git a/PhysX_3.4/Samples/SampleBase/ParticleSystem.h b/PhysX_3.4/Samples/SampleBase/ParticleSystem.h new file mode 100644 index 00000000..b4aa859a --- /dev/null +++ b/PhysX_3.4/Samples/SampleBase/ParticleSystem.h @@ -0,0 +1,163 @@ +// 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 PARTICLE_SYSTEM_H +#define PARTICLE_SYSTEM_H + +#include "PxPhysicsAPI.h" + +#if PX_USE_PARTICLE_SYSTEM_API + +#include "task/PxTask.h" +#include "pvd/PxPvd.h" +#include "extensions/PxParticleExt.h" +#include "PhysXSampleApplication.h" + +// fwd to avoid including cuda.h +#if defined(__x86_64) || defined(AMD64) || defined(_M_AMD64) +typedef unsigned long long CUdeviceptr; +#else +typedef unsigned int CUdeviceptr; +#endif + +/* + This is class for particle systems/fluids with constant rate emitter. +The class constructed using PxParticleBase object, the ownership of +which is transferred to ParticleSystem object. Other parameters are mandatory: +application pointer, billboard_size and texture object. Each particle rendered +as a quad, which normals always points to viewer. Texture for this quad must be supplied. +Depending on actual type of object created (PxParticleBase/PxParticleFluid) either particle system +could be created, or fluid. + This class has copy semantics, so it is possible to store objects of this +type in container and periodically call it's member functions - update/draw. + Particles' lifetime could be limited by lifetime. See setUseLifetime and +setLifetime functions. + In order to get particles created one must set emitter. Emitter is 2D shape (ellipse/rectangle) +located in some place in world coordinates, which emits particles with some rate. +This shape also has size. Also, in order to get particles created one must call periodically update() +function. + Worth mentioning, that particles count is limited by two or three factors - maximum number of particles, +which is set, during PxParticleBase/PxParticleFluid object construction AND emitter rate +AND IF SET particles lifetime. +*/ +class ParticleSystem : public SampleAllocateable +{ +private: + PxParticleBase* mParticleSystem; + PxParticleExt::IndexPool* mIndexPool; + std::vector mParticlesPositions; + std::vector mParticlesVelocities; + std::vector mParticlesOrientations; + PxU32 mNumParticles; + PxReal mParticleLifetime; + std::vector mParticleLifes; + PxU32* mParticleValidity; + PxU32 mValidParticleRange; + bool mUseLifetime; + bool mUseInstancedMeshes; + + CUdeviceptr mParticlesOrientationsDevice; + CUdeviceptr mParticleLifetimeDevice; + CUdeviceptr mParticleValidityDevice; + PxCudaContextManager* mCtxMgr; + + void modifyRotationMatrix(PxMat33& rotMatrix, PxReal deltaTime, const PxVec3& velocity); + void initializeParticlesOrientations(); + +public: + class Visitor + { + public: + virtual ~Visitor() {} + virtual void visit(ParticleSystem& particleSystem) = 0; + }; + void accept(Visitor& visitor) { visitor.visit(*this); } + + ParticleSystem(PxParticleBase* _particle_system, bool _useInstancedMeshes = false); + ~ParticleSystem(); + /* enables limiting particles lifetime */ + void setUseLifetime(bool use); + /* returns true if limiting particles lifetime is enabled */ + bool useLifetime(); + /* NOTE! setUseLifetime(true) before setting this. Sets lifetime of particle to "lt" on emit */ + void setLifetime(PxReal lt); + /* fetches particles positions from the PhysX SDK, + removes invalid particles + (intersected with drain, non-positive lifetime), + creates new particles */ + void update(float deltaTime); + /* creates particles in the PhysX SDK */ + void createParticles(struct ParticleData& particles); + + /* Returns pointer to the internal PxParticleBase */ + PxParticleBase* getPxParticleBase(); + /* Returns pointer to the particles positions */ + const std::vector& getPositions(); + /* Returns pointer to the particles lifetimes */ + const std::vector& getLifetimes(); + /* Returns pointer to the particles velocities */ + const std::vector& getVelocities(); + /* Returns pointer to the particles orientations */ + const std::vector& getOrientations(); + /* Returns pointer to the particles validity */ + const PxU32* getValidity(); + /* Returns range of vaild particles index */ + PxU32 getValidParticleRange(); + /* Returns number of particles */ + PxU32 getNumParticles(); + + /* Return the device copy of particles validity */ + CUdeviceptr getValiditiesDevice() const { return mParticleValidityDevice; } + /* Return the device copy of particles orientation */ + CUdeviceptr getOrientationsDevice() const { return mParticlesOrientationsDevice; } + /* Return the device copy of particle lifetimes*/ + CUdeviceptr getLifetimesDevice() const { return mParticleLifetimeDevice; } + /* Return cuda context manager if set, which is only the case if interop is enabled*/ + PxCudaContextManager* getCudaContextManager() const { return mCtxMgr; } + +public: + PxParticleSystem& getPxParticleSystem() { PX_ASSERT(mParticleSystem); return static_cast(*mParticleSystem); } + PxParticleFluid& getPxParticleFluid() { PX_ASSERT(mParticleSystem); return static_cast(*mParticleSystem); } + + PxU32 createParticles(const PxParticleCreationData& particles, PxStrideIterator* particleIndices = NULL, PxReal lifetime = 0.0f); + PxU32 createParticleSphere(PxU32 maxParticles, float particleDistance, const PxVec3& center, const PxVec3& vel, PxReal lifetime = 0.0f, PxReal restOffsetVariance = 0.0f); + PxU32 createParticleCube(PxU32 numX, PxU32 numY, PxU32 numZ, float particleDistance, const PxVec3& center, const PxVec3& vel, PxReal lifetime = 0.0f, PxReal restOffsetVariance = 0.0f); + PxU32 createParticleCube(const PxBounds3& aabb, float particleDistance, const PxVec3& vel, PxReal lifetime = 0.0f, PxReal restOffsetVariance = 0.0f); + PxU32 createParticleRand(PxU32 numParticles,const PxVec3& particleRange, const PxVec3& center, const PxVec3& vel, PxReal lifetime = 0.0f, PxReal restOffsetVariance = 0.0f); + PxU32 createParticlesFromFile(const char* particleFileName); + bool dumpParticlesToFile(const char* particleFileName); + void releaseParticles(const SampleArray& indices); + void releaseParticles(); + +private: + PxU32 createParticles(const ParticleData& particles, PxReal lifetime); +}; + +#endif // PX_USE_PARTICLE_SYSTEM_API +#endif -- cgit v1.2.3