OrbitCameraController QML Type

Contrôleur de caméra qui pivote autour d'une origine. En savoir plus...

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

Propriétés

• acceptedButtons : Qt::MouseButtons (since 6.9)
• automaticClipping : bool (since 6.9)
• camera : QtQuick3D::Camera
• mouseEnabled : bool
• origin : QtQuick3D::Node
• panEnabled : bool
• xInvert : bool
• xSpeed : real
• yInvert : bool
• ySpeed : real

Description détaillée

Cet assistant permet de faire pivoter une caméra autour d'une origine. Pour fonctionner, OrbitCameraController accepte un nœud (Node) comme origine, ainsi qu'un objet Camera qui doit être un enfant du nœud d'origine à contrôler. En ajustant uniquement la position z de la caméra enfant par rapport à l’origine parent, on obtient pour effet de rapprocher ou d’éloigner la caméra de l’origine cible. En appliquant une rotation au nœud d’origine, la caméra enfant effectuera une orbite autour de ce nœud.

L'élément OrbitCameraController est lui-même un élément 2D qui accepte les événements d'entrée ; ainsi, quelles que soient sa taille et sa position, c'est à cet endroit que les événements d'entrée seront acceptés. Pour zoomer, utilisez la molette de la souris ou effectuez un geste de pincement. Pour faire pivoter, cliquez ou touchez puis faites glisser la zone. Pour effectuer un panoramique, maintenez la touche Ctrl enfoncée et faites glisser la zone. Le panoramique modifie la position du nœud d’origine. Il est également possible d’effectuer un geste de panoramique en faisant glisser deux doigts.

View3D {
    camera: cameraNode
    Node {
        id: originNode
        PerspectiveCamera {
            id: cameraNode
            z: 100
        }
    }
    OrbitCameraController {
        anchors.fill: parent
        origin: originNode
        camera: cameraNode
    }
    ...
}

Documentation des propriétés

acceptedButtons : Qt::MouseButtons [default: Qt.LeftButton, since 6.9]

Spécifie le bouton de la souris qui contrôle la caméra.

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

automaticClipping : bool [default: true, since 6.9]

Permet la mise à jour automatique des propriétés clipNear et l{PerspectiveCamera::}{clipFar} de l'camera, en fonction de la position z de la caméra.

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

camera : QtQuick3D::Camera

Spécifie le nœud de caméra à contrôler. Il s'agit d'une propriété obligatoire qui doit être un enfant du nœud « origin ».

mouseEnabled : bool [default: true]

Active les commandes à la souris.

origin : QtQuick3D::Node

Spécifie le nœud d'origine à contrôler. Il s'agit d'une propriété obligatoire qui doit correspondre au parent du camera

panEnabled : bool [default: true]

Active les commandes de panoramique.

xInvert : bool [default: false]

Inverse les commandes de l'axe x.

xSpeed : real [default: 0.1]

Définit la vitesse de déplacement lorsque la souris est déplacée le long de l'axe X.

yInvert : bool [default: true]

Inverse les commandes de l'axe des y.

ySpeed : real [default: 0.1]

Définit la vitesse de déplacement lorsque la souris est déplacée le long de l'axe Y.