QMagnetometerReading Class
La classe QMagnetometerReading représente une lecture du magnétomètre. Plus d'informations...
| En-tête : | #include <QMagnetometerReading> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Sensors)target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake : | QT += sensors |
| Héritages : | QSensorReading |
Propriétés
- calibrationLevel : qreal
- x : qreal
- y : qreal
- z : qreal
Fonctions publiques
| 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 |
Description détaillée
QMagnetometerReading Unités
Le magnétomètre renvoie des valeurs de densité de flux magnétique le long de 3 axes. L'échelle des valeurs est le teslas. Les axes sont disposés comme suit.
Le magnétomètre peut fournir des valeurs brutes de flux magnétique ou des valeurs de flux géomagnétique. Par défaut, il renvoie des valeurs brutes de flux magnétique. La propriété QMagnetometer::returnGeoValues doit être définie pour renvoyer des valeurs de flux géomagnétique.
La principale différence entre les valeurs brutes et les valeurs géomagnétiques est qu'un traitement supplémentaire est effectué pour éliminer les interférences magnétiques locales des valeurs géomagnétiques afin qu'elles ne représentent que l'effet du champ magnétique terrestre. Ce processus n'est pas parfait et la précision de chaque relevé peut varier.
L'image ci-dessous montre la différence entre les relevés géomagnétiques (à gauche) et les relevés bruts (à droite) pour un téléphone soumis à des interférences magnétiques.
La précision de chaque relevé est mesurée par un chiffre compris entre 0 et 1. La valeur 1 correspond au niveau le plus élevé que l'appareil peut supporter et la valeur 0 au niveau le plus faible.
Étalonnage
Si l'appareil indique une faible précision, un étalonnage peut s'avérer nécessaire avant de pouvoir fournir des mesures acceptables. L'étalonnage de base peut généralement être réalisé en faisant tourner l'appareil en huit ou en le faisant tourner le long de chacun de ses trois axes. Pour plus d'informations, consultez la documentation de votre appareil sur la manière de calibrer le capteur magnétique.
Documentation sur les propriétés
[read-only] calibrationLevel : qreal
Cette propriété détermine la précision de la lecture.
Elle est mesurée sur une échelle de 0 à 1, les valeurs les plus élevées étant les meilleures.
Notez que cette propriété ne change que lors de la mesure de la densité du flux géomagnétique. Les relevés de flux magnétiques bruts auront toujours une valeur de 1.
Fonctions d'accès :
| qreal | calibrationLevel() const |
Voir également QMagnetometerReading Units et Calibration.
[read-only] x : qreal
Cette propriété contient la densité de flux magnétique brute sur l'axe X.
Mesurée en teslas.
Fonctions d'accès :
| qreal | x() const |
Voir également QMagnetometerReading Units.
[read-only] y : qreal
Cette propriété contient la densité de flux magnétique brute sur l'axe Y.
Mesurée en teslas.
Fonctions d'accès :
| qreal | y() const |
Voir également QMagnetometerReading Units.
[read-only] z : qreal
Cette propriété contient la densité de flux magnétique brute sur l'axe Z.
Mesurée en teslas.
Fonctions d'accès :
| qreal | z() const |
Voir également QMagnetometerReading Units.
Documentation des fonctions membres
void QMagnetometerReading::setCalibrationLevel(qreal calibrationLevel)
Définit la précision de la lecture à calibrationLevel.
Voir également calibrationLevel().
void QMagnetometerReading::setX(qreal x)
Définit la densité de flux magnétique brute sur l'axe X à x.
Voir également x().
void QMagnetometerReading::setY(qreal y)
Définit la densité de flux magnétique brute sur l'axe Y à y.
Voir également y().
void QMagnetometerReading::setZ(qreal z)
Définit la densité de flux magnétique brute sur l'axe Z à z.
Voir également 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.
