Camera QML Type
Définit un point de vue à travers lequel la scène sera rendue. Plus d'informations...
Propriétés
- aspectRatio : real
- bottom : real
- exposure : real
- farPlane : real
- fieldOfView : real
- left : real
- lens : CameraLens
- nearPlane : real
- position : vector3d
- projectionMatrix : matrix4x4
- projectionType : enumeration
- right : real
- top : real
- transform : Transform
- upVector : vector3d
- viewCenter : vector3d
- viewVector : vector3d
Méthodes
- void pan(real angle)
- void pan(real angle, vector3d axis)
- void panAboutViewCenter(real angle)
- void panAboutViewCenter(real angle, vector3d axis)
- quaternion panRotation(real angle)
- void roll(real angle)
- void rollAboutViewCenter(real angle)
- quaternion rollRotation(real angle)
- void rotate(quaternion q)
- void rotateAboutViewCenter(quaternion q)
- quaternion rotation(real angle, vector3d axis)
- void tilt(real angle)
- void tiltAboutViewCenter(real angle)
- quaternion tiltRotation(real angle)
- void translate(vector3d vLocal, enumeration option)
- void translateWorld(vector3d vWorld, enumeration option)
- void viewAll()
- void viewEntity(Entity entity)
- void viewSphere(vector3d center, real radius)
Description détaillée
Propriété Documentation
aspectRatio : real |
Indique le rapport d'aspect actuel de la caméra.
bottom : real |
Détient le fond actuel de la caméra.
Cette propriété n'est pertinente que lorsque projectionType est CameraLens.OrthographicProjection.
exposure : real |
Indique l'exposition actuelle de la caméra.
La valeur par défaut est 0,0.
Le matériel MetalRoughMaterial dans Qt 3D Extras est actuellement le seul matériel fourni qui utilise l'exposition de la caméra. Les valeurs négatives assombrissent le matériau et les valeurs positives l'éclaircissent.
Les matériaux personnalisés peuvent choisir d'interpréter la valeur différemment.
farPlane : real |
Maintient le plan éloigné actuel de la caméra. Les objets qui sont plus éloignés de la caméra que le plan éloigné ne seront pas rendus.
fieldOfView : real |
Indique le champ de vision vertical actuel de la caméra en degrés.
Avec aspectRatio, cette propriété détermine la partie de la scène visible par la caméra. À cet égard, vous pouvez la considérer comme analogue au choix d'un objectif grand angle (champ de vision horizontal large) ou d'un téléobjectif (champ de vision horizontal étroit), en fonction de la partie de la scène que vous souhaitez capturer.
fieldOfView n'est pertinent que lorsque projectionType est CameraLens. PerspectiveProjection.
left : real |
Détient la gauche actuelle de la caméra.
Cette propriété n'est pertinente que si projectionType est CameraLens.OrthographicProjection.
lens : CameraLens |
Indique la composante CameraLens de la caméra.
nearPlane : real |
Détient le plan actuel de la caméra proche de la caméra. Les objets qui sont plus proches de la caméra que le plan proche ne seront pas rendus.
position : vector3d |
Indique la position actuelle de la caméra en coordonnées par rapport à l'entité parente.
projectionMatrix : matrix4x4 |
Indique la matrice de projection actuelle de la caméra.
projectionType : enumeration |
Indique le type de projection de la caméra. La valeur par défaut est CameraLens.PerspectiveProjection.
- CameraLens.OrthographicProjection - Les lignes parallèles apparaissent parallèles. Les objets ont la même taille quelle que soit la distance.
- CameraLens.PerspectiveProjection - Les lignes parallèles semblent se rejoindre au loin. Les objets semblent rétrécir à mesure qu'ils s'éloignent de la caméra.
- CameraLens.FrustumProjection
- CameraLens.CustomProjection
Voir également Qt3DRender::QCameraLens::ProjectionType.
right : real |
Détient la droite actuelle de la caméra.
Cette propriété n'est pertinente que lorsque projectionType est CameraLens. OrthographicProjection.
top : real |
Détient le haut actuel de la caméra.
Cette propriété n'est pertinente que si projectionType est CameraLens.OrthographicProjection.
transform : Transform |
Détient la composante de transformation de la caméra.
upVector : vector3d |
Détient le vecteur ascendant actuel de la caméra en coordonnées relatives à l'entité mère.
Le vecteur ascendant indique la direction dans laquelle le haut de la caméra est orienté. Imaginez que vous preniez une photo : après vous être positionné et avoir pointé l'appareil photo vers votre cible, vous pouvez faire pivoter l'appareil vers la gauche ou vers la droite, ce qui vous donne un portrait ou un paysage (ou un angle !). upVector vous permet de contrôler ce type de mouvement.
viewCenter : vector3d |
Détient le centre de vue actuel de la caméra en coordonnées relatives à l'entité parente.
Intuitivement, le viewCenter est l'endroit vers lequel pointe la caméra.
viewVector : vector3d |
Détient le vecteur de vue de la caméra en coordonnées relatives à l'entité mère.
Ce vecteur décrit le déplacement de la caméra (position) vers sa cible (viewCenter).
Documentation de la méthode
void pan(real angle) |
Ajuste l'angle panoramique de la caméra par angle en degrés.
Ajuste l'angle panoramique de la caméra par rapport au centre de la vue de angle en degrés sur axis.
void panAboutViewCenter(real angle) |
Ajuste l'angle panoramique de la caméra autour du centre de la vue de angle en degrés.
Ajuste l'angle panoramique de la caméra par rapport au centre de la vue de angle en degrés sur axis.
quaternion panRotation(real angle) |
Renvoie la rotation panoramique calculée par rapport à angle en degrés pour ajuster le panoramique de la caméra ou la rotation gauche/droite sur l'axe Y.
void roll(real angle) |
Ajuste le rouleau de la caméra de angle en degrés.
void rollAboutViewCenter(real angle) |
Ajuste le roulis de la caméra par rapport au centre de la vue de angle en degrés.
quaternion rollRotation(real angle) |
Renvoie la rotation calculée par rapport à angle en degrés pour ajuster le roulis de la caméra ou la rotation gauche/droite sur l'axe Z.
void rotate(quaternion q) |
Fait pivoter la caméra à l'aide d'un quaternion à l'adresse q.
void rotateAboutViewCenter(quaternion q) |
Fait pivoter la caméra autour du centre de la vue à l'aide d'un quaternion dans q.
quaternion rotation(real angle, vector3d axis) |
Renvoie la rotation calculée par rapport à l'adresse angle en degrés et l'adresse axis choisie.
void tilt(real angle) |
Ajuste l'angle d'inclinaison de la caméra de angle en degrés.
void tiltAboutViewCenter(real angle) |
Ajuste l'inclinaison de la caméra par rapport au centre de la vue de angle en degrés.
quaternion tiltRotation(real angle) |
Renvoie la rotation d'inclinaison calculée par rapport à angle en degrés pour ajuster l'inclinaison de la caméra ou la rotation haut/bas sur l'axe X.
void translate(vector3d vLocal, enumeration option) |
Traduit la position de la caméra et son vecteur de vue de vLocal en coordonnées locales. L'adresse option permet d'activer ou de désactiver la translation du centre de la vue.
- Camera.TranslateViewCenter
- Camera.DontTranslateViewCenter
Voir également Qt3DRender::QCamera::CameraTranslationOption.
void translateWorld(vector3d vWorld, enumeration option) |
Traduit la position de la caméra et son vecteur de vue par vWorld en coordonnées mondiales. L'option option permet d'activer ou de désactiver la translation du centre de la vue.
- Camera.TranslateViewCenter
- Camera.DontTranslateViewCenter
Voir également Qt3DRender::QCamera::CameraTranslationOption.
void viewAll() |
Fait pivoter et déplace la caméra de manière à ce que viewCenter soit le centre du volume délimité de la scène et que la scène entière tienne dans le port de visualisation.
Remarque : ne fonctionne que si l'objectif est en mode de projection perspective ou orthographique.
Voir également Qt3D.Render::Camera::projectionType.
void viewEntity(Entity entity) |
Fait pivoter et déplace la caméra de manière à ce que viewCenter soit le centre du volume délimité de l'entité et que l'ensemble de entity tienne dans le port de visualisation.
Remarque : ne fonctionne que si l'objectif est en mode perspective ou projection orthographique.
Voir également Qt3D.Render::Camera::projectionType.
Fait pivoter et déplace la caméra de manière à ce que viewCenter soit center et qu'une sphère de radius s'insère dans le port de visualisation.
Remarque : ne fonctionne que si l'objectif est en mode perspective ou projection orthographique.
Voir aussi Qt3D.Render::Camera::projectionType.
© 2025 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.