Qt3DRender::QCameraLens Class
class Qt3DRender::QCameraLensQt3DRender::QCameraLens spécifie la matrice de projection qui sera utilisée pour définir une caméra pour une scène 3D. Plus d'informations...
| 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 : | Qt3DCore::QComponent |
| Statut : | Déclassé |
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 des types de membres
enum QCameraLens::ProjectionType
Spécifie quels paramètres de Qt3DRender::QCameraLens sont utilisés pour calculer la matrice de projection.
| Constante | Valeur | Description des paramètres |
|---|---|---|
Qt3DRender::QCameraLens::OrthographicProjection | 0 | Projection orthogonale |
Qt3DRender::QCameraLens::PerspectiveProjection | 1 | Projection en perspective |
Qt3DRender::QCameraLens::FrustumProjection | 2 | Projection de Frustum |
Qt3DRender::QCameraLens::CustomProjection | 3 | Projection personnalisée définie par l'utilisateur |
Propriété Documentation
aspectRatio : float
Indique le rapport d'aspect actuel de l'objectif de l'appareil photo.
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 | aspectRatio() const |
| void | setAspectRatio(float aspectRatio) |
Signal de notification :
| void | aspectRatioChanged(float aspectRatio) |
bottom : float
Détient le plan inférieur actuel de l'objectif de la caméra.
Remarque : la valeur de retour 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
Maintient 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
Maintient 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
Indique le champ de vision actuel de l'objectif de l'appareil photo.
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
Détient le plan gauche actuel de l'objectif de la caméra.
Remarque : la valeur de retour 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
Maintient 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
Indique 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
Indique 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
Détient le plan droit actuel de l'objectif de la caméra.
Remarque : la valeur de retour 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
Détient le plan supérieur actuel de l'objectif de la caméra.
Remarque : la valeur de retour 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 Notificateur :
| void | topChanged(float top) |
Fonction membre Documentation
[explicit] QCameraLens::QCameraLens(Qt3DCore::QNode *parent = nullptr)
Construit un QCameraLens avec une valeur de parent
[slot] void QCameraLens::setAspectRatio(float aspectRatio)
Définit le rapport d'aspect 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 : fonction de définition de la propriété aspectRatio.
Voir également aspectRatio().
[slot] void QCameraLens::setBottom(float bottom)
Définit la coordonnée de la fenêtre inférieure de la projection à bottom. Cela déclenche une mise à jour de la matrice de projection.
Remarque : ceci n'a aucun effet si le type de projection est Qt3DRender::QCameraLens::PerspectiveProjection.
Remarque : fonction de définition de la propriété bottom.
Voir également bottom().
[slot] void QCameraLens::setExposure(float exposure)
Définit l'objectif de l'appareil photo exposure
Note : Fonction de définition de la propriété exposure.
Voir également exposure().
[slot] void QCameraLens::setFarPlane(float farPlane)
Définit le plan éloigné de la projection à farPlane, ce qui déclenche une mise à jour de la matrice de projection.
Remarque : fonction de 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 : cette fonction n'a aucun effet si le type de projection n'est pas Qt3DRender::QCameraLens::PerspectiveProjection.
Remarque : fonction de définition de la propriété fieldOfView.
Voir également fieldOfView().
void QCameraLens::setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
Définit une projection orthographique basée sur left, right, bottom, top, nearPlane, farPlane.
[slot] void QCameraLens::setLeft(float left)
Définit la coordonnée de la fenêtre inférieure gauche de la projection à 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 : fonction de définition de la propriété left.
Voir également left().
[slot] void QCameraLens::setNearPlane(float nearPlane)
Définit le plan proche de la projection à nearPlane, ce qui déclenche une mise à jour de la matrice de projection.
Remarque : fonction de 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 left, right, bottom, top, nearPlane, farPlane.
void QCameraLens::setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)
Définit une projection en perspective basée sur fieldOfView, aspectRatio, nearPlane, farPlane.
[slot] void QCameraLens::setProjectionMatrix(const QMatrix4x4 &projectionMatrix)
Définit la matrice du projet à projectionMatrix.
Remarque : cette fonction définit le type de projection sur Qt3DRender::QCameraLens::CustomProjection et ignore donc tous les autres paramètres de caméra qui auraient pu être spécifiés.
Remarque : fonction de 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.
Note : Qt3DRender::QCameraLens::Frustum et Qt3DRender::QCameraLens::PerspectiveProjection sont deux façons différentes de spécifier la même projection.
Note : Fonction Setter pour 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 à 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 : fonction de définition de la propriété right.
Voir également right().
[slot] void QCameraLens::setTop(float top)
Définit la coordonnée de la fenêtre supérieure de la projection à 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 : fonction de définition de 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.
