- Generated by
1.9.8
|
RavEngine
|
Descriptor class for a character controller. More...
#include <PxController.h>
Public Member Functions | |
| virtual PX_INLINE bool | isValid () const |
| returns true if the current settings are valid | |
| PX_INLINE PxControllerShapeType::Enum | getType () const |
| Returns the character controller type. | |
Public Attributes | |
| PxExtendedVec3 | position |
| The position of the character. | |
| PxVec3 | upDirection |
| Specifies the 'up' direction. | |
| PxF32 | slopeLimit |
| The maximum slope which the character can walk up. | |
| PxF32 | invisibleWallHeight |
| Height of invisible walls created around non-walkable triangles. | |
| PxF32 | maxJumpHeight |
| Maximum height a jumping character can reach. | |
| PxF32 | contactOffset |
| The contact offset used by the controller. | |
| PxF32 | stepOffset |
| Defines the maximum height of an obstacle which the character can climb. | |
| PxF32 | density |
| Density of underlying kinematic actor. | |
| PxF32 | scaleCoeff |
| Scale coefficient for underlying kinematic actor. | |
| PxF32 | volumeGrowth |
| Cached volume growth. | |
| PxUserControllerHitReport * | reportCallback |
| Specifies a user report callback. | |
| PxControllerBehaviorCallback * | behaviorCallback |
| Specifies a user behavior callback. | |
| PxControllerNonWalkableMode::Enum | nonWalkableMode |
| The non-walkable mode controls if a character controller slides or not on a non-walkable part. | |
| PxMaterial * | material |
| The material for the actor associated with the controller. | |
| bool | registerDeletionListener |
| Use a deletion listener to get informed about released objects and clear internal caches if needed. | |
| PxClientID | clientID |
| Client ID for associated actor. | |
| void * | userData |
| User specified data associated with the controller. | |
Protected Member Functions | |
| PX_INLINE | PxControllerDesc (PxControllerShapeType::Enum) |
| constructor sets to default. | |
| PX_INLINE | PxControllerDesc (const PxControllerDesc &) |
| copy constructor. | |
| PX_INLINE PxControllerDesc & | operator= (const PxControllerDesc &) |
| assignment operator. | |
| PX_INLINE void | copy (const PxControllerDesc &) |
Protected Attributes | |
| const PxControllerShapeType::Enum | mType |
| The type of the controller. This gets set by the derived class' ctor, the user should not have to change it. | |
Descriptor class for a character controller.
|
inline |
Returns the character controller type.
|
virtual |
returns true if the current settings are valid
Reimplemented in physx::PxBoxControllerDesc, and physx::PxCapsuleControllerDesc.
| PxControllerBehaviorCallback* physx::PxControllerDesc::behaviorCallback |
Specifies a user behavior callback.
This behavior callback is called to customize the controller's behavior w.r.t. touched shapes.
Setting this to NULL disables the callback.
Default: NULL
| PxClientID physx::PxControllerDesc::clientID |
Client ID for associated actor.
Default: PX_DEFAULT_CLIENT
| PxF32 physx::PxControllerDesc::contactOffset |
The contact offset used by the controller.
Specifies a skin around the object within which contacts will be generated. Use it to avoid numerical precision issues.
This is dependant on the scale of the users world, but should be a small, positive non zero value.
Default: 0.1
| PxF32 physx::PxControllerDesc::density |
Density of underlying kinematic actor.
The CCT creates a PhysX's kinematic actor under the hood. This controls its density.
Default: 10.0
| PxF32 physx::PxControllerDesc::invisibleWallHeight |
Height of invisible walls created around non-walkable triangles.
The library can automatically create invisible walls around non-walkable triangles defined by the 'slopeLimit' parameter. This defines the height of those walls. If it is 0.0, then no extra triangles are created.
Default: 0.0
| PxMaterial* physx::PxControllerDesc::material |
The material for the actor associated with the controller.
The controller internally creates a rigid body actor. This parameter specifies the material of the actor.
Default: NULL
| PxF32 physx::PxControllerDesc::maxJumpHeight |
Maximum height a jumping character can reach.
This is only used if invisible walls are created ('invisibleWallHeight' is non zero).
When a character jumps, the non-walkable triangles he might fly over are not found by the collision queries (since the character's bounding volume does not touch them). Thus those non-walkable triangles do not create invisible walls, and it is possible for a jumping character to land on a non-walkable triangle, while he wouldn't have reached that place by just walking.
The 'maxJumpHeight' variable is used to extend the size of the collision volume downward. This way, all the non-walkable triangles are properly found by the collision queries and it becomes impossible to 'jump over' invisible walls.
If the character in your game can not jump, it is safe to use 0.0 here. Otherwise it is best to keep this value as small as possible, since a larger collision volume means more triangles to process.
Default: 0.0
| PxControllerNonWalkableMode::Enum physx::PxControllerDesc::nonWalkableMode |
The non-walkable mode controls if a character controller slides or not on a non-walkable part.
This is only used when slopeLimit is non zero.
Default: PxControllerNonWalkableMode::ePREVENT_CLIMBING
| PxExtendedVec3 physx::PxControllerDesc::position |
The position of the character.
Default: Zero
| bool physx::PxControllerDesc::registerDeletionListener |
Use a deletion listener to get informed about released objects and clear internal caches if needed.
If a character controller registers a deletion listener, it will get informed about released objects. That allows the controller to invalidate cached data that connects to a released object. If a deletion listener is not registered, PxController::invalidateCache has to be called manually after objects have been released.
Default: true
| PxUserControllerHitReport* physx::PxControllerDesc::reportCallback |
Specifies a user report callback.
This report callback is called when the character collides with shapes and other characters.
Setting this to NULL disables the callback.
Default: NULL
| PxF32 physx::PxControllerDesc::scaleCoeff |
Scale coefficient for underlying kinematic actor.
The CCT creates a PhysX's kinematic actor under the hood. This controls its scale factor. This should be a number a bit smaller than 1.0.
Default: 0.8
| PxF32 physx::PxControllerDesc::slopeLimit |
The maximum slope which the character can walk up.
In general it is desirable to limit where the character can walk, in particular it is unrealistic for the character to be able to climb arbitary slopes.
The limit is expressed as the cosine of desired limit angle. A value of 0 disables this feature.
Default: 0.707
| PxF32 physx::PxControllerDesc::stepOffset |
Defines the maximum height of an obstacle which the character can climb.
A small value will mean that the character gets stuck and cannot walk up stairs etc, a value which is too large will mean that the character can climb over unrealistically high obstacles.
Default: 0.5
| PxVec3 physx::PxControllerDesc::upDirection |
Specifies the 'up' direction.
In order to provide stepping functionality the SDK must be informed about the up direction.
Default: (0, 1, 0)
| void* physx::PxControllerDesc::userData |
User specified data associated with the controller.
Default: NULL
| PxF32 physx::PxControllerDesc::volumeGrowth |
Cached volume growth.
Amount of space around the controller we cache to improve performance. This is a scale factor that should be higher than 1.0f but not too big, ideally lower than 2.0f.
Default: 1.5
1.9.8