QAudioRoom Class
| Überschrift: | #include <QAudioRoom> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio) target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake: | QT += spatialaudio |
| Erbt: | QObject |
Öffentliche Typen
| enum | Material { Transparent, AcousticCeilingTiles, BrickBare, BrickPainted, ConcreteBlockCoarse, …, UniformMaterial } |
| enum | Wall { LeftWall, RightWall, Floor, Ceiling, FrontWall, BackWall } |
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
Signale
| void | dimensionsChanged() |
| void | positionChanged() |
| void | reflectionGainChanged() |
| void | reverbBrightnessChanged() |
| void | reverbGainChanged() |
| void | reverbTimeChanged() |
| void | rotationChanged() |
| void | wallsChanged() |
Ausführliche Beschreibung
Definiert einen Raum für die räumliche Audio-Engine.
Befindet sich der Zuhörer in einem Raum, werden auf das Schallfeld Schallreflexionen erster Ordnung sowie ein den Raumeigenschaften entsprechender Nachhall angewendet.
Ein Raum ist immer quadratisch und wird durch seine Mittelposition, seine Ausrichtung und seine Abmessungen definiert. Jede der 6 Wände des Raums kann aus unterschiedlichen Materialien bestehen, die zu den berechneten Reflexionen und dem Nachhall beitragen, die der Zuhörer im Raum wahrnimmt.
Wenn mehrere Räume dieselbe Position abdecken, verwendet die Engine den Raum mit dem kleinsten Volumen.
Dokumentation zum Mitgliedstyp
enum QAudioRoom::Material
Definiert verschiedene Materialien, die an den verschiedenen Wänden des Raums angebracht werden können.
| Konstante | Wert | Beschreibung |
|---|---|---|
QAudioRoom::Transparent | 0 | Die Seite des Raums ist offen und trägt nicht zu Reflexionen oder Nachhall bei. |
QAudioRoom::AcousticCeilingTiles | 1 | Akustikplatten, die den Großteil der Reflexionen und des Nachhalls unterdrücken. |
QAudioRoom::BrickBare | 2 | Unverputzte Ziegelwand. |
QAudioRoom::BrickPainted | 3 | Gestrichene Ziegelwand. |
QAudioRoom::ConcreteBlockCoarse | 4 | Rohbetonwand |
QAudioRoom::ConcreteBlockPainted | 5 | Gestrichene Betonwand |
QAudioRoom::CurtainHeavy | 6 | Schwerer Vorhang. Reflektiert vor allem tiefe Frequenzen |
QAudioRoom::FiberGlassInsulation | 7 | Glasfaserisolierung. Reflektiert nur sehr tiefe Frequenzen |
QAudioRoom::GlassThin | 8 | Dünne Glaswand |
QAudioRoom::GlassThick | 9 | Dicke Glaswand |
QAudioRoom::Grass | 10 | Gras |
QAudioRoom::LinoleumOnConcrete | 11 | Linoleumboden |
QAudioRoom::Marble | 12 | Marmorboden |
QAudioRoom::Metal | 13 | Metall |
QAudioRoom::ParquetOnConcrete | 14 | Parkettboden auf Beton |
QAudioRoom::PlasterRough | 15 | Rauer Putz |
QAudioRoom::PlasterSmooth | 16 | Glatter Putz |
QAudioRoom::PlywoodPanel | 17 | Sperrholzplatte |
QAudioRoom::PolishedConcreteOrTile | 18 | Polierter Beton oder Fliesen |
QAudioRoom::Sheetrock | 19 | Fels |
QAudioRoom::WaterOrIceSurface | 20 | Wasser oder Eis |
QAudioRoom::WoodCeiling | 21 | Holzdecke |
QAudioRoom::WoodPanel | 22 | Holzpaneel |
QAudioRoom::UniformMaterial | 23 | Kunststoff, der bei allen Frequenzen gleichmäßige Reflexionen erzeugt |
enum QAudioRoom::Wall
Eine Enumeration, die die 6 Wände des Raums definiert
| Konstante | Wert | Beschreibung |
|---|---|---|
QAudioRoom::LeftWall | 0 | Linke Wand (negatives x) |
QAudioRoom::RightWall | 1 | Rechte Wand (positive x-Achse) |
QAudioRoom::Floor | 2 | Unterwand (negatives y) |
QAudioRoom::Ceiling | 3 | Obere Wand (positive y-Achse) |
QAudioRoom::FrontWall | 4 | Vordere Wand (negatives z) |
QAudioRoom::BackWall | 5 | Rückwand (positive z-Achse) |
Dokumentation zu den Eigenschaften
dimensions : QVector3D
Legt die Abmessungen des Raums im 3D-Raum fest. Standardmäßig werden die Maße in Zentimetern angegeben.
Zugriffsfunktionen:
| QVector3D | dimensions() const |
| void | setDimensions(QVector3D dim) |
Benachrichtigungssignal:
| void | dimensionsChanged() |
Siehe auch position und QAudioEngine::distanceScale.
position : QVector3D
Legt die Position des Raummittelpunkts im 3D-Raum fest. Die Einheit ist standardmäßig Zentimeter.
Zugriffsfunktionen:
| QVector3D | position() const |
| void | setPosition(QVector3D pos) |
Benachrichtigungssignal:
| void | positionChanged() |
Siehe auch dimensions und QAudioEngine::distanceScale.
reflectionGain : float
Ein Verstärkungsfaktor für die in diesem Raum erzeugten Reflexionen. Ein Wert zwischen 0 und 1 dämpft die Reflexionen, während ein Wert größer als 1 die Reflexionen verstärkt und sie lauter macht.
Der Standardwert ist 1; ein Faktor von 0 deaktiviert Reflexionen. Negative Werte werden auf 0 gesetzt.
Zugriffsfunktionen:
| float | reflectionGain() const |
| void | setReflectionGain(float factor) |
Benachrichtigungssignal:
| void | reflectionGainChanged() |
reverbBrightness : float
Ein Helligkeitsfaktor, der auf den erzeugten Hall angewendet wird. Ein positiver Wert verstärkt den Hall bei höheren Frequenzen und dämpft tiefere Frequenzen, ein negativer Wert bewirkt das Gegenteil.
Der Standardwert ist 0.
Zugriffsfunktionen:
| float | reverbBrightness() const |
| void | setReverbBrightness(float factor) |
Benachrichtigungssignal:
| void | reverbBrightnessChanged() |
reverbGain : float
Ein Verstärkungsfaktor für den in diesem Raum erzeugten Hall. Ein Wert zwischen 0 und 1 dämpft den Hall, während ein Wert größer als 1 den Hall verstärkt und ihn lauter macht.
Der Standardwert ist 1; ein Faktor von 0 deaktiviert den Hall. Negative Werte werden auf 0 gesetzt.
Zugriffsfunktionen:
| float | reverbGain() const |
| void | setReverbGain(float factor) |
Benachrichtigungssignal:
| void | reverbGainChanged() |
reverbTime : float
Ein Skalierungsfaktor, der auf alle für diesen Raum generierten Nachhallzeiten angewendet wird. Höhere Werte führen zu längeren Nachhallzeiten, wodurch der Raum größer klingt.
Der Standardwert ist 1. Negative Werte werden auf 0 gesetzt.
Zugriffsfunktionen:
| float | reverbTime() const |
| void | setReverbTime(float factor) |
Benachrichtigungssignal:
| void | reverbTimeChanged() |
rotation : QQuaternion
Legt die Ausrichtung des Raums im 3D-Raum fest.
Zugriffsfunktionen:
| QQuaternion | rotation() const |
| void | setRotation(const QQuaternion &q) |
Benachrichtigungssignal:
| void | rotationChanged() |
Dokumentation der Mitgliedsfunktionen
[explicit] QAudioRoom::QAudioRoom(QAudioEngine *engine)
Erstellt einen QAudioRoom für engine.
Hinweis: Muss mit einem gültigen QAudioEngine
[override virtual noexcept] QAudioRoom::~QAudioRoom()
Das ruiniert die ganze Atmosphäre.
void QAudioRoom::setWallMaterial(QAudioRoom::Wall wall, QAudioRoom::Material material)
Setzt „ wall “ auf „ material “.
Verschiedene Wandmaterialien weisen unterschiedliche Reflexions- und Nachhall-Eigenschaften auf, die den Klang des Raums beeinflussen.
Siehe auch wallMaterial(), Material und QAudioRoom::Wall.
QAudioRoom::Material QAudioRoom::wallMaterial(QAudioRoom::Wall wall) const
Gibt das für wall verwendete Material zurück.
Siehe auch setWallMaterial(), Material und QAudioRoom::Wall.
[signal] void QAudioRoom::wallsChanged()
Zeigt an, wenn sich das Wandmaterial ändert.
© 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.
