Camera QML Type

Définit un point de vue à partir duquel la scène sera rendue. En savoir plus...

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans les nouveaux codes.

• Liste de tous les membres, y compris les membres hérités
• Membres obsolètes

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 relative au bien immobilier

aspectRatio : real

Conserve le format d'image actuel de la caméra.

bottom : real

Contient la coordonnée horizontale actuelle de la caméra.

Cette propriété n'est pertinente que lorsque la propriété « projectionType » est définie sur « CameraLens.OrthographicProjection ».

exposure : real

Contient l'exposition actuelle de l'appareil photo.

La valeur par défaut est 0,0.

Le matériau MetalRoughMaterial, disponible dans la section « Extras » d'Qt 3D, est actuellement le seul matériau fourni qui utilise l'exposition de la caméra. Les valeurs négatives assombrissent le matériau, tandis que les valeurs positives l'éclaircissent.

Les matériaux personnalisés peuvent choisir d’interpréter cette valeur différemment.

farPlane : real

Stocke le plan lointain actuel de la caméra. Les objets situés plus loin de la caméra que le plan lointain ne seront pas affichés.

fieldOfView : real

Stocke le champ de vision vertical actuel de la caméra, exprimé en degrés.

Avec la propriété ` 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 l'équivalent du choix d'un objectif grand angle (champ de vision horizontal large) ou d'un téléobjectif (champ de vision horizontal étroit), selon la partie de la scène que vous souhaitez capturer.

La propriété `fieldOfView` n’est pertinente que lorsque ` projectionType ` est défini sur `CameraLens.PerspectiveProjection`.

left : real

Contient la coordonnée « gauche » actuelle de la caméra.

Cette propriété n'est pertinente que lorsque la propriété « projectionType » est définie sur « CameraLens.OrthographicProjection ».

lens : CameraLens [read-only]

Contient le composant « CameraLens » de la caméra.

nearPlane : real

Définit le plan proche de la caméra actuelle. Les objets situés plus près de la caméra que le plan proche ne seront pas affichés.

position : vector3d

Contient la position actuelle de la caméra en coordonnées relatives à l'entité parente.

projectionMatrix : matrix4x4

Contient la matrice de projection actuelle de la caméra.

projectionType : enumeration

Stocke le type de projection de la caméra. La valeur par défaut est CameraLens.PerspectiveProjection.

• CameraLens.OrthographicProjection - Les lignes parallèles restent parallèles. Les objets apparaissent de la même taille quelle que soit leur distance.
• CameraLens.PerspectiveProjection : les lignes parallèles semblent converger 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

Contient la projection actuelle de la caméra.

Cette propriété n'est pertinente que lorsque ` projectionType ` est défini sur `CameraLens.OrthographicProjection`.

top : real

Contient la position actuelle du haut de la caméra.

Cette propriété n'est pertinente que lorsque ` projectionType ` est défini sur `CameraLens.OrthographicProjection`.

transform : Transform [read-only]

Contient le composant « Transform » de la caméra.

upVector : vector3d

Contient le vecteur « up » actuel de la caméra en coordonnées relatives à l'entité parente.

Le vecteur « up » indique la direction vers laquelle est orientée la partie supérieure de la caméra. Imaginez que vous prenez une photo : après vous être positionné et avoir pointé la caméra vers votre sujet, vous pouvez faire pivoter la caméra vers la gauche ou vers la droite pour obtenir une photo en portrait, en paysage (ou en oblique !). upVector vous permet de contrôler ce type de mouvement.

viewCenter : vector3d

Stocke le centre de vue actuel de la caméra en coordonnées relatives à l'entité parente.

Concrètement, le « viewCenter » correspond à l'emplacement vers lequel la caméra est orientée.

viewVector : vector3d [read-only]

Contient le vecteur de vue de la caméra en coordonnées relatives à l'entité parente.

Ce vecteur décrit le déplacement entre la caméra (position) et sa cible (viewCenter).

Documentation de la méthode

void pan(real angle)

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

void pan(real angle, vector3d axis)

Règle le panoramique de la caméra autour du centre de la vue d'angle, en degrés, sur axis.

void panAboutViewCenter(real angle)

Règle le panoramique de la caméra autour du centre de la vue de angle en degrés.

void panAboutViewCenter(real angle, vector3d axis)

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

quaternion panRotation(real angle)

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

void roll(real angle)

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

void rollAboutViewCenter(real angle)

Permet de régler l'inclinaison de la caméra par rapport au centre de la vue de l'angle, en degrés.

quaternion rollRotation(real angle)

Renvoie la rotation en roulis calculée par rapport à l’ angle, exprimée en degrés, utilisée pour ajuster la rotation en roulis ou l’inclinaison vers la gauche ou vers la droite de la caméra sur l’axe Z.

void rotate(quaternion q)

Permet de faire pivoter la caméra à l'aide d'un quaternion dans ` q`.

void rotateAboutViewCenter(quaternion q)

Permet de faire 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'angle, exprimée en degrés, et à l'axis e choisie.

void tilt(real angle)

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

void tiltAboutViewCenter(real angle)

Règle 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 à l'angle, exprimée en degrés, utilisée pour ajuster l'inclinaison de la caméra ou sa rotation vers le haut ou vers le bas sur l'axe X.

void translate(vector3d vLocal, enumeration option)

Translate la position de la caméra et son vecteur de vue d’ vLocal e en coordonnées locales. L’ option permet de choisir si le centre de la vue doit être déplacé ou non.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Voir également ` Qt3DRender::QCamera::CameraTranslationOption`.

void translateWorld(vector3d vWorld, enumeration option)

Translate la position de la caméra et son vecteur de vue d'vWorld s dans les coordonnées mondiales. L'option permet de choisir si le centre de la vue doit être déplacé ou non.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Voir également Qt3DRender::QCamera::CameraTranslationOption.

void viewAll()

Fait pivoter et déplace la caméra de manière à ce que s viewCenter e coïncide avec le centre du volume englobant la scène et que celle-ci tienne entièrement dans la fenêtre d'affichage.

Voir aussi Qt3D.Render::Camera::projectionType.

void viewEntity(Entity entity)

Fait pivoter et déplace la caméra de manière à ce que s viewCenter e coïncide avec le centre du volume englobant de l'entité et que l'entity e entière tienne dans la fenêtre d'affichage.

Voir aussi Qt3D.Render::Camera::projectionType.

void viewSphere(vector3d center, real radius)

Fait pivoter et déplace la caméra de manière à ce que son axe d'viewCenter e soit center et qu'une sphère de radius tienne dans la fenêtre d'affichage.

Voir aussi Qt3D.Render::Camera::projectionType.