| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| public:t-vien-10-3:lab_4_materials:physx [2010/10/07 00:46] – claudio | public:t-vien-10-3:lab_4_materials:physx [2024/04/29 13:33] (current) – external edit 127.0.0.1 |
|---|
| ====== Factory Scene with PhysX (unfairly only for Windows) ====== | ====== Factory Scene with PhysX (unfairly only for Windows) ====== |
| The Panda 1.7.0 distribution comes with a Python exposure for PhysX, which is called Panda PhysX. Panda PhysX is a Python library you will use to access the Physx API from a Panda script.\\ | The Panda 1.7.0 distribution comes with a Python exposure for PhysX, which is called Panda PhysX. Panda PhysX is a Python library you will use to access the Physx API from a Panda script. This tutorial is created by Claudio Pedica (you may get in touch with him if there are questions)\\ |
| - To begin with, you need to import the Panda PhysX classes you will use along the code.<code python> | - For this to work, you need to first install [[http://www.ru.is/kennarar/hannes/share/PhysX_9.10.0513_SystemSoftware.exe|The PhysX Software System]] |
| | - In your code, you need to import the Panda PhysX classes.<code python> |
| from panda3d.physx import PhysxManager | from panda3d.physx import PhysxManager |
| from panda3d.physx import PhysxEnums | from panda3d.physx import PhysxEnums |
| - The PhysxManager is your entry point to the PhysX engine. It is a singleton, that is a class that can have only a single global instance.<code python> | - The PhysxManager is your entry point to the PhysX engine. It is a singleton, that is a class that can have only a single global instance.<code python> |
| self.physx = PhysxManager.getGlobalPtr() | self.physx = PhysxManager.getGlobalPtr() |
| </code>The physics simulation take place into a PhysX scene, a sort of side invisible world where the objects have their physical incarnation. So, to begin with you want to create a PhysX Scene. Every time you want to create a general PhysX object, you need to provide a descriptor first and pass it as a parameter to a specific creation method. A descriptor is a blueprint of the object that you want to build and the creation method will return an instance of it. This fancy-looking way of instantiating classes is actually a variant of the [[http://en.wikipedia.org/wiki/Factory_method_pattern|Factory Method Design Pattern]] and it has several benefits.<code python> | </code>The physics simulation take place into a PhysX scene, a sort of invisible side world where the objects have their physical incarnation. So at first, you really want to create a PhysX Scene. Every time you have to create a general PhysX object, you need to provide a descriptor first and pass it as a parameter to a specific creation method. A descriptor is a kind of blueprint of the object that a creation method will use to return an instance of the object itself. This sort of fancy-looking way of instantiating classes is actually very purposeful and represent a variant of the [[http://en.wikipedia.org/wiki/Factory_method_pattern|Factory Method Design Pattern]] that has several interesting benefits.<code python> |
| # Setup the physical world | # Setup the physical world |
| sceneDesc = PhysxSceneDesc() | sceneDesc = PhysxSceneDesc() |
| return task.cont | return task.cont |
| </code>You may notice that the door naturally falls down along with the box. Bug? No, just gravity! There is nothing holding up the door, so it just falls down to infinity. We'll fix that next.\\ | </code>You may notice that the door naturally falls down along with the box. Bug? No, just gravity! There is nothing holding up the door, so it just falls down to infinity. We'll fix that next.\\ |
| - You need to attach the door to its door trail so that it doesn't fall. The door trail will be a new PhysX actor and you can attach the door to it using a so called actor joint. We need to set the trail actor as kinematic, that is not affected by forces (such as gravity). You can create a trail actor in the same way you did for the door. Set dimensions **(1.0, 1.0, 0)** and mass **10.0**. You also may want to move the trail from the door position by a certain offset. Try with **Point3(-2.0, 0.0, 0.0)**. Once you have created your trail actor, you can make it kinematic like this:<code python>self.trailActor.setBodyFlag(PhysxEnums.BFKinematic, 1)</code>PhysX provides a number of joints that constrain actors together in different ways. We want the door to slide through the trail, so we are going to use a point-on-line joint. This kind of joint will constrain the origin of the door to move only along a line of the trail actor, enough to achieve a sliding effect. But there is a problem here! Having the door constrained in only one point means that, when a box will fall on the door from above, the door will start spinning around its origin. To avoid this we need to freeze the door rotations along the three axis, kind of like having the door installed into an opening of the floor. You create a point-on-line joint with all the necessary setting and attach door and trail together like this:<code python># Joint | - You need to attach the door to its door trail so that it doesn't fall. The door trail will be a new PhysX actor and you can attach the door to it using a so called actor joint. We need to set the trail actor as kinematic and that means not affected by forces (such as gravity). You can create a trail actor in the same way you did for the door. Set dimensions **(1.0, 1.0, 0)** and mass **10.0**. You also may want to move the trail from the door position by a certain offset. Try with **Vec3(-2.0, 0.0, 0.0)**. Once you have created your trail actor, you can make it kinematic like this:<code python>self.trailActor.setBodyFlag(PhysxEnums.BFKinematic, 1)</code>PhysX provides a number of joints that constrain actors together in different ways. We want the door to slide through the trail, so we are going to use a point-on-line joint. This kind of joint will constrain the origin of the door to move only along a line of the trail actor, enough to achieve a sliding effect. But we have a problem here! Having the door constrained in only one point means that, when a box will fall on the door from above, the door might start spinning around its origin pushed by the mass of the falling box. To avoid this we need to freeze the door rotations along the three axis, kind of having the door installed into an opening of the floor. You create a point-on-line joint with all the necessary setting and attach door and trail together like this:<code python># Joint |
| jointDesc = PhysxPointOnLineJointDesc() | jointDesc = PhysxPointOnLineJointDesc() |
| jointDesc.setName('Point-On-Line Joint') | jointDesc.setName('Point-On-Line Joint') |
| self.doorActor.setBodyFlag(PhysxEnums.BFFrozenRotZ, 1) | self.doorActor.setBodyFlag(PhysxEnums.BFFrozenRotZ, 1) |
| # Create the joint | # Create the joint |
| joint = self.scene.createJoint(jointDesc)</code> | joint = self.scene.createJoint(jointDesc) |
| | # Joint limits set by plane |
| | joint.addLimitPlane(Vec3(-1, 0, 0), Point3(1, 0, 0)) |
| | joint.addLimitPlane(Vec3( 1, 0, 0), Point3(-1, 0, 0))</code>The last two lines here set the limits for the sliding door. While along the joint axis, the door will be not allowed to go behind the two limit planes. Now try replacing the LerpPosInterval calls, for opening and closing the door, with something more physics-oriented. Call **self.doorActor.setLinearVelocity(Vec3(-0.5, 0.0, 0.0))** to slide the door to the left.\\ |
| | - Finally, make sure to remove all previous collision handling, since PhysX will take care of it from now on. Unfortunately, the events generated by the physics engine behave a bit differently than the events created by Panda's collision system, so playing a sound when collision occurs gets tricky. Don't worry about that for now, and enjoy the physical simulation without sounds.\\ |
| | - For extra awesomeness try the following: Create an instance of an AcmeBox every time you press the mouse button. Maintain a list of created boxes in your factory and iterate over that list in the simulation function to update their positions and rotations. This way you can fill the scene with tumbling boxes and be happy to mess around! |
