QAudioRoom Class
| Cabecera: | #include <QAudioRoom> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake: | QT += spatialaudio |
| Hereda: | 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 sonoras de primer orden y reverberaciones que coincidan con las propiedades de la sala.
Una sala es siempre cuadrada y está definida por su posición central, su orientación y sus dimensiones. Cada una de las 6 paredes de la sala puede estar hecha de materiales diferentes que contribuirán a las reflexiones y reverberaciones computadas que el oyente experimentará mientras esté dentro de la sala.
Si varias salas cubren la misma posición, el motor utilizará la sala de menor volumen.
Documentación del tipo de miembro
enum QAudioRoom::Material
Define los diferentes materiales que se pueden aplicar a las distintas paredes de la habitación.
| Constante | Valor | Descripción |
|---|---|---|
QAudioRoom::Transparent | 0 | El lado de la sala está abierto y no contribuye a las reflexiones ni a la reverberación. |
QAudioRoom::AcousticCeilingTiles | 1 | Baldosas acústicas que suprimen la mayoría de las reflexiones y reverberaciones. |
QAudioRoom::BrickBare | 2 | Pared de ladrillo desnudo. |
QAudioRoom::BrickPainted | 3 | Pared de ladrillo pintada. |
QAudioRoom::ConcreteBlockCoarse | 4 | Pared de hormigón en bruto |
QAudioRoom::ConcreteBlockPainted | 5 | Pared de hormigón pintado |
QAudioRoom::CurtainHeavy | 6 | Cortina pesada. Refleja principalmente las bajas frecuencias |
QAudioRoom::FiberGlassInsulation | 7 | Aislamiento de fibra de vidrio. Sólo refleja frecuencias muy bajas |
QAudioRoom::GlassThin | 8 | Muro de vidrio fino |
QAudioRoom::GlassThick | 9 | Pared de vidrio grueso |
QAudioRoom::Grass | 10 | Hierba |
QAudioRoom::LinoleumOnConcrete | 11 | Suelo de linóleo |
QAudioRoom::Marble | 12 | Suelo de mármol |
QAudioRoom::Metal | 13 | Metal |
QAudioRoom::ParquetOnConcrete | 14 | Parquet de madera sobre hormigón |
QAudioRoom::PlasterRough | 15 | Yeso rugoso |
QAudioRoom::PlasterSmooth | 16 | Enlucido liso |
QAudioRoom::PlywoodPanel | 17 | Panel contrachapado |
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 proporciona reflejos uniformes en todas las frecuencias |
enum QAudioRoom::Wall
Un enum 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 positivo) |
QAudioRoom::Floor | 2 | Pared inferior (y negativo) |
QAudioRoom::Ceiling | 3 | Pared superior (y positivo) |
QAudioRoom::FrontWall | 4 | Pared frontal (z negativo) |
QAudioRoom::BackWall | 5 | Pared trasera (z positivo) |
Documentación de la propiedad
dimensions : QVector3D
Define las dimensiones de la habitación en el espacio 3D. Por defecto, las unidades están en centímetros.
Funciones de acceso:
| QVector3D | dimensions() const |
| void | setDimensions(QVector3D dim) |
Señal de aviso:
| 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. Por defecto, las unidades están en centímetros.
Funciones de acceso:
| QVector3D | position() const |
| void | setPosition(QVector3D pos) |
Señal de aviso:
| 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 de 0 a 1 amortiguará las reflexiones, mientras que un valor mayor que 1 aplicará una ganancia a las reflexiones, haciéndolas 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 del notificador:
| void | reflectionGainChanged() |
reverbBrightness : float
Un factor de brillo que se aplicará a la reverberación generada. Un valor positivo aumentará la reverberación para las frecuencias más altas y amortiguará las frecuencias más bajas, un valor negativo hace lo contrario.
El valor por defecto es 0.
Funciones de acceso:
| float | reverbBrightness() const |
| void | setReverbBrightness(float factor) |
Señal notificadora:
| void | reverbBrightnessChanged() |
reverbGain : float
Un factor de ganancia para la reverberación generada en esta sala. Un valor de 0 a 1 amortiguará la reverberación, mientras que un valor mayor que 1 aplicará una ganancia a la reverberación, haciéndola más fuerte.
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 del notificador:
| void | reverbGainChanged() |
reverbTime : float
Factor que se aplica a todos los tiempos de reverberación generados para esta sala. Los valores mayores producirán tiempos de reverberación más largos, haciendo que la sala suene más grande.
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 del notificador:
| void | reverbTimeChanged() |
rotation : QQuaternion
Define la orientación de la sala en el espacio 3D.
Funciones de acceso:
| QQuaternion | rotation() const |
| void | setRotation(const QQuaternion &q) |
Señal del notificador:
| void | rotationChanged() |
Documentación de la función miembro
[explicit] QAudioRoom::QAudioRoom(QAudioEngine *engine)
Construye un QAudioRoom para engine.
[override virtual noexcept] QAudioRoom::~QAudioRoom()
Destruye la habitación.
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 utilizado para wall.
Véase también setWallMaterial(), Material, y QAudioRoom::Wall.
[signal] void QAudioRoom::wallsChanged()
Señala cuando 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.
