QMagnetometerReading Class
La clase QMagnetometerReading representa una lectura del magnetómetro. Más...
| Cabecera: | #include <QMagnetometerReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors)target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| Hereda: | 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 QMagnetometerReading
El magnetómetro devuelve valores de densidad de flujo magnético a lo largo de 3 ejes. La escala de los valores es teslas. Los ejes están dispuestos de la siguiente manera.
El magnetómetro puede informar sobre valores de flujo magnético bruto o valores de flujo geomagnético. Por defecto devuelve valores de flujo magnético brutos. La propiedad QMagnetometer::returnGeoValues debe establecerse para devolver valores de flujo geomagnético.
La principal diferencia entre los valores brutos y los geomagnéticos es que se realiza un procesamiento adicional para eliminar las interferencias magnéticas locales de los valores geomagnéticos, de modo que sólo representen 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 en bruto (a la derecha) de un teléfono sometido a interferencias magnéticas.
La precisión de cada lectura se mide como un número del 0 al 1. Un valor de 1 es el nivel más alto que puede soportar el dispositivo y 0 es el peor.
Calibración
Si el dispositivo indica una precisión baja, es posible que sea necesario calibrarlo antes de poder proporcionar mediciones aceptables. La calibración básica suele realizarse girando el dispositivo en forma de ocho o girando el dispositivo a lo largo de cada uno de sus tres ejes. Para más información, consulte la documentación de su dispositivo sobre cómo calibrar el sensor magnético.
Documentación de propiedades
[read-only] calibrationLevel : qreal
Esta propiedad mantiene la precisión de la lectura.
Se mide como un valor de 0 a 1, siendo mejores los valores más altos.
Tenga en cuenta que esto sólo cambia cuando se mide la densidad de flujo geomagnético. Las lecturas de flujo magnético bruto 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 bruta 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 contiene la densidad de flujo magnético bruta 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 las funciones 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 sin procesar en el eje X en x.
Véase también x().
void QMagnetometerReading::setY(qreal y)
Establece la densidad de flujo magnético sin procesar en el eje Y en y.
Véase también y().
void QMagnetometerReading::setZ(qreal z)
Establece la densidad de flujo magnético sin procesar 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.
