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);
});

Dokumentation zu den Eigenschaften

active : bool

Gibt an, ob die Kamera derzeit aktiv ist.

Zugriffsfunktionen:

Benachrichtigungssignal:

cameraDevice : QCameraDevice

Gibt das mit dieser Kamera verknüpfte „ QCameraDevice “-Objekt zurück.

Beim Wechseln der Kamerageräte werden die Funktionen des „ QCamera “ aktualisiert. Zudem werden die Steuerungseigenschaften des „ QCamera “ (wie z. B. „ focusMode “, „ flashMode “, „ focusDistance “ und „ zoomFactor “) wie folgt aktualisiert:

• Wird eine Eigenschaft auf dem neuen Gerät unterstützt, wird der Wert dieser Eigenschaft auf das Kameragerät angewendet.
• Wenn eine Eigenschaft zwar unterstützt wird, sich ihr gültiger Wertebereich jedoch geändert hat, wird die Eigenschaft auf den neuen Wertebereich begrenzt und auf das Kameragerät angewendet.
• Wenn das neue Kameragerät eine Eigenschaft nicht unterstützt, wird der Eigenschaftswert auf den Standardwert zurückgesetzt, und es werden keine Änderungen am Kameragerät vorgenommen.

Zugriffsfunktionen:

Benachrichtigungssignal:

cameraFormat : QCameraFormat

Gibt das derzeit von der Kamera verwendete Kameraformat zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QCameraDevice::videoFormats “.

colorTemperature : int

Gibt die aktuelle Farbtemperatur zurück, wenn der aktuelle Weißabgleichmodus „ WhiteBalanceManual “ ist. Bei anderen Modi ist der Rückgabewert undefiniert.

Zugriffsfunktionen:

Benachrichtigungssignal:

customFocusPoint : QPointF

Diese Eigenschaft gibt die Position des benutzerdefinierten Fokuspunkts in relativen Rahmenkoordinaten an: QPointF(0,0) verweist auf den oberen linken Eckpunkt des Rahmens, QPointF(0,5,0,5) verweist auf die Mitte des Rahmens.

Sie können überprüfen, ob benutzerdefinierte Fokuspunkte unterstützt werden, indem Sie supportedFeatures() mit dem Flag „Feature.CustomFocusPoint “ abfragen.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] error : Error

Gibt den Fehlerstatus der Kamera zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QCamera::Error “.

[read-only] errorString : QString

Gibt eine für Menschen lesbare Zeichenfolge zurück, die den Fehlerzustand einer Kamera beschreibt.

Zugriffsfunktionen:

Benachrichtigungssignal:

exposureCompensation : float

Belichtungskorrektur in EV-Einheiten.

Mit der Belichtungskorrektur können Sie die automatisch berechnete Belichtung anpassen.

Zugriffsfunktionen:

Benachrichtigungssignal:

exposureMode : QCamera::ExposureMode

Diese Eigenschaft enthält den aktuell verwendeten Belichtungsmodus.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QCamera::isExposureModeSupported “.

[read-only] exposureTime : float

Belichtungszeit der Kamera in Sekunden.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch minimumExposureTime(), maximumExposureTime() und setManualExposureTime().

flashMode : QCamera::FlashMode

Diese Eigenschaft enthält den aktuell verwendeten Blitzmodus.

Aktiviert einen bestimmten Blitzmodus, sofern die Kamera über einen Blitz verfügt.

Die Zuweisung eines nicht unterstützten Modus zu dieser Eigenschaft hat keine Auswirkung.

Diese Eigenschaft wirkt sich nur aus, wenn Bilder mit QImageCapture

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QCamera::FlashMode “, „ QCamera::isFlashModeSupported “ und „ QCamera::isFlashReady “.

[read-only] flashReady : bool

Zeigt an, ob der Blitz aufgeladen und einsatzbereit ist.

Zugriffsfunktionen:

Notifier-Signal:

focusDistance : float

Diese Eigenschaft legt die Fokusentfernung des Objektivs fest, wenn sich das Kameragerät im manuellen Fokusmodus befindet. Gültige Werte liegen zwischen 0 und 1, wobei 0 die kürzestmögliche Fokusentfernung und 1 die weiteste darstellt. Der am weitesten entfernte Punkt liegt in der Regel im Unendlichen, was jedoch möglicherweise nicht für alle Geräte zutrifft.

Diese Eigenschaft wird nur dann auf das Gerät angewendet, wenn „ focusMode “ auf „ FocusModeManual “ gesetzt ist und „ supportedFeatures “ das Flag „ Feature::FocusDistance “ enthält.

Wenn Sie dieser Eigenschaft einen Wert zuweisen, während „ focusMode “ nicht auf „ QCamera::FocusModeManual “ gesetzt ist, speichert die Eigenschaft den Wert, wirkt sich jedoch erst auf das Gerät aus, sobald „ QCamera::FocusModeManual “ aktiv ist.

Die Zuweisung eines Werts außerhalb des gültigen Bereichs [0, 1] hat keine Auswirkungen auf diese Eigenschaft.

Wenn „ supportedFeatures “ das Flag „ FocusDistance “ nicht enthält, wird jeder Versuch, diese Eigenschaft festzulegen, ignoriert.

Diese Eigenschaft wird von der Kamera nicht aktualisiert, wenn sie sich im Autofokus-Modus befindet.

Der Standardwert ist 1.

Zugriffsfunktionen:

Benachrichtigungssignal:

focusMode : FocusMode

Diese Eigenschaft enthält den aktuellen Fokusmodus der Kamera.

Diese Eigenschaft enthält den Wert, der den Fokusmodus für das Kameragerät steuert. In allen Autofokus-Modi fokussiert das Kameragerät kontinuierlich.

Um zu prüfen, ob das Kameragerät einen bestimmten Fokusmodus unterstützt, übergeben Sie den entsprechenden Wert von „ FocusMode “ als Parameter an die Funktion „ isFocusModeSupported “. Die Funktion gibt „false“ zurück, wenn der Fokusmoduswert nicht unterstützt wird. Die Zuweisung eines nicht unterstützten Modus zu dieser Eigenschaft hat keine Auswirkung.

Wenn Sie die Eigenschaft „focusMode“ auf „ QCamera::FocusModeManual “ setzen, wird der Fokus des Objektivs gemäß „ focusDistance “ arretiert.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` isFocusModeSupported()`.

[read-only] focusPoint : QPointF

Gibt den Punkt zurück, auf den das Autofokus-System derzeit fokussiert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] isoSensitivity : int

Diese Eigenschaft enthält die ISO-Empfindlichkeit des Sensors.

Beschreibt die derzeit von der Kamera verwendete ISO-Empfindlichkeit.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch setAutoIsoSensitivity() und setManualIsoSensitivity().

manualExposureTime : float

Stellen Sie die manuelle Belichtungszeit auf seconds

Zugriffsfunktionen:

Benachrichtigungssignal:

manualIsoSensitivity : int

Beschreibt eine manuell eingestellte ISO-Empfindlichkeit

Wird diese Eigenschaft auf -1 (Standardwert) gesetzt, passt die Kamera die ISO-Empfindlichkeit automatisch an.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] maximumZoomFactor : float

Gibt den maximalen Zoomfaktor zurück.

Bei Kameras, die kein Zoomen unterstützen, ist dies „ 1.0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] minimumZoomFactor : float

Gibt den minimalen Zoomfaktor zurück.

Bei Kameras, die kein Zoomen unterstützen, ist dies „ 1.0 “.

Zugriffsfunktionen:

Notifier-Signal:

[read-only] supportedFeatures : Features

Gibt die von dieser Kamera unterstützten Funktionen zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QCamera::Feature “.

torchMode : QCamera::TorchMode

Diese Eigenschaft speichert den aktuell verwendeten Taschenlampenmodus.

Eine Taschenlampe ist eine kontinuierliche Lichtquelle. Sie kann bei Videoaufnahmen unter schlechten Lichtverhältnissen verwendet werden. Durch das Aktivieren des Taschenlampenmodus wird in der Regel der aktuell eingestellte Blitzmodus außer Kraft gesetzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QCamera::TorchMode, QCamera::isTorchModeSupported und QCamera::flashMode.

whiteBalanceMode : WhiteBalanceMode

Gibt den aktuell verwendeten Weißabgleichmodus zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

zoomFactor : float

Diese Eigenschaft enthält den aktuellen Zoomfaktor.

Ruft den aktuellen Zoomfaktor ab oder legt ihn fest. Die Werte werden auf den Bereich zwischen minimumZoomFactor und maximumZoomFactor begrenzt.

Zugriffsfunktionen:

Benachrichtigungssignal: