CharacterController QML Type

Steuert die Bewegung einer Figur. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Signale

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

Methoden

• void teleport(vector3d position)

Ausführliche Beschreibung

Der Typ „CharacterController“ steuert die Bewegung eines Charakters.

Ein Charakter ist ein Objekt, das sich unter externer Steuerung bewegt, dabei jedoch durch physikalische Hindernisse eingeschränkt wird und (optional) der Schwerkraft unterliegt. Dies steht im Gegensatz zu „ dynamic rigid bodies “, die entweder vollständig von der Physiksimulation gesteuert werden (bei nicht-kinematischen Körpern) oder sich unabhängig von Hindernissen genau an die Stelle bewegen, an der sie platziert wurden (bei kinematischen Objekten).

Um die Bewegung eines Charakter-Controllers zu steuern, setzen Sie „ movement “ auf die gewünschte Geschwindigkeit.

Bei einer First-Person-Perspektive wird die Kamera in der Regel innerhalb eines Charakter-Controllers platziert.

Siehe auch „Qt Quick 3D: Physikformen, Körper und Gelenke“.

Dokumentation zu den Eigenschaften

collisions : Collisions [read-only]

Diese Eigenschaft enthält den aktuellen Kollisionsstatus des Charakters. Sie ist entweder „ None “ für keine Kollision oder eine ODER-Kombination aus „ Side “, „ Up “ und „ Down “:

enableShapeHitCallback : bool [since 6.6]

Diese Eigenschaft aktiviert bzw. deaktiviert den Callback „ CharacterController::shapeHit “ für diesen Charakter-Controller.

Standardwert: false

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

gravity : vector3d

Diese Eigenschaft definiert die Schwerkraftbeschleunigung, die auf den Charakter wirkt. Für einen Charakter, der auf dem Boden läuft, sollte sie in der Regel auf „ PhysicsWorld.gravity “ gesetzt werden. Ein schwebender Charakter, der sich in drei Dimensionen bewegen kann, hat normalerweise eine Schwerkraft von „ (0, 0, 0) “.

Standardwert: (0, 0, 0).

midAirControl : bool

Diese Eigenschaft legt fest, ob die Eigenschaft „ movement “ wirksam ist, wenn sich der Charakter im freien Fall befindet. Dies ist nur relevant, wenn „ gravity “ nicht null ist. Der Wert „ true “ bedeutet, dass der Charakter in der Luft die Richtung wechselt, sobald sich „ movement “ ändert. Der Wert „ false “ bedeutet, dass der Charakter seine aktuelle Flugbahn beibehält, bis er auf ein anderes Objekt trifft.

Standardwert: true

movement : vector3d

Diese Eigenschaft definiert die kontrollierte Bewegung des Charakters. Dabei handelt es sich um die Geschwindigkeit, mit der sich der Charakter ohne Schwerkraft und ohne Wechselwirkung mit anderen Physikobjekten bewegen würde.

Diese Eigenschaft spiegelt nicht die tatsächliche Geschwindigkeit des Charakters wider. Wenn der Charakter am Gelände feststeckt, kann er sich langsamer bewegen als die durch „ movement “ definierte Geschwindigkeit. Umgekehrt kann er sich im freien Fall möglicherweise viel schneller bewegen.

Standardwert: (0, 0, 0)

Signal-Dokumentation

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

Dieses Signal wird ausgelöst, wenn „ movement “ aufgerufen wurde und dies zu einer Kollision mit „ DynamicRigidBody “ oder „ StaticRigidBody “ führen würde und „ enableShapeHitCallback “ auf „ true “ gesetzt ist. Die Parameter „ body “, „ position “, „ impulse “ und „ normal “ enthalten den Körper, die Position, die Impulskraft und die Normale für den Kontaktpunkt.

Dieses Signal wurde in Qt 6.6 eingeführt.

Methodendokumentation

void teleport(vector3d position)

Bewegen Sie die Figur sofort an die Position ` position `, ohne auf Kollisionen zu prüfen. Der Aufrufer ist dafür verantwortlich, Überschneidungen mit statischen Objekten zu vermeiden.