Sur cette page

CustomCamera QML Type

Définit une caméra avec une matrice de projection personnalisée. En savoir plus...

Import Statement: import QtQuick3D
Inherits:

Camera

Propriétés

Description détaillée

Une « Camera » définit la manière dont le contenu d’une scène 3D est projeté sur une surface 2D, telle qu’un « View3D ». Une scène nécessite au moins une « Camera » pour que son contenu puisse être visualisé.

Il est possible de positionner et de faire pivoter l’ Camera comme n’importe quel autre Node spatial de la scène. L’emplacement et l’orientation de l’ Node déterminent où se trouve l’ Camera dans la scène, ainsi que la direction vers laquelle il est orienté. Par défaut, l’orientation de l’ Camera est telle que son vecteur avant pointe le long de l’axe Z négatif et son vecteur haut le long de l’axe Y positif.

Le type CustomCamera fournit une Camera où la matrice de projection peut être personnalisée librement.

L'exemple suivant crée une CustomCamera à la position [0, 200, 300] dans la scène, avec une inclinaison de 30 degrés vers le bas, ainsi qu'une matrice de projection personnalisée basée sur des distances de plans proche et lointain personnalisées et un champ de vision personnalisé.

CustomCamera {
    position: Qt.vector3d(0, 200, 300)
    eulerRotation.x: -30

    property real near: 10.0
    property real far: 10000.0
    property real fov: 60.0 * Math.PI / 180.0
    projection: Qt.matrix4x4(Math.cos(fov / 2) / Math.sin(fov / 2) * (window.height / window.width), 0, 0, 0,
                             0, Math.cos(fov / 2) / Math.sin(fov / 2), 0, 0,
                             0, 0, -(near + far) / (far - near), -(2.0 * near * far) / (far - near),
                             0, 0, -1, 0);
}

Remarque : lors de l’utilisation de CustomCamera, certains modes d’anti-aliasing (AA temporel et AA progressif) ne peuvent pas être appliqués correctement.

Voir également PerspectiveCamera, OrthographicCamera et FrustumCamera.

Documentation des propriétés

projection : matrix4x4

Cette propriété définit la matrice de projection de l'CustomCamera.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.