QCamera Class

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras) {
    if (cameraDevice.description() == "mycamera")
        camera = new QCamera(cameraDevice);
}

camera->setZoomFactor(3.0);

camera->setWhiteBalanceMode(QCamera::WhiteBalanceFluorescent);

qApp->requestPermission(
    QCameraPermission{},
    [](const QPermission &permission) {
        if (permission.status() == Qt::PermissionStatus::Granted)
            camera->setActive(true);
    });

Documentation sur les propriétés

active : bool

Indique si la caméra est actuellement active.

Fonctions d'accès :

Signal de notification :

cameraDevice : QCameraDevice

Renvoie l'objet QCameraDevice associé à cette caméra.

En cas de changement de caméra, les capacités de l'objet QCamera sont mises à jour. En outre, les propriétés de contrôle de l'objet QCamera(telles que focusMode, flashMode, focusDistance, zoomFactor) sont mises à jour comme suit :

• Si une propriété est prise en charge par le nouveau dispositif, la valeur de la propriété est appliquée au dispositif de la caméra.
• Si une propriété est prise en charge mais que sa plage de valeurs valides a été modifiée, la propriété est adaptée à la nouvelle plage et appliquée au dispositif de caméra.
• Si le nouveau dispositif de caméra ne prend pas en charge une propriété, la valeur de la propriété est réinitialisée à la valeur par défaut et aucune modification n'est apportée au dispositif de caméra.

Fonctions d'accès :

Signal de notification :

cameraFormat : QCameraFormat

Renvoie le format de caméra actuellement utilisé par la caméra.

Fonctions d'accès :

Signal Notificateur :

Voir aussi QCameraDevice::videoFormats.

colorTemperature : int

Renvoie la température de couleur actuelle si le mode de balance des blancs actuel est WhiteBalanceManual. Pour les autres modes, la valeur de retour est indéfinie.

Fonctions d'accès :

Signal de notification :

customFocusPoint : QPointF

Cette propriété représente la position du point de focalisation personnalisé, en coordonnées de cadre relatives : QPointF(0,0) correspond au point de cadre supérieur gauche, QPointF(0,5,0,5) correspond au centre du cadre.

Vous pouvez vérifier si les points de focalisation personnalisés sont pris en charge en interrogeant supportedFeatures() avec l'option Feature.CustomFocusPoint.

Fonctions d'accès :

Signal de notification :

[read-only] error : Error

Renvoie l'état d'erreur de la caméra.

Fonctions d'accès :

Signal de notification :

Voir aussi QCamera::Error.

[read-only] errorString : QString

Renvoie une chaîne lisible par l'homme décrivant l'état d'erreur d'une caméra.

Fonctions d'accès :

Signal de notification :

exposureCompensation : float

Compensation de l'exposition en unités EV.

La propriété de compensation de l'exposition permet d'ajuster l'exposition calculée automatiquement.

Fonctions d'accès :

Signal de notification :

exposureMode : QCamera::ExposureMode

Cette propriété contient le mode d'exposition utilisé.

Fonctions d'accès :

Signal de notification :

Voir aussi QCamera::isExposureModeSupported.

[read-only] exposureTime : float

Temps d'exposition de la caméra en secondes.

Fonctions d'accès :

Signal de notification :

Voir également minimumExposureTime(), maximumExposureTime() et setManualExposureTime().

flashMode : QCamera::FlashMode

Cette propriété contient le mode flash utilisé.

Elle active un certain mode de flash si l'appareil photo est équipé d'un flash.

L'attribution d'un mode non pris en charge à cette propriété n'a aucun effet.

Cette propriété n'a d'effet que lors de la capture d'images à l'aide d'un flash. QImageCapture

Fonctions d'accès :

Signal de notification :

Voir également QCamera::FlashMode, QCamera::isFlashModeSupported, et QCamera::isFlashReady.

[read-only] flashReady : bool

Indique si le flash est chargé et prêt à être utilisé.

Fonctions d'accès :

Signal de notification :

focusDistance : float

Cette propriété définit la distance de mise au point de l'objectif lorsque l'appareil photo fonctionne en mode de mise au point manuelle. Les valeurs valides sont comprises entre 0 et 1, 0 étant la distance de mise au point la plus proche possible et 1 la plus éloignée. Le point le plus éloigné est généralement à l'infini, mais ce n'est pas forcément le cas pour tous les appareils.

Cette propriété n'est appliquée à l'appareil que lorsque focusMode est défini sur FocusModeManual et que supportedFeatures inclut l'indicateur Feature::FocusDistance.

Si vous attribuez une valeur à cette propriété alors que focusMode n'est pas défini sur QCamera::FocusModeManual, la propriété enregistre la valeur mais n'affecte pas le dispositif jusqu'à ce que QCamera::FocusModeManual soit actif.

L'attribution d'une valeur en dehors de la plage valide [0, 1] n'a aucun effet sur cette propriété.

Si supportedFeatures n'inclut pas l'indicateur FocusDistance, toute tentative de définition de cette propriété est ignorée.

Cette propriété n'est pas mise à jour par la caméra lorsqu'elle est en mode de mise au point automatique.

La valeur par défaut est 1.

Fonctions d'accès :

Signal de notification :

focusMode : FocusMode

Cette propriété indique le mode de mise au point actuel de la caméra.

Cette propriété contient la valeur qui contrôle le mode de mise au point de l'appareil photo. Dans tous les modes de mise au point automatique, l'appareil photo effectue une mise au point continue.

Pour vérifier si le périphérique de la caméra prend en charge un mode de mise au point particulier, transmettez la valeur FocusMode correspondante à la fonction isFocusModeSupported en tant que paramètre. La fonction renvoie un message faux si la valeur du mode de mise au point n'est pas prise en charge. L'attribution d'un mode non pris en charge à cette propriété n'a aucun effet.

Si vous attribuez la valeur QCamera::FocusModeManual à la propriété focusMode, l'objectif se verrouille sur la mise au point conformément à focusDistance.

Fonctions d'accès :

Signal de notification :

Voir également isFocusModeSupported().

[read-only] focusPoint : QPointF

Renvoie le point actuellement utilisé par le système de mise au point automatique pour faire la mise au point.

Fonctions d'accès :

Signal de notification :

[read-only] isoSensitivity : int

Cette propriété contient la sensibilité ISO du capteur.

Décrit la sensibilité ISO actuellement utilisée par l'appareil photo.

Fonctions d'accès :

Signal de notification :

Voir également setAutoIsoSensitivity() et setManualIsoSensitivity().

manualExposureTime : float

Régler le temps d'exposition manuelle sur seconds

Accéder aux fonctions :

Signal de notification :

manualIsoSensitivity : int

Décrit une sensibilité ISO réglée manuellement

Le fait de régler cette propriété sur -1 (valeur par défaut) implique que l'appareil photo règle automatiquement la sensibilité ISO.

Fonctions d'accès :

Signal de notification :

[read-only] maximumZoomFactor : float

Renvoie le facteur de zoom maximal.

Il s'agit de 1.0 pour les caméras qui ne prennent pas en charge le zoom.

Fonctions d'accès :

Signal de notification :

[read-only] minimumZoomFactor : float

Renvoie le facteur de zoom minimum.

Il s'agit de 1.0 pour les caméras qui ne prennent pas en charge le zoom.

Fonctions d'accès :

Signal de notification :

[read-only] supportedFeatures : Features

Renvoie les caractéristiques prises en charge par cette caméra.

Fonctions d'accès :

Signal de notification :

Voir aussi QCamera::Feature.

torchMode : QCamera::TorchMode

Cette propriété indique le mode de torche utilisé.

Une torche est une source de lumière continue. Elle peut être utilisée pendant l'enregistrement vidéo dans des conditions de faible luminosité. L'activation du mode torche a généralement pour effet de remplacer le mode flash actuellement défini.

Fonctions d'accès :

Signal de notification :

Voir également QCamera::TorchMode, QCamera::isTorchModeSupported, et QCamera::flashMode.

whiteBalanceMode : WhiteBalanceMode

Renvoie le mode de balance des blancs utilisé.

Fonctions d'accès :

Signal de notification :

zoomFactor : float

Cette propriété contient le facteur de zoom actuel.

Obtient ou définit le facteur de zoom actuel. Les valeurs sont comprises entre minimumZoomFactor et maximumZoomFactor.

Fonctions d'accès :

Signal de notification :