QMagnetometerReading Class
La clase `QMagnetometerReading` representa una lectura del magnetómetro. Más información...
| Encabezado: | #include <QMagnetometerReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| Heredan: | QSensorReading |
Propiedades
- calibrationLevel : qreal
- x : qreal
- y : qreal
- z : qreal
Funciones públicas
| 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 |
Descripción detallada
Unidades de lectura del magnetómetro Q
El magnetómetro devuelve valores de densidad de flujo magnético a lo largo de tres ejes. La unidad de medida de los valores es el tesla. Los ejes se organizan de la siguiente manera.

El magnetómetro puede proporcionar valores de flujo magnético sin procesar o valores de flujo geomagnético. Por defecto, devuelve valores de flujo magnético sin procesar. Para que devuelva valores de flujo geomagnético, es necesario establecer la propiedad ` QMagnetometer::returnGeoValues `.
La principal diferencia entre los valores brutos y los geomagnéticos es que se realiza un procesamiento adicional para eliminar la interferencia magnética local de los valores geomagnéticos, de modo que estos representen únicamente el efecto del campo magnético terrestre. Este proceso no es perfecto y la precisión de cada lectura puede variar.
La imagen siguiente muestra la diferencia entre las lecturas geomagnéticas (a la izquierda) y las brutas (a la derecha) de un teléfono sometido a interferencias magnéticas.

La precisión de cada lectura se mide con un número comprendido entre 0 y 1. Un valor de 1 es el nivel más alto que el dispositivo puede alcanzar y 0 es el peor.
Calibración
Si el dispositivo indica una baja precisión, es posible que sea necesaria una calibración antes de que se puedan obtener mediciones aceptables. La calibración básica suele realizarse girando el dispositivo en forma de ocho o girándolo a lo largo de cada uno de sus tres ejes. Para obtener más información, consulta la documentación de tu dispositivo sobre cómo calibrar el sensor magnético.
Documentación sobre las propiedades
[read-only] calibrationLevel : qreal
Esta propiedad indica la precisión de la lectura.
Se mide como un valor comprendido entre 0 y 1, siendo mejores los valores más altos.
Ten en cuenta que esto solo cambia cuando se mide la densidad del flujo geomagnético. Las lecturas brutas del flujo magnético siempre tendrán un valor de 1.
Funciones de acceso:
| qreal | calibrationLevel() const |
Véase también QMagnetometerReading Units y Calibration.
[read-only] x : qreal
Esta propiedad contiene la densidad de flujo magnético sin procesar en el eje X.
Se mide en teslas.
Funciones de acceso:
| qreal | x() const |
Véase también « QMagnetometerReading Units ».
[read-only] y : qreal
Esta propiedad representa la densidad de flujo magnético sin procesar en el eje Y.
Se mide en teslas.
Funciones de acceso:
| qreal | y() const |
Véase también QMagnetometerReading Units.
[read-only] z : qreal
Esta propiedad contiene la densidad de flujo magnético bruta en el eje Z.
Se mide en teslas.
Funciones de acceso:
| qreal | z() const |
Véase también QMagnetometerReading Units.
Documentación de funciones de miembro
void QMagnetometerReading::setCalibrationLevel(qreal calibrationLevel)
Establece la precisión de la lectura en « calibrationLevel ».
Véase también calibrationLevel().
void QMagnetometerReading::setX(qreal x)
Establece la densidad de flujo magnético bruta en el eje X en x.
Véase también x().
void QMagnetometerReading::setY(qreal y)
Establece la densidad de flujo magnético bruta en el eje Y en y.
Véase también y().
void QMagnetometerReading::setZ(qreal z)
Establece la densidad de flujo magnético bruta en el eje Z en z.
Véase también 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.