QMagnetometerReading Class
Die Klasse „QMagnetometerReading“ repräsentiert einen Messwert des Magnetometers. Mehr...
| Kopfzeile: | #include <QMagnetometerReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| Erbt von: | QSensorReading |
Eigenschaften
- calibrationLevel : qreal
- x : qreal
- y : qreal
- z : qreal
Öffentliche Funktionen
| qreal | calibrationLevel() const |
| void | setCalibrationLevel(qreal calibrationLevel) |
| void | setX(qreal x) |
| void | setY(qreal y) |
| void | setZ(qreal z) |
| qreal | x() const |
| qreal | y() const |
| qreal | z() const |
Detaillierte Beschreibung
QMagnetometerReading-Einheiten
Das Magnetometer gibt Werte für die magnetische Flussdichte entlang dreier Achsen zurück. Die Werte werden in Tesla angegeben. Die Achsen sind wie folgt angeordnet.
Das Magnetometer kann entweder Rohwerte des magnetischen Flusses oder geomagnetische Flusswerte ausgeben. Standardmäßig gibt es Rohwerte des magnetischen Flusses zurück. Die Eigenschaft „ QMagnetometer::returnGeoValues “ muss gesetzt werden, um geomagnetische Flusswerte zurückzugeben.
Der Hauptunterschied zwischen Roh- und geomagnetischen Werten besteht darin, dass die geomagnetischen Werte einer zusätzlichen Verarbeitung unterzogen werden, um lokale magnetische Störungen zu eliminieren, sodass sie ausschließlich den Einfluss des Erdmagnetfelds widerspiegeln. Dieser Prozess ist nicht perfekt, und die Genauigkeit der einzelnen Messwerte kann variieren.
Das folgende Bild zeigt den Unterschied zwischen geomagnetischen (links) und Rohwerten (rechts) für ein Smartphone, das magnetischen Störungen ausgesetzt ist.
Die Genauigkeit jedes Messwerts wird als Zahl zwischen 0 und 1 angegeben. Ein Wert von 1 ist die höchste Stufe, die das Gerät unterstützen kann, und 0 ist die schlechteste.
Kalibrierung
Wenn das Gerät eine geringe Genauigkeit meldet, ist möglicherweise eine Kalibrierung erforderlich, bevor akzeptable Messwerte geliefert werden können. Eine einfache Kalibrierung lässt sich in der Regel entweder durch Drehen des Geräts in einer Acht oder durch Drehen des Geräts entlang jeder seiner drei Achsen durchführen. Weitere Informationen zur Kalibrierung des Magnetsensors finden Sie in der Dokumentation Ihres Geräts.
Dokumentation zu den Eigenschaften
[read-only] calibrationLevel : qreal
Diese Eigenschaft gibt die Genauigkeit des Messwerts an.
Gemessen wird ein Wert zwischen 0 und 1, wobei höhere Werte besser sind.
Beachten Sie, dass sich dieser Wert nur bei der Messung der geomagnetischen Flussdichte ändert. Die Rohwerte des magnetischen Flusses haben immer den Wert 1.
Zugriffsfunktionen:
| qreal | calibrationLevel() const |
Siehe auch QMagnetometerReading Units und Calibration.
[read-only] x : qreal
Diese Eigenschaft enthält die rohe magnetische Flussdichte auf der X-Achse.
Gemessen in Tesla.
Zugriffsfunktionen:
| qreal | x() const |
Siehe auch „ QMagnetometerReading Units “.
[read-only] y : qreal
Diese Eigenschaft enthält die rohe magnetische Flussdichte auf der Y-Achse.
Gemessen in Tesla.
Zugriffsfunktionen:
| qreal | y() const |
Siehe auch „ QMagnetometerReading Units “.
[read-only] z : qreal
Diese Eigenschaft enthält die rohe magnetische Flussdichte entlang der Z-Achse.
Gemessen in Tesla.
Zugriffsfunktionen:
| qreal | z() const |
Siehe auch „ QMagnetometerReading Units “.
Dokumentation der Member-Funktionen
void QMagnetometerReading::setCalibrationLevel(qreal calibrationLevel)
Legt die Genauigkeit des Messwerts auf „ calibrationLevel “ fest.
Siehe auch calibrationLevel().
void QMagnetometerReading::setX(qreal x)
Setzt die rohe magnetische Flussdichte auf der X-Achse auf x.
Siehe auch x().
void QMagnetometerReading::setY(qreal y)
Setzt die rohe magnetische Flussdichte auf der Y-Achse auf y.
Siehe auch ` y()`.
void QMagnetometerReading::setZ(qreal z)
Setzt die rohe magnetische Flussdichte auf der Z-Achse auf z.
Siehe auch z().
© 2026 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.
