Sur cette page

PerspectiveCamera QML Type

Définit une caméra de perspective permettant de visualiser le contenu d'une scène 3D. Plus d'informations...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

Propriétés

Description détaillée

Un Camera définit la manière dont le contenu de la scène 3D est projeté sur une surface 2D, telle qu'un View3D. Une scène nécessite au moins un Camera afin de visualiser son contenu.

Il est possible de positionner et de faire pivoter le Camera comme n'importe quel autre Node de la scène. L'emplacement et l'orientation de Node déterminent l'endroit où se trouve Camera dans la scène et la direction à laquelle il fait face. L'orientation par défaut de Camera est la suivante : son vecteur avant pointe le long de l'axe Z négatif et son vecteur haut le long de l'axe Y positif.

Diagramme de projection d'une caméra en perspective

PerspectiveCamera est le type standard de Camera. Elle donne une projection réaliste de la scène, où les objets éloignés sont perçus comme plus petits. Le tronc commun est défini par la propriété fieldOfView ainsi que par les plans de 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 de 30 degrés vers le bas.

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

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

Documentation sur les propriétés

clipFar : real

Cette propriété définit le plan d'écrêtage lointain du frustum du site PerspectiveCamera. La géométrie qui est plus éloignée de Camera que le plan d'écrêtage lointain ne sera pas visible.

La valeur par défaut est 10000.0. L'unité dépend des unités géométriques de l'utilisateur et la valeur est relative à la position globale de la caméra.

clipNear : real

Cette propriété définit le plan proche du clip du frustum de PerspectiveCamera. La géométrie qui est plus proche de Camera que le plan d'écrêtage proche ne sera pas visible.

La valeur par défaut est 10.0. L'unité dépend des unités géométriques de 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 du champ de vision vertical ou 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 du champ de vision de la caméra.

ConstanteDescription
PerspectiveCamera.VerticalLe champ de vision fourni est vertical, ce qui signifie que le champ de vision correspond à l'angle entre la ligne tracée depuis la caméra jusqu'au centre en haut de la fenêtre et la ligne tracée depuis la caméra jusqu'au centre en bas de la fenêtre. Le rapport d'aspect horizontal sera ajusté pour maintenir 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 à partir de la caméra jusqu'au centre gauche de la fenêtre et la ligne tracée à partir de la caméra jusqu'au centre droit de la fenêtre. Le rapport d'aspect vertical sera ajusté pour maintenir 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.