cameraDevice QML Value Type
Décrit un appareil photo. Plus d'informations...
| 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 appareil photo connecté au système.
L'instance de cameraDevice conserve ses propriétés tout au long de sa durée de vie, même si le dispositif physique correspondant est déconnecté ou si ses paramètres sont modifiés. Pour garder une trace des propriétés mises à jour, l'utilisateur doit charger de nouvelles instances de cameraDevice à partir de MediaDevices lorsque les signaux pertinents sont émis.
Deux instances de cameraDevice peuvent être comparées pour déterminer leur égalité. Elles sont considérées comme égales si elles représentent le même dispositif physique, que leurs propriétés soient égales ou actualisées.
La liste des dispositifs de caméra peut être consultée à partir du type MediaDevices. Pour sélectionner un certain dispositif de caméra, définissez-le comme dispositif 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 d'origine. En d'autres termes, cette propriété représente l'angle dans le sens des aiguilles d'une montre selon lequel l'image de sortie doit être tournée pour être à l'endroit sur l'écran de l'appareil dans son orientation d'origine. Étant donné que correctionAngle est relatif à l'orientation native, cette valeur ne change pas en cas de modification de l'orientation de l'appareil (portrait/paysage). L'angle de correction peut être différent de zéro, surtout sur Android, où l'orientation native et l'orientation 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'homme pour 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 qui permet d'identifier la caméra et qui peut ne pas être lisible par l'homme.
isDefault : bool [read-only]
Est vrai s'il s'agit du dispositif 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 sur la face arrière du matériel du système. Par exemple, sur un appareil mobile, cela signifie qu'elle se trouve du côté opposé à celui de l'écran. |
cameraDevice.FrontFace | La caméra se trouve sur la face avant du matériel. Par exemple, sur un appareil mobile, cela signifie qu'elle se trouve du même côté que l'écran. La prévisualisation des caméras frontales est inversée autour de l'axe vertical pour afficher la sortie vidéo comme un miroir, alors que cette inversion n'est pas effectuée pendant l'enregistrement. |
videoFormats : CameraFormat [read-only]
Indique 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.
