En esta página

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

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.

Dispositivo con ejes x, y y z positivos y negativos que se extienden en las seis direcciones

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.

Diagrama en el que se comparan las lecturas geomagnéticas —con los ejes del teléfono alineados con el Polo Norte Magnético— con las lecturas sin procesar, distorsionadas por un imán cercano

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.