Sur cette page

PerspectiveCamera QML Type

Définit une caméra de perspective permettant de visualiser le contenu d'une scène 3D. En savoir plus...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

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 a besoin d’au moins un « 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, le vecteur « forward » de l’ Camera est orienté le long de l’axe Z négatif et son vecteur « up » le long de l’axe Y positif.

Schéma de projection d'une caméra en perspective

PerspectiveCamera est le type d’ Camera e standard. Elle offre une projection réaliste de la scène, dans laquelle les objets éloignés sont perçus comme plus petits. Le frustum est défini par la propriété « fieldOfView » ainsi que par les plans de découpe proche et lointain.

L'exemple suivant crée une PerspectiveCamera à la position [0, 200, 300] dans la scène, avec un champ de vision de 90 degrés et une inclinaison vers le bas de 30 degrés.

PerspectiveCamera {
    position: Qt.vector3d(0, 200, 300)
    eulerRotation.x: -30
    fieldOfView: 90
}

Voir également Qt Quick 3D - Exemple View3D, OrthographicCamera, FrustumCamera et CustomCamera.

Documentation sur les propriétés

clipFar : real

Cette propriété définit le plan de découpe lointain du cône de projection de l'PerspectiveCamera. Les éléments géométriques situés plus loin de l'Camera que le plan de découpe lointain ne seront pas visibles.

La valeur par défaut est 10000,0. L'unité dépend des unités de géométrie choisies par l'utilisateur, et la valeur est relative à la position globale de la caméra.

clipNear : real

Cette propriété définit le plan de découpe proche du cône de projection de l'PerspectiveCamera. Les éléments géométriques situés plus près de l'Camera que du plan de découpe proche ne seront pas visibles.

La valeur par défaut est 10,0. L'unité dépend des unités de géométrie choisies par l'utilisateur, et la valeur est relative à la position globale de la caméra.

fieldOfView : real

Cette propriété indique le champ de vision de la caméra en degrés. Il peut s'agir soit du champ de vision vertical, soit du champ de vision horizontal, selon que la propriété « fieldOfViewOrientation » est définie sur « PerspectiveCamera.Vertical » ou « PerspectiveCamera.Horizontal ».

La valeur par défaut est 60,0.

fieldOfViewOrientation : enumeration

Cette propriété définit l'orientation selon laquelle le champ de vision de la caméra est spécifié.

ConstanteDescription
PerspectiveCamera.VerticalLe champ de vision fourni est vertical, ce qui signifie qu’il correspond à l’angle formé entre la ligne tracée de la caméra vers le centre supérieur de la fenêtre d’affichage et la ligne tracée de la caméra vers le centre inférieur de la fenêtre d’affichage. Le rapport d’aspect horizontal sera ajusté pour conserver le rapport d’aspect.
PerspectiveCamera.HorizontalLe champ de vision fourni est horizontal, ce qui signifie que le champ de vision correspond à l’angle entre la ligne tracée de la caméra vers le centre gauche de la fenêtre d’affichage et la ligne tracée de la caméra vers le centre droit de la fenêtre d’affichage. Le rapport d’aspect vertical sera ajusté pour préserver le rapport d’aspect.

La valeur par défaut est PerspectiveCamera.Vertical.

© 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.