Camera QML Type

Définit un point de vue à travers lequel la scène sera rendue. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• Membres dépréciés

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

Documentation sur les propriétés

aspectRatio : real

Indique le rapport d'aspect actuel de l'appareil photo.

bottom : real

Détient le bas actuel de la caméra.

Cette propriété n'est pertinente que lorsque projectionType est CameraLens.OrthographicProjection.

exposure : real

Indique l'exposition actuelle de l'appareil photo.

La valeur par défaut est 0,0.

Le site 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

Détient 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 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 lorsque projectionType est CameraLens.OrthographicProjection.

lens : CameraLens [read-only]

Contient la composante CameraLens de la caméra.

nearPlane : real

Détient le plan proche actuel 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é mère.

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

Indique le sommet actuel de la caméra.

Cette propriété n'est pertinente que lorsque projectionType est CameraLens.OrthographicProjection.

transform : Transform [read-only]

Contient le composant Transform de la caméra.

upVector : vector3d

Contient le vecteur haut actuel de la caméra en coordonnées relatives à l'entité mère.

Le vecteur haut 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 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

Indique le centre de vision actuel de la caméra en coordonnées par rapport à l'entité mère.

Intuitivement, le viewCenter est l'endroit vers lequel pointe la caméra.

viewVector : vector3d [read-only]

Contient 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)

Règle l'angle panoramique de la caméra par angle en degrés.

void pan(real angle, vector3d axis)

Ajuste le panoramique de la caméra autour du centre de la vue en angle en degrés sur axis.

void panAboutViewCenter(real angle)

Ajuste le panoramique de la caméra par rapport au centre de la vue en angle en degrés.

void panAboutViewCenter(real angle, vector3d axis)

Ajuste le panoramique de la caméra autour du centre de la vue en angle en degrés sur axis.

quaternion panRotation(real angle)

Renvoie la rotation panoramique calculée par rapport à l'adresse angle en degrés pour ajuster le panoramique ou la rotation gauche/droite de la caméra sur l'axe Y.

void roll(real angle)

Permet d'ajuster le rouleau d'images par angle en degrés.

void rollAboutViewCenter(real angle)

Ajuste le rouleau de la caméra autour du centre de la vue par angle en degrés.

quaternion rollRotation(real angle)

Renvoie la rotation de roulis calculée par rapport à angle en degrés pour ajuster le roulis ou la rotation gauche/droite de la caméra sur l'axe Z.

void rotate(quaternion q)

Rotation de la caméra à l'aide d'un quaternion dans 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 à angle en degrés et choisie axis prise en compte.

void tilt(real angle)

Règle l'angle d'inclinaison de la caméra par angle en degrés.

void tiltAboutViewCenter(real angle)

Règle l'inclinaison de la caméra par rapport au centre de la vue en angle en degrés.

quaternion tiltRotation(real angle)

Renvoie la rotation de l'inclinaison calculée par rapport à l'adresse angle en degrés pour ajuster l'inclinaison ou la rotation vers le haut ou vers le bas de la caméra sur l'axe X.

void translate(vector3d vLocal, enumeration option)

Traduit la position de la caméra et son vecteur de vue par 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'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 viewAll()

Fait pivoter et déplace la caméra de façon à 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.

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'intégralité de entity tienne dans le port de visualisation.

Voir également Qt3D.Render::Camera::projectionType.

void viewSphere(vector3d center, real radius)

Fait pivoter et déplace la caméra de façon à ce que son adresse viewCenter soit center et qu'une sphère de radius s'insère dans la fenêtre de visualisation.

Voir également Qt3D.Render::Camera::projectionType.