QAudioRoom Class
| Encabezado: | #include <QAudioRoom> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio) target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake: | QT += spatialaudio |
| Heredado de: | QObject |
Tipos públicos
| enum | Material { Transparent, AcousticCeilingTiles, BrickBare, BrickPainted, ConcreteBlockCoarse, …, UniformMaterial } |
| enum | Wall { LeftWall, RightWall, Floor, Ceiling, FrontWall, BackWall } |
Propiedades
|
|
Funciones públicas
| QAudioRoom(QAudioEngine *engine) | |
| virtual | ~QAudioRoom() override |
| QVector3D | dimensions() const |
| QVector3D | position() const |
| float | reflectionGain() const |
| float | reverbBrightness() const |
| float | reverbGain() const |
| float | reverbTime() const |
| QQuaternion | rotation() const |
| void | setDimensions(QVector3D dim) |
| void | setPosition(QVector3D pos) |
| void | setReflectionGain(float factor) |
| void | setReverbBrightness(float factor) |
| void | setReverbGain(float factor) |
| void | setReverbTime(float factor) |
| void | setRotation(const QQuaternion &q) |
| void | setWallMaterial(QAudioRoom::Wall wall, QAudioRoom::Material material) |
| QAudioRoom::Material | wallMaterial(QAudioRoom::Wall wall) const |
Señales
| void | dimensionsChanged() |
| void | positionChanged() |
| void | reflectionGainChanged() |
| void | reverbBrightnessChanged() |
| void | reverbGainChanged() |
| void | reverbTimeChanged() |
| void | rotationChanged() |
| void | wallsChanged() |
Descripción detallada
Define una sala para el motor de audio espacial.
Si el oyente se encuentra dentro de una sala, se aplicarán al campo sonoro reflexiones de primer orden y una reverberación acordes con las propiedades de la sala.
Una sala es siempre cuadrada y se define por su posición central, su orientación y sus dimensiones. Cada una de las seis paredes de la sala puede estar compuesta por materiales diferentes que contribuirán a las reflexiones y a la reverberación calculadas que experimentará el oyente mientras se encuentre dentro de la sala.
Si varias salas ocupan la misma posición, el motor utilizará la sala con menor volumen.
Documentación sobre tipos de miembros
enum QAudioRoom::Material
Define los distintos materiales que se pueden aplicar a las diferentes paredes de la habitación.
| Constante | Valor | Descripción |
|---|---|---|
QAudioRoom::Transparent | 0 | El lateral de la sala está abierto y no contribuirá a las reflexiones ni a la reverberación. |
QAudioRoom::AcousticCeilingTiles | 1 | Paneles acústicos que suprimen la mayor parte de los reflejos y la reverberación. |
QAudioRoom::BrickBare | 2 | Pared de ladrillo visto. |
QAudioRoom::BrickPainted | 3 | Pared de ladrillo pintada. |
QAudioRoom::ConcreteBlockCoarse | 4 | Pared de hormigón en bruto |
QAudioRoom::ConcreteBlockPainted | 5 | Pared de hormigón pintada |
QAudioRoom::CurtainHeavy | 6 | Cortina gruesa. Reflejará principalmente las frecuencias bajas. |
QAudioRoom::FiberGlassInsulation | 7 | Aislamiento de fibra de vidrio. Solo refleja las frecuencias muy bajas. |
QAudioRoom::GlassThin | 8 | Pared de cristal fino |
QAudioRoom::GlassThick | 9 | Pared de cristal grueso |
QAudioRoom::Grass | 10 | Césped |
QAudioRoom::LinoleumOnConcrete | 11 | Suelo de linóleo |
QAudioRoom::Marble | 12 | Suelo de mármol |
QAudioRoom::Metal | 13 | Metal |
QAudioRoom::ParquetOnConcrete | 14 | Suelo de parqué sobre hormigón |
QAudioRoom::PlasterRough | 15 | Enlucido rugoso |
QAudioRoom::PlasterSmooth | 16 | Yeso liso |
QAudioRoom::PlywoodPanel | 17 | Panel de madera contrachapada |
QAudioRoom::PolishedConcreteOrTile | 18 | Hormigón pulido o baldosas |
QAudioRoom::Sheetrock | 19 | Roca |
QAudioRoom::WaterOrIceSurface | 20 | Agua o hielo |
QAudioRoom::WoodCeiling | 21 | Techo de madera |
QAudioRoom::WoodPanel | 22 | Panel de madera |
QAudioRoom::UniformMaterial | 23 | Material artificial que produce reflejos uniformes en todas las frecuencias |
enum QAudioRoom::Wall
Una enumeración que define las 6 paredes de la habitación
| Constante | Valor | Descripción |
|---|---|---|
QAudioRoom::LeftWall | 0 | Pared izquierda (x negativo) |
QAudioRoom::RightWall | 1 | Pared derecha (x positiva) |
QAudioRoom::Floor | 2 | Pared inferior (y negativa) |
QAudioRoom::Ceiling | 3 | Pared superior (y positiva) |
QAudioRoom::FrontWall | 4 | Pared frontal (z negativo) |
QAudioRoom::BackWall | 5 | Pared trasera (z positiva) |
Documentación de la propiedad
dimensions : QVector3D
Define las dimensiones de la habitación en el espacio 3D. Por defecto, las unidades son centímetros.
Funciones de acceso:
| QVector3D | dimensions() const |
| void | setDimensions(QVector3D dim) |
Señal de notificación:
| void | dimensionsChanged() |
Véase también position y QAudioEngine::distanceScale.
position : QVector3D
Define la posición del centro de la habitación en el espacio 3D. Las unidades son centímetros por defecto.
Funciones de acceso:
| QVector3D | position() const |
| void | setPosition(QVector3D pos) |
Señal de notificación:
| void | positionChanged() |
Véase también dimensions y QAudioEngine::distanceScale.
reflectionGain : float
Un factor de ganancia para las reflexiones generadas en esta sala. Un valor entre 0 y 1 atenuará las reflexiones, mientras que un valor superior a 1 aplicará una ganancia a las reflexiones, lo que las hará más fuertes.
El valor por defecto es 1; un factor de 0 desactiva las reflexiones. Los valores negativos se asignan a 0.
Funciones de acceso:
| float | reflectionGain() const |
| void | setReflectionGain(float factor) |
Señal de notificación:
| void | reflectionGainChanged() |
reverbBrightness : float
Un factor de brillo que se aplicará a la reverberación generada. Un valor positivo aumentará la reverberación en las frecuencias más altas y la atenuará en las más bajas; un valor negativo hará lo contrario.
El valor por defecto es 0.
Funciones de acceso:
| float | reverbBrightness() const |
| void | setReverbBrightness(float factor) |
Señal de notificación:
| void | reverbBrightnessChanged() |
reverbGain : float
Un factor de ganancia para la reverberación generada en esta sala. Un valor entre 0 y 1 atenuará la reverberación, mientras que un valor superior a 1 aplicará una ganancia a la reverberación, aumentando su volumen.
El valor por defecto es 1; un factor de 0 desactiva la reverberación. Los valores negativos se asignan a 0.
Funciones de acceso:
| float | reverbGain() const |
| void | setReverbGain(float factor) |
Señal de notificación:
| void | reverbGainChanged() |
reverbTime : float
El factor «A» se aplica a todos los tiempos de reverberación generados para esta sala. Cuanto mayor sea el valor, más largos serán los tiempos de reverberación, lo que hará que la sala suene más amplia.
El valor por defecto es 1. Los valores negativos se asignan a 0.
Funciones de acceso:
| float | reverbTime() const |
| void | setReverbTime(float factor) |
Señal de notificación:
| void | reverbTimeChanged() |
rotation : QQuaternion
Define la orientación de la habitación en el espacio 3D.
Funciones de acceso:
| QQuaternion | rotation() const |
| void | setRotation(const QQuaternion &q) |
Señal de notificación:
| void | rotationChanged() |
Documentación de funciones de miembro
[explicit] QAudioRoom::QAudioRoom(QAudioEngine *engine)
Crea un QAudioRoom para engine.
Nota: Debe llamarse con un QAudioEngine
[override virtual noexcept] QAudioRoom::~QAudioRoom()
Arruina el ambiente.
void QAudioRoom::setWallMaterial(QAudioRoom::Wall wall, QAudioRoom::Material material)
Establece wall en material.
Los distintos materiales de las paredes tienen diferentes propiedades de reflexión y reverberación que influyen en el sonido de la sala.
Véase también wallMaterial(), Material y QAudioRoom::Wall.
QAudioRoom::Material QAudioRoom::wallMaterial(QAudioRoom::Wall wall) const
Devuelve el material que se está utilizando para wall.
Véase también setWallMaterial(), Material y QAudioRoom::Wall.
[signal] void QAudioRoom::wallsChanged()
Indica cuándo cambia el material de la pared.
© 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.