OrbitCameraController QML Type

Contrôleur de caméra qui tourne autour d'un point d'origine. Plus d'informations...

• 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

Cette aide permet de faire tourner une caméra autour d'un point d'origine. Pour fonctionner, OrbitCameraController accepte un nœud comme origine, et 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, il a 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 sera mise en orbite autour du nœud d'origine.

L'élément OrbitCameraController lui-même est un élément 2D qui accepte les événements d'entrée, de sorte que sa taille et sa position seront celles où les événements d'entrée sont acceptés. Pour zoomer, utilisez la molette de la souris ou effectuez un geste de pincement. Pour faire pivoter la zone, cliquez ou touchez-la et faites-la glisser. Pour effectuer un panoramique, maintenez la touche "contrôle" 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 sur les 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]

Active la mise à jour automatique des propriétés clipNear et l{PerspectiveCamera::}{clipFar} de 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 la 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 de la souris.

origin : QtQuick3D::Node

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

panEnabled : bool [default: true]

Active les commandes de panoramique.

xInvert : bool [default: false]

Inverse les contrôles de l'axe des x.

xSpeed : real [default: 0.1]

Spécifie la vitesse de navigation lorsque la souris est déplacée le long de l'axe X.

yInvert : bool [default: true]

Inverse les contrôles de l'axe des y.

ySpeed : real [default: 0.1]

Spécifie la vitesse de navigation lorsque la souris est déplacée le long de l'axe Y.