cameraDevice QML Value Type

Beschreibt ein Kameragerät. Mehr...

Import Statement:	`import QtMultimedia`
In C++:	QCameraDevice

Eigenschaften

correctionAngle : QtVideo::Rotation (since 6.7)
description : string
id : string
isDefault : bool
position : enumeration
videoFormats : CameraFormat

Detaillierte Beschreibung

Der Wertetyp cameraDevice beschreibt die Eigenschaften eines an das System angeschlossenen Kamerageräts.

Die cameraDevice-Instanz behält ihre Eigenschaften während ihrer gesamten Lebensdauer bei, selbst wenn das entsprechende physische Gerät getrennt wird oder seine Einstellungen geändert werden. Um die aktualisierten Eigenschaften im Auge zu behalten, sollte der Benutzer neue Instanzen von cameraDevice von MediaDevices laden, wenn die entsprechenden Signale ausgelöst werden.

Zwei cameraDevice-Instanzen können auf Gleichheit verglichen werden. Sie gelten als gleich, wenn sie dasselbe physische Gerät darstellen, unabhängig davon, ob ihre Eigenschaften gleich oder aktuell sind.

Die Liste der Kamerageräte kann über den Typ MediaDevices abgefragt werden. Um ein bestimmtes Kameragerät auszuwählen, setzen Sie es als Gerät auf Camera.

CaptureSession {
    camera: Camera {
        cameraDevice: mediaDevices.defaultVideoInput
    }
}
MediaDevices {
    id: mediaDevices
}

Eigenschaft Dokumentation

correctionAngle : QtVideo::Rotation [read-only, since 6.7]

Gibt den Drehwinkel zurück, der benötigt wird, um die physische Kameradrehung der Kamera im Vergleich zu ihrer nativen Ausrichtung zu kompensieren. Mit anderen Worten: Die Eigenschaft gibt den Winkel im Uhrzeigersinn an, um den das Ausgabebild gedreht werden muss, um auf dem Bildschirm des Geräts in seiner nativen Ausrichtung aufrecht zu stehen. Da correctionAngle sich auf die ursprüngliche Ausrichtung bezieht, ändert sich dieser Wert nicht, wenn die Ausrichtung des Geräts (Hochformat/Landschaft) geändert wird. Der Korrekturwinkel kann ungleich Null sein, vor allem bei Android, wo die native Ausrichtung und die Kameraausrichtung vom Hersteller definiert werden.

$Beispiel mit 90 Grad \a KorrekturWinkel$

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

description : string [read-only]

Enthält einen für Menschen lesbaren Namen der Kamera.

Verwenden Sie diesen String, um dem Benutzer das Gerät vorzustellen.

id : string [read-only]

Beinhaltet die Geräte-ID der Kamera

Dies ist eine eindeutige ID zur Identifizierung der Kamera, die nicht unbedingt von Menschen lesbar ist.

isDefault : bool [read-only]

Ist true, wenn dies das Standardgerät der Kamera ist.

position : enumeration [read-only]

Gibt die physische Position der Kamera auf dem Hardwaresystem zurück.

Der zurückgegebene Wert kann einer der folgenden sein:

Konstante	Beschreibung
`cameraDevice.UnspecifiedPosition`	Die Kameraposition ist nicht spezifiziert oder unbekannt.
`cameraDevice.BackFace`	Die Kamera befindet sich auf der Rückseite der Systemhardware. Bei einem mobilen Gerät bedeutet dies beispielsweise, dass sie sich auf der dem Bildschirm gegenüberliegenden Seite befindet.
`cameraDevice.FrontFace`	Die Kamera befindet sich auf der Vorderseite der Systemhardware. Bei einem mobilen Gerät bedeutet dies, dass sie sich auf der gleichen Seite wie der Bildschirm befindet. Die Vorschau von nach vorne gerichteten Kameras wird um die vertikale Achse gedreht, um die Videoausgabe spiegelverkehrt anzuzeigen, während diese Drehung bei der Aufnahme nicht erfolgt.

videoFormats : CameraFormat [read-only]

Enthält die von der Kamera unterstützten Videoformate.

© 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.