ImageCapture QML Type
Une interface pour capturer les images de l'appareil photo. Plus d'informations...
| Import Statement: | import QtMultimedia |
Propriétés
- error : enumeration
- errorString : string
- fileFormat : enumeration
- metaData : mediaMetaData
- preview : string
- quality : enumeration
- readyForCapture : bool
- supportedFormats : list<FileFormat>
(since 6.10)
Signaux
- errorOccurred(id, error, errorString)
- imageCaptured(requestId, preview)
- imageMetadataAvailable(id, metaData)
- imageSaved(id, fileName)
Méthodes
- capture()
- captureToFile(location)
- saveToFile(location)
Description détaillée
Ce type permet de capturer des images fixes et d'être informé de leur disponibilité ou de leur enregistrement sur le disque.
Item { width: 640 height: 360 CaptureSession { imageCapture : ImageCapture { id: imageCapture } camera: Camera { id: camera } videoOutput: videoOutput } VideoOutput { id: videoOutput anchors.fill: parent MouseArea { anchors.fill: parent; onClicked: imageCapture.capture(); } } Image { id: photoPreview source: imageCapture.preview // always shows the last captured image } }
Propriété Documentation
error : enumeration |
Cette propriété contient le dernier type d'erreur qui s'est produit. Il peut s'agir de l'un des types suivants
| Constante | Description |
|---|---|
ImageCapture.NoError | Pas d'erreur. |
ImageCapture.NotReadyError | Le service n'est pas encore prêt pour la capture. |
ImageCapture.ResourceError | Le périphérique n'est pas prêt ou n'est pas disponible. |
ImageCapture.OutOfSpaceError | Il n'y a plus d'espace disponible sur le périphérique. |
ImageCapture.NotSupportedFeatureError | Le périphérique ne prend pas en charge la capture d'images fixes. |
ImageCapture.FormatError | Le format actuel n'est pas pris en charge. |
Voir également errorString.
errorString : string |
Cette propriété contient le dernier message d'erreur qui s'est produit.
Voir également error.
fileFormat : enumeration |
Cette propriété contient le format de fichier pour lequel l'image sera écrite. Il peut s'agir de l'un des formats suivants
| Constante | Description |
|---|---|
UnspecifiedFormat | Aucun format spécifié |
JPEG | .jpg ou .jpeg format |
PNG | .png format |
WebP | .webp format |
Tiff | .tiff format |
metaData : mediaMetaData |
Cette propriété contient les métadonnées qui seront intégrées dans l'image.
preview : string |
Cette propriété contient une url vers la dernière image capturée. Elle peut être connectée à la propriété source d'un élément Image pour afficher la dernière image capturée.
CaptureSession {
camera: Camera {}
imageCapture: ImageCapture {
id: capture
}
}
Image {
source: capture.preview
}Voir également saveToFile.
quality : enumeration |
Cette propriété contient l'indice de qualité lors du stockage de l'image capturée. Elle peut prendre l'une des valeurs suivantes
| Constante | Description |
|---|---|
VeryLowQuality | Très faible |
LowQuality | Faible |
NormalQuality | Normal |
HighQuality | Élevée |
VeryHighQuality | Très élevé |
readyForCapture : bool |
Cette propriété contient une valeur bool indiquant si l'appareil photo est prêt à prendre des photos ou non.
L'appel à capture() ou captureToFile() alors que ready est false n'est pas autorisé et entraîne une erreur.
supportedFormats : list<FileFormat> |
Contient une liste des formats de fichiers pris en charge.
Cette propriété a été introduite dans Qt 6.10.
Voir également fileFormat.
Signal Documentation
errorOccurred(id, error, errorString) |
Ce signal est émis lorsqu'une erreur se produit pendant la capture avec la requête id. error est une énumération de type ImageCapture::Error. Un message descriptif est disponible sur errorString.
Remarque : Le gestionnaire correspondant est onErrorOccurred.
Voir également error et errorString.
imageCaptured(requestId, preview) |
Ce signal est émis lorsqu'une image avec l'identifiant demandé requestId a été capturée mais n'a pas encore été enregistrée dans le système de fichiers. Le paramètre preview est l'image capturée.
Remarque : le gestionnaire correspondant est onImageCaptured.
Voir également imageSaved et preview.
imageMetadataAvailable(id, metaData) |
Ce signal est émis lorsque l'image dont l'identifiant est id a un nouvel identifiant metaData.
Remarque : Le gestionnaire correspondant est onImageMetadataAvailable.
Voir aussi imageCaptured.
imageSaved(id, fileName) |
Ce signal est émis après que l'image avec la demande id a été écrite dans le système de fichiers. fileName est un chemin d'accès à un fichier local, et non une URL.
Remarque : le gestionnaire correspondant est onImageSaved.
Voir aussi imageCaptured.
Documentation de la méthode
capture() |
Lance la capture d'images. Les signaux imageCaptured et imageSaved seront émis lorsque la capture sera terminée.
L'image capturée sera disponible via la propriété de prévisualisation qui peut être utilisée comme source pour un élément QML Image. La méthode saveToFile() peut alors être utilisée pour enregistrer l'image.
La caméra enregistre tous les paramètres de capture tels que les paramètres d'exposition ou les paramètres de traitement de l'image, de sorte que les modifications apportées aux paramètres de la caméra après l'appel de capture() n'affectent pas les demandes de capture précédentes.
capture() renvoie le paramètre capture requestId, utilisé avec les signaux imageExposed(), imageCaptured(), imageMetadataAvailable() et imageSaved().
Voir également readyForCapture et preview.
captureToFile(location) |
saveToFile(location) |
© 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.