CharacterController QML Type

Permet de contrôler les mouvements d'un personnage. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• collisions : Collisions
• enableShapeHitCallback : bool (since 6.6)
• gravity : vector3d
• midAirControl : bool
• movement : vector3d

Signaux

• shapeHit(PhysicsNode *body, vector3D position, vector3D impulse, vector3D normal) (since 6.6)

Méthodes

• void teleport(vector3d position)

Description détaillée

Le type CharacterController contrôle les mouvements d'un personnage.

Un personnage est une entité qui se déplace sous un contrôle externe, mais qui reste soumise à des barrières physiques et (éventuellement) à la gravité. Cela contraste avec les objets de type « dynamic rigid bodies », qui sont soit entièrement contrôlés par la simulation physique (pour les corps non cinématiques), soit se déplacent exactement là où ils sont placés, sans tenir compte des barrières (pour les objets cinématiques).

Pour contrôler le mouvement d’un contrôleur de personnage, définissez l’ movement à la vitesse souhaitée.

Pour une vue à la première personne, la caméra est généralement placée à l’intérieur d’un contrôleur de personnage.

Voir également «Qt Quick 3D Physics Shapes, Bodies and Joints ».

Documentation sur les propriétés

collisions : Collisions [read-only]

Cette propriété contient l'état actuel de collision du personnage. Elle peut prendre la valeur « None » (aucune collision) ou une combinaison (ou) des valeurs suivantes : « Side », « Up » et « Down » :

enableShapeHitCallback : bool [since 6.6]

Cette propriété active ou désactive la fonction de rappel « CharacterController::shapeHit » pour ce contrôleur de personnage.

Valeur par défaut : false

Cette propriété a été introduite dans Qt 6.6.

gravity : vector3d

Cette propriété définit l'accélération gravitationnelle qui s'applique au personnage. Pour un personnage marchant au sol, elle doit généralement être définie sur PhysicsWorld.gravity. Un personnage flottant dont les mouvements sont contrôlés en trois dimensions aura normalement une gravité de (0, 0, 0).

Valeur par défaut : (0, 0, 0).

midAirControl : bool

Cette propriété détermine si la propriété « movement » s'applique lorsque le personnage est en chute libre. Elle n'est pertinente que si la propriété « gravity » n'est pas nulle. Une valeur « true » signifie que le personnage changera de direction en plein vol lorsque la propriété « movement » changera. Une valeur « false » signifie que le personnage poursuivra sa trajectoire actuelle jusqu'à ce qu'il heurte un autre objet.

Valeur par défaut : true

movement : vector3d

Cette propriété définit le mouvement contrôlé du personnage. Il s'agit de la vitesse à laquelle le personnage se déplacerait en l'absence de gravité et sans interagir avec d'autres objets physiques.

Cette propriété ne reflète pas la vitesse réelle du personnage. Si le personnage est bloqué contre le terrain, il peut se déplacer plus lentement que la vitesse définie par movement. À l'inverse, s'il est en chute libre, il peut se déplacer beaucoup plus rapidement.

Valeur par défaut : (0, 0, 0)

Documentation sur les signaux

[since 6.6] shapeHit(PhysicsNode *body, vector3D position, vector3D impulse, vector3D normal)

Ce signal est émis lorsque la fonction movement a été appelée et qu’elle entraînerait une collision avec un DynamicRigidBody ou un StaticRigidBody, et que enableShapeHitCallback est défini sur true. Les paramètres body, position, impulse et normal contiennent le corps, la position, la force d’impulsion et la normale du point de contact.

Ce signal a été introduit dans Qt 6.6.

Documentation de la méthode

void teleport(vector3d position)

Déplacez immédiatement le personnage vers position sans vérifier s'il y a des collisions. Il incombe à l'appelant d'éviter tout chevauchement avec des objets statiques.