cameraDevice QML Value Type
Décrit un appareil photo. En savoir plus...
| Import Statement: | import QtMultimedia |
| In C++: | QCameraDevice |
Propriétés
- correctionAngle : QtVideo::Rotation
(since 6.7) - description : string
- id : string
- isDefault : bool
- position : enumeration
- videoFormats : CameraFormat
Description détaillée
Le type de valeur cameraDevice décrit les propriétés d'un périphérique de caméra connecté au système.
L'instance `cameraDevice` conserve ses propriétés tout au long de son cycle de vie, même si le périphérique physique correspondant est déconnecté ou si ses paramètres sont modifiés. Pour suivre l'évolution des propriétés, l'utilisateur doit charger de nouvelles instances de `cameraDevice` à partir de ` MediaDevices ` lorsque les signaux correspondants sont déclenchés.
Deux instances « cameraDevice » peuvent être comparées pour vérifier leur égalité. Elles sont considérées comme égales si elles représentent le même périphérique physique, que leurs propriétés soient identiques ou à jour ou non.
La liste des périphériques de caméra peut être consultée à partir du type ` MediaDevices `. Pour sélectionner un périphérique de caméra spécifique, définissez-le comme périphérique sur ` Camera`.
CaptureSession {
camera: Camera {
cameraDevice: mediaDevices.defaultVideoInput
}
}
MediaDevices {
id: mediaDevices
}Documentation sur les propriétés
correctionAngle : QtVideo::Rotation [read-only, since 6.7]
Renvoie l’angle de rotation nécessaire pour compenser la rotation physique de la caméra par rapport à son orientation native. En d’autres termes, cette propriété représente l’angle dans le sens des aiguilles d’une montre dont l’image de sortie doit être pivotée pour s’afficher à l’endroit sur l’écran de l’appareil, dans son orientation native. Comme l'orientation de l'appareil photo ( correctionAngle ) est relative à l'orientation native, cette valeur ne change pas lorsque l'orientation de l'appareil est modifiée (portrait/paysage). L'angle de correction peut être différent de zéro, principalement sur Android, où les orientations native et de l'appareil photo sont définies par le fabricant.
Cette propriété a été introduite dans Qt 6.7.
description : string [read-only]
Contient un nom lisible par l'utilisateur correspondant à la caméra.
Utilisez cette chaîne pour présenter l'appareil à l'utilisateur.
id : string [read-only]
Contient l'identifiant de l'appareil photo
Il s'agit d'un identifiant unique permettant d'identifier la caméra ; il n'est pas forcément lisible par l'utilisateur.
isDefault : bool [read-only]
Cette valeur est vraie si c'est le périphérique de caméra par défaut.
position : enumeration [read-only]
Renvoie la position physique de la caméra sur le système matériel.
La valeur renvoyée peut être l'une des suivantes :
| Constante | Description |
|---|---|
cameraDevice.UnspecifiedPosition | La position de la caméra n'est pas spécifiée ou est inconnue. |
cameraDevice.BackFace | La caméra se trouve à l'arrière du matériel du système. Sur un appareil mobile, par exemple, cela signifie qu'elle est située du côté opposé à celui de l'écran. |
cameraDevice.FrontFace | La caméra se trouve sur la face avant du matériel du système. Sur un appareil mobile, par exemple, cela signifie qu’elle se trouve du même côté que l’écran. L’aperçu des caméras frontales est inversé autour de l’axe vertical afin d’afficher la sortie vidéo en miroir, tandis que cette inversion n’est pas effectuée pendant l’enregistrement. |
videoFormats : CameraFormat [read-only]
Répertorie les formats vidéo pris en charge par l'appareil photo.
© 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.
