cameraDevice QML Value Type

Beschreibt ein Kameragerät. Mehr...

Eigenschaften

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

Ausführliche Beschreibung

Der Werttyp „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 oder dessen Einstellungen geändert werden. Um den Überblick über aktualisierte Eigenschaften zu behalten, sollte der Benutzer neue Instanzen von „cameraDevice“ aus „ MediaDevices “ laden, sobald 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 repräsentieren, unabhängig davon, ob ihre Eigenschaften identisch oder auf dem neuesten Stand sind.

Die Liste der Kamerageräte kann über den Typ „ MediaDevices “ abgefragt werden. Um ein bestimmtes Kameragerät auszuwählen, legen Sie es unter „ Camera “ als Gerät fest.

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

Dokumentation zu den Eigenschaften

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

Gibt den Drehwinkel zurück, der erforderlich ist, um die physische Drehung der Kamera gegenüber ihrer nativen Ausrichtung auszugleichen. Mit anderen Worten: Die Eigenschaft gibt den Winkel im Uhrzeigersinn an, um den das Ausgabebild gedreht werden muss, damit es auf dem Bildschirm des Geräts in seiner nativen Ausrichtung aufrecht steht. Da „ correctionAngle “ relativ zur nativen Ausrichtung ist, ändert sich dieser Wert nicht, wenn die Geräteausrichtung (Hochformat/Querformat) geändert wird. Der Korrekturwinkel kann vor allem auf Android-Geräten von Null abweichen, wo die native Ausrichtung und die Kameraausrichtung vom Hersteller festgelegt werden.

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 diese Zeichenfolge, um das Gerät dem Benutzer zu präsentieren.

id : string [read-only]

Enthält die Geräte-ID der Kamera

Dies ist eine eindeutige ID zur Identifizierung der Kamera, die möglicherweise nicht für Menschen lesbar ist.

isDefault : bool [read-only]

Gilt, wenn dies das Standard-Kameragerät ist.

position : enumeration [read-only]

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

Der Rückgabewert kann einer der folgenden Werte sein:

videoFormats : CameraFormat [read-only]

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