QMagnetometerReading Class
La classe `QMagnetometerReading` représente une mesure provenant du magnétomètre. En savoir plus...
| En-tête : | #include <QMagnetometerReading> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake : | QT += sensors |
| Hérite de : | 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
Unités de lecture du magnétomètre Q
Le magnétomètre renvoie des valeurs de densité de flux magnétique selon 3 axes. L'échelle des valeurs est exprimée en teslas. Les axes sont organisés comme suit.
Le magnétomètre peut fournir soit des valeurs de flux magnétique brutes, soit des valeurs de flux géomagnétique. Par défaut, il renvoie des valeurs de flux magnétique brutes. 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 réside dans le fait qu’un traitement supplémentaire est effectué pour éliminer les interférences magnétiques locales des valeurs géomagnétiques, afin qu’elles ne reflètent que l’effet du champ magnétique terrestre. Ce processus n’est pas parfait et la précision de chaque mesure peut varier.
L’image ci-dessous illustre la différence entre les mesures géomagnétiques (à gauche) et brutes (à droite) pour un téléphone soumis à des interférences magnétiques.
La précision de chaque mesure est exprimée par un nombre compris entre 0 et 1. La valeur 1 correspond au niveau le plus élevé pris en charge par l'appareil, tandis que 0 correspond au niveau le plus bas.
Étalonnage
Si l’appareil indique une faible précision, un étalonnage peut s’avérer nécessaire avant de pouvoir fournir des mesures acceptables. Un étalonnage de base peut généralement être effectué soit en faisant tourner votre appareil en formant un huit, soit en le faisant tourner selon chacun de ses trois axes. Pour plus d’informations, consultez la documentation de votre appareil sur la manière d’étalonner le capteur magnétique.
Documentation sur les propriétés
[read-only] calibrationLevel : qreal
Cette propriété indique la précision de la mesure.
Elle est mesurée sur une échelle de 0 à 1, les valeurs les plus élevées étant les meilleures.
Notez que cette valeur ne change que lors de la mesure de la densité de flux géomagnétique. Les mesures brutes du flux magnétique 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.
Elle est exprimée en teslas.
Fonctions d'accès :
| qreal | x() const |
Voir aussi QMagnetometerReading Units.
[read-only] y : qreal
Cette propriété contient la densité de flux magnétique brute sur l'axe Y.
Elle est exprimée en teslas.
Fonctions d'accès :
| qreal | y() const |
Voir aussi QMagnetometerReading Units.
[read-only] z : qreal
Cette propriété contient la densité de flux magnétique brute sur l'axe Z.
Elle est exprimée en teslas.
Fonctions d'accès :
| qreal | z() const |
Voir aussi QMagnetometerReading Units.
Documentation des fonctions membres
void QMagnetometerReading::setCalibrationLevel(qreal calibrationLevel)
Définit la précision de la lecture sur « calibrationLevel ».
Voir aussi 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.
