PhysX Primitive Collider Component

The PhysX Primitive Collider component adds a PhysX collider to an entity so that the entity can be included in PhysX simulation. The collider is defined by a simple shape primitive selected in the the PhysX Primitive Collider component. The PhysX Primitive Collider component can also define a trigger area or a force region.

Note:

Add a PhysX Static Rigid Body component with a PhysX Primitive Collider component to create a static entity that will never move. Add a PhysX Dynamic Rigid Body component to create a simulated or a kinematic entity. Simulated entities move in response to collisions and forces. Kinematic entities aren’t affected by collisions or forces, but are driven by scripted movement.

Provider

PhysX Gem

Properties

Base properties

Shape properties

Sets the collider for the collider component. Primitive shape colliders are not meshes. They are defined by simple dimension parameters that describe a box, sphere, capsule or cylinder. Primitive shape colliders are high performance, but they may not accurately represent the surface of the mesh provided by a Mesh component.

• Sphere
• Box
• Capsule
• Cylinder

Collider component mode

In collider component mode, you can edit colliders with manipulators in the viewport. To enter collider component mode, choose the Edit button at the bottom of the PhysX Primitive Collider component properties in the Entity Inspector.

Sub component modes

There are three editing modes available in collider component mode.

Resize (Sphere Shape)

Sphere resize mode has one linear manipulator that controls the Radius property.

Resize (Box Shape)

Box resize mode has six linear manipulators, one on each side of the box. The manipulators control the width, depth, and height aspects of the Dimensions property. By default, each face of the box can be separately edited. Hold Shift to edit opposite pairs of faces symmetrically.

Resize (Capsule Shape)

Capsule resize mode has three linear manipulators. The manipulators at the top and bottom of the capsule control the Height property. By default, each end of the capsule can be separately edited. Hold Shift to edit both ends symmetrically. The manipulator on the side controls the Radius property.

Resize (Cylinder Shape)

Cylinder resize mode has three linear manipulators. The manipulators at the top and bottom of the cylinder control the Height property. By default, each end of the cylinder can be separately edited. Hold Shift to edit both ends symmetrically. The manipulator on the side controls the Radius property.

Offset

Offset mode has a three-axis translate manipulator.

Rotation

Rotation mode has a three-axis rotate manipulator.

Collider component mode hotkeys

The following navigation hotkeys are available in collider component mode.

Colliders as triggers

Triggers allow colliders to perform efficient overlap tests. Colliders marked as triggers won’t be affected by forces when they intersect with another collider. This is useful for detecting when something enters a certain area or when two objects overlap. Use Lua or Script Canvas to detect overlap.

Note:

Because triggers don’t perform contact resolution, the contact points between a trigger and another collider aren’t available.