CharacterController QML Type

Contrôle le mouvement d'un personnage. Plus d'informations...

• 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 le mouvement d'un personnage.

Un personnage est une entité qui se déplace sous un contrôle externe, mais qui reste limitée par des barrières physiques et (éventuellement) soumise à la gravité. Ceci contraste avec dynamic rigid bodies qui est soit complètement contrôlé par la simulation physique (pour les corps non cinématiques), soit se déplace exactement là où il est placé, sans tenir compte des barrières (pour les objets cinématiques).

Pour contrôler le mouvement d'un contrôleur de personnage, réglez movement sur 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 la documentation générale sur les formes et les corps.

Documentation sur les propriétés

collisions : Collisions [read-only]

Cette propriété contient l'état de collision actuel du personnage. Il s'agit soit de None pour une absence de collision, soit d'une combinaison OU de Side, Up, et Down:

enableShapeHitCallback : bool [since 6.6]

Cette propriété active/désactive le rappel CharacterController::shapeHit pour ce contrôleur de caractères.

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 qui marche sur le sol, elle doit généralement être réglée sur PhysicsWorld.gravity. Pour un personnage flottant dont les mouvements sont contrôlés en trois dimensions, l'accélération gravitationnelle est normalement fixée à (0, 0, 0).

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

midAirControl : bool

Cette propriété définit si la propriété movement a un effet lorsque le personnage est en chute libre. Cette propriété n'est pertinente que si gravity n'est pas null. Une valeur de true signifie que le personnage changera de direction en plein vol lorsque movement changera. Une valeur de false signifie que le personnage continuera sur 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 coincé contre un terrain, il peut se déplacer plus lentement que la vitesse définie par movement. Inversement, si le personnage est en chute libre, il peut se déplacer beaucoup plus rapidement.

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

Signal Documentation

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

Ce signal est émis lorsque movement a été appelé et qu'il en résulterait une collision avec un DynamicRigidBody ou un StaticRigidBody et que enableShapeHitCallback est défini comme true. Les paramètres body, position, impulse et normal contiennent le corps, la position, la force d'impulsion et la normale pour le point de contact.

Ce signal a été introduit dans Qt 6.6.

Documentation de la méthode

void teleport(vector3d position)

Déplace immédiatement le personnage sur position sans vérifier les collisions. L'appelant est responsable de l'absence de chevauchement avec des objets statiques.