QMagnetometerReading Class
Die Klasse QMagnetometerReading stellt einen Messwert des Magnetometers dar. Mehr...
| Kopfzeile: | #include <QMagnetometerReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors)target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| Vererbungen: | QSensorReading |
Eigenschaften
- calibrationLevel : const qreal
- x : const qreal
- y : const qreal
- z : const 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
QMagnetometerLesen Einheiten
Das Magnetometer liefert Werte für die magnetische Flussdichte entlang von 3 Achsen. Die Skala der Werte ist Tesla. Die Achsen sind wie folgt angeordnet.
Das Magnetometer kann entweder Rohwerte des magnetischen Flusses oder geomagnetische Flusswerte liefern. Standardmäßig werden die Werte des rohen magnetischen Flusses geliefert. Die Eigenschaft QMagnetometer::returnGeoValues muss eingestellt werden, um geomagnetische Flusswerte zurückzugeben.
Der Hauptunterschied zwischen rohen und geomagnetischen Werten besteht darin, dass die geomagnetischen Werte zusätzlich verarbeitet werden, um lokale magnetische Störungen zu eliminieren, so dass sie nur die Wirkung des Erdmagnetfeldes darstellen. Dieser Prozess ist nicht perfekt und die Genauigkeit der einzelnen Messwerte kann sich ändern.
Die Abbildung unten zeigt den Unterschied zwischen den geomagnetischen (links) und den Rohdaten (rechts) für ein Telefon, das magnetischen Störungen ausgesetzt ist.
Die Genauigkeit der einzelnen Messwerte wird als Zahl von 0 bis 1 gemessen. Ein Wert von 1 ist der höchste Pegel, den das Gerät unterstützen kann, und 0 ist der schlechteste.
Kalibrierung
Wenn das Gerät eine geringe Genauigkeit anzeigt, ist möglicherweise eine Kalibrierung erforderlich, bevor akzeptable Messungen geliefert werden können. Eine grundlegende Kalibrierung kann in der Regel entweder durch Drehen des Geräts in einer Acht oder durch Drehen des Geräts um jede seiner drei Achsen erfolgen. Weitere Informationen finden Sie in der Dokumentation Ihres Geräts zur Kalibrierung des Magnetsensors.
Dokumentation der Eigenschaft
[read-only] calibrationLevel : const qreal
Diese Eigenschaft gibt die Genauigkeit der Ablesung an.
Gemessen als ein Wert von 0 bis 1, wobei höhere Werte besser sind.
Beachten Sie, dass sich dies nur bei der Messung der geomagnetischen Flussdichte ändert. Rohwerte des magnetischen Flusses haben immer einen Wert von 1.
Zugriffsfunktionen:
| qreal | calibrationLevel() const |
Siehe auch QMagnetometerReading Units und Calibration.
[read-only] x : const 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 : const 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 : const qreal
Diese Eigenschaft enthält die rohe magnetische Flussdichte auf der Z-Achse.
Gemessen in Tesla.
Zugriffsfunktionen:
| qreal | z() const |
Siehe auch QMagnetometerReading Units.
Dokumentation der Mitgliedsfunktionen
void QMagnetometerReading::setCalibrationLevel(qreal calibrationLevel)
Setzt die Genauigkeit der Ablesung auf calibrationLevel.
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().
© 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.
