Qt3DRender::QCameraLens Class
class Qt3DRender::QCameraLensQt3DRender::QCameraLens définit la matrice de projection qui sera utilisée pour définir une caméra dans une scène 3D. En savoir plus...
| En-tête : | #include <Qt3DRender/QCameraLens> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | CameraLens |
| Hérite de : | Qt3DCore::QComponent |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | ProjectionType { OrthographicProjection, PerspectiveProjection, FrustumProjection, CustomProjection } |
Propriétés
|
|
Fonctions publiques
| QCameraLens(Qt3DCore::QNode *parent = nullptr) | |
| float | aspectRatio() const |
| float | bottom() const |
| float | exposure() const |
| float | farPlane() const |
| float | fieldOfView() const |
| float | left() const |
| float | nearPlane() const |
| QMatrix4x4 | projectionMatrix() const |
| Qt3DRender::QCameraLens::ProjectionType | projectionType() const |
| float | right() const |
| void | setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane) |
| void | setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane) |
| void | setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane) |
| float | top() const |
Emplacements publics
| void | setAspectRatio(float aspectRatio) |
| void | setBottom(float bottom) |
| void | setExposure(float exposure) |
| void | setFarPlane(float farPlane) |
| void | setFieldOfView(float fieldOfView) |
| void | setLeft(float left) |
| void | setNearPlane(float nearPlane) |
| void | setProjectionMatrix(const QMatrix4x4 &projectionMatrix) |
| void | setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType) |
| void | setRight(float right) |
| void | setTop(float top) |
Signaux
| void | aspectRatioChanged(float aspectRatio) |
| void | bottomChanged(float bottom) |
| void | exposureChanged(float exposure) |
| void | farPlaneChanged(float farPlane) |
| void | fieldOfViewChanged(float fieldOfView) |
| void | leftChanged(float left) |
| void | nearPlaneChanged(float nearPlane) |
| void | projectionMatrixChanged(const QMatrix4x4 &projectionMatrix) |
| void | projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType) |
| void | rightChanged(float right) |
| void | topChanged(float top) |
Documentation sur les types de membres
enum QCameraLens::ProjectionType
Spécifie quels paramètres de la fonction ` Qt3DRender::QCameraLens ` sont utilisés pour calculer la matrice de projection.
| Constante | Valeur | Description |
|---|---|---|
Qt3DRender::QCameraLens::OrthographicProjection | 0 | Projection orthogonale |
Qt3DRender::QCameraLens::PerspectiveProjection | 1 | Projection en perspective |
Qt3DRender::QCameraLens::FrustumProjection | 2 | Projection tronconique |
Qt3DRender::QCameraLens::CustomProjection | 3 | Projection personnalisée définie par l'utilisateur |
Documentation sur les propriétés
aspectRatio : float
Contient le format d'image actuel de l'objectif de la caméra.
Remarque : la valeur renvoyée peut être indéfinie si le type de projection n'est pas « Qt3DRender::QCameraLens::PerspectiveProjection ».
Fonctions d'accès :
| float | aspectRatio() const |
| void | setAspectRatio(float aspectRatio) |
Signal de notification :
| void | aspectRatioChanged(float aspectRatio) |
bottom : float
Contient le plan inférieur actuel de l'objectif de la caméra.
Remarque : la valeur renvoyée peut être indéfinie si le type de projection est « Qt3DRender::QCameraLens::PerspectiveProjection ».
Fonctions d'accès :
| float | bottom() const |
| void | setBottom(float bottom) |
Signal de notification :
| void | bottomChanged(float bottom) |
exposure : float
Conserve l'exposition actuelle de l'objectif de l'appareil photo.
Fonctions d'accès :
| float | exposure() const |
| void | setExposure(float exposure) |
Signal de notification :
| void | exposureChanged(float exposure) |
farPlane : float
Représente le plan proche actuel de l'objectif de la caméra.
Fonctions d'accès :
| float | farPlane() const |
| void | setFarPlane(float farPlane) |
Signal de notification :
| void | farPlaneChanged(float farPlane) |
fieldOfView : float
Contient le champ de vision actuel de l'objectif de la caméra.
Remarque : la valeur de retour peut être indéfinie si le type de projection n'est pas « Qt3DRender::QCameraLens::PerspectiveProjection ».
Fonctions d'accès :
| float | fieldOfView() const |
| void | setFieldOfView(float fieldOfView) |
Signal de notification :
| void | fieldOfViewChanged(float fieldOfView) |
left : float
Contient le plan gauche actuel de l'objectif de la caméra.
Remarque : la valeur renvoyée peut être indéfinie si le type de projection est « Qt3DRender::QCameraLens::PerspectiveProjection ».
Fonctions d'accès :
| float | left() const |
| void | setLeft(float left) |
Signal de notification :
| void | leftChanged(float left) |
nearPlane : float
Représente le plan proche actuel de l'objectif de la caméra.
Fonctions d'accès :
| float | nearPlane() const |
| void | setNearPlane(float nearPlane) |
Signal de notification :
| void | nearPlaneChanged(float nearPlane) |
projectionMatrix : QMatrix4x4
Contient la matrice de projection actuelle de l'objectif de la caméra.
Fonctions d'accès :
| QMatrix4x4 | projectionMatrix() const |
| void | setProjectionMatrix(const QMatrix4x4 &projectionMatrix) |
Signal de notification :
| void | projectionMatrixChanged(const QMatrix4x4 &projectionMatrix) |
projectionType : ProjectionType
Contient le type de projection de la caméra.
Fonctions d'accès :
| Qt3DRender::QCameraLens::ProjectionType | projectionType() const |
| void | setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType) |
Signal de notification :
| void | projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType) |
Voir aussi Qt3DRender::QCameraLens::ProjectionType.
right : float
Contient le plan droit actuel de l'objectif de la caméra.
Remarque : la valeur renvoyée peut être indéfinie si le type de projection est « Qt3DRender::QCameraLens::PerspectiveProjection ».
Fonctions d'accès :
| float | right() const |
| void | setRight(float right) |
Signal de notification :
| void | rightChanged(float right) |
top : float
Contient le plan supérieur actuel de l'objectif de la caméra.
Remarque : la valeur renvoyée peut être indéfinie si le type de projection est « Qt3DRender::QCameraLens::PerspectiveProjection ».
Fonctions d'accès :
| float | top() const |
| void | setTop(float top) |
Signal de notification :
| void | topChanged(float top) |
Documentation des fonctions membres
[explicit] QCameraLens::QCameraLens(Qt3DCore::QNode *parent = nullptr)
Crée un objet `QCameraLens` à partir des paramètres fournis parent
[slot] void QCameraLens::setAspectRatio(float aspectRatio)
Définit le format d'image de la projection sur « aspectRatio ». Cela déclenche une mise à jour de la matrice de projection.
Remarque : cela n'a aucun effet si le type de projection n'est pas « Qt3DRender::QCameraLens::PerspectiveProjection ».
Remarque : fonctionde définition de la propriété ` aspectRatio`.
Voir également ` aspectRatio()`.
[slot] void QCameraLens::setBottom(float bottom)
Définit la coordonnée inférieure de la fenêtre de la projection sur bottom. Cela déclenche une mise à jour de la matrice de projection.
Remarque : cela n'a aucun effet si le type de projection est « Qt3DRender::QCameraLens::PerspectiveProjection ».
Remarque : fonctionde définition pour la propriété ` bottom`.
Voir également bottom().
[slot] void QCameraLens::setExposure(float exposure)
Définit l'objectif de la caméra exposure
Remarque : fonctionde définition de la propriété exposure.
Voir aussi exposure().
[slot] void QCameraLens::setFarPlane(float farPlane)
Définit le plan lointain de la projection sur farPlane. Cela déclenche une mise à jour de la matrice de projection.
Remarque : fonctionde définition de la propriété farPlane.
Voir également farPlane().
[slot] void QCameraLens::setFieldOfView(float fieldOfView)
Définit le champ de vision de la projection à fieldOfView degrés. Cela déclenche une mise à jour de la matrice de projection.
Remarque : cela n'a aucun effet si le type de projection n'est pas « Qt3DRender::QCameraLens::PerspectiveProjection ».
Remarque : fonctionde définition de la propriété ` fieldOfView`.
Voir aussi ` fieldOfView()`.
void QCameraLens::setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
Définit une projection orthographique basée sur les sites suivants : left, right, bottom, top, nearPlane, farPlane.
[slot] void QCameraLens::setLeft(float left)
Définit la coordonnée de coin inférieur gauche de la fenêtre de projection sur left. Cela déclenche une mise à jour de la matrice de projection.
Remarque : cela n'a aucun effet si le type de projection est « Qt3DRender::QCameraLens::PerspectiveProjection ».
Remarque : fonctionde définition de la propriété left.
Voir également left().
[slot] void QCameraLens::setNearPlane(float nearPlane)
Définit le plan proche de la projection sur nearPlane. Cela déclenche une mise à jour de la matrice de projection.
Remarque : fonctionde définition de la propriété nearPlane.
Voir également nearPlane().
void QCameraLens::setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
Définit une projection orthographique basée sur les sites suivants : left, right, bottom, top, nearPlane, farPlane.
void QCameraLens::setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)
Définit une projection en perspective à partir des articles suivants : fieldOfView, aspectRatio, nearPlane, farPlane.
[slot] void QCameraLens::setProjectionMatrix(const QMatrix4x4 &projectionMatrix)
Définit la matrice du projet sur « projectionMatrix ».
Remarque : cela définira le type de projection sur Qt3DRender::QCameraLens::CustomProjection et ignorera donc tous les autres paramètres de caméra qui auraient pu être spécifiés.
Remarque : fonctionde définition de la propriété ` projectionMatrix`.
Voir également projectionMatrix().
[slot] void QCameraLens::setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType)
Définit le type de projection de l'objectif : projectionType.
Remarque : Qt3DRender ::QCameraLens::Frustum et Qt3DRender::QCameraLens::PerspectiveProjection sont deux façons différentes de spécifier la même projection.
Remarque : fonctionde définition de la propriété projectionType.
Voir aussi projectionType().
[slot] void QCameraLens::setRight(float right)
Définit la coordonnée de la fenêtre supérieure droite de la projection sur right. Cela déclenche une mise à jour de la matrice de projection.
Remarque : cela n'a aucun effet si le type de projection est Qt3DRender::QCameraLens::PerspectiveProjection.
Remarque : fonctionde définition de la propriété ` right`.
Voir également right().
[slot] void QCameraLens::setTop(float top)
Définit la coordonnée supérieure de la fenêtre de la projection sur top. Cela déclenche une mise à jour de la matrice de projection.
Remarque : cela n'a aucun effet si le type de projection est Qt3DRender::QCameraLens::PerspectiveProjection.
Remarque : fonctionde définition pour la propriété ` top`.
Voir également ` top()`.
© 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.
