QCamera Class

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

camera->setZoomFactor(camera->maximumZoomFactor()); // zoom in as much as possible

camera->setWhiteBalanceMode(QCamera::WhiteBalanceManual);
camera->setColorTemperature(5600);

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.

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

• Si une propriété est prise en charge par le nouvel appareil, sa valeur est appliquée à 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 limitée à la nouvelle plage et appliquée à la caméra.
• Si le nouvel appareil photo ne prend pas en charge une propriété, la valeur de cette propriété est réinitialisée à sa valeur par défaut et aucune modification n’est apportée à l’appareil photo.

Fonctions d’accès :

Signal de notification :

cameraFormat : QCameraFormat

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

Fonctions d’accès :

Signal de notification :

Voir également 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 renvoyée n'est pas définie.

Fonctions d’accès :

Signal de notification :

customFocusPoint : QPointF

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

Vous pouvez vérifier si les points de mise au point personnalisés sont pris en charge en interrogeant la méthode supportedFeatures() avec le drapeau 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 décrivant l'état d'erreur d'une caméra.

Fonctions d'accès :

Signal de notification :

exposureCompensation : float

Compensation d'exposition en unités EV.

La fonction de compensation d'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 actuellement utilisé.

Fonctions d'accès :

Signal de notification :

Voir aussi QCamera::isExposureModeSupported.

[read-only] exposureTime : float

Temps d'exposition de l'appareil photo 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 actuellement utilisé.

Active un mode flash spécifique 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 de 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 à l'emploi.

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 vont de 0 à 1, où 0 correspond à la distance de mise au point la plus proche possible et 1 à la plus éloignée. Le point le plus éloigné se situe généralement à l'infini, mais cela peut ne pas être le cas pour tous les appareils.

Cette propriété s’applique à l’appareil uniquement 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 l’option « focusMode » n’est pas définie sur « QCamera::FocusModeManual », la propriété enregistre la valeur mais n’affecte pas le périphérique tant que l’option « QCamera::FocusModeManual » n’est pas active.

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 configuration de cette propriété est ignorée.

Cette propriété ne sera 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é contient le mode de mise au point actuel de l'appareil photo.

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 en continu.

Pour vérifier si l'appareil photo prend en charge un mode de mise au point particulier, transmettez la valeur correspondante de ` FocusMode ` à la fonction ` isFocusModeSupported ` en tant que paramètre. La fonction renvoie `false` 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 définissez la propriété focusMode sur QCamera::FocusModeManual, l'objectif verrouille 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 effectuer la mise au point.

Fonctions d'accès :

Signal de notification :

[read-only] isoSensitivity : int

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

Elle 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églez la durée d'exposition manuelle sur seconds

Fonctions d'accès :

Signal de notification :

manualIsoSensitivity : int

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

Si cette propriété est définie sur -1 (valeur par défaut), cela signifie 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.

Cette valeur sera égale à 1.0 sur les appareils photo ne prenant pas en charge le zoom.

Fonctions d'accès :

Signal de notification :

[read-only] minimumZoomFactor : float

Renvoie le facteur de zoom minimal.

Cette valeur sera égale à 1.0 sur les caméras qui ne prennent pas en charge le zoom.

Fonctions d'accès :

Signal de notification :

[read-only] supportedFeatures : Features

Renvoie les fonctionnalités prises en charge par cet appareil photo.

Fonctions d'accès :

Signal de notification :

Voir aussi QCamera::Feature.

torchMode : QCamera::TorchMode

Cette propriété contient le mode « lampe de poche » actuellement utilisé.

Une lampe 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 lampe torche remplace généralement tout mode flash actuellement sélectionné.

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 actuellement utilisé.

Fonctions d'accès :

Signal de notification :

zoomFactor : float

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

Récupère ou définit le facteur de zoom actuel. Les valeurs sont limitées entre minimumZoomFactor et maximumZoomFactor.

Fonctions d'accès :

Signal de notification :