AudioRoom QML Type
| Import Statement: | import QtQuick3D.SpatialAudio |
プロパティ
- backMaterial : AudioRoom::Material
- ceilingMaterial : AudioRoom::Material
- dimensions : vector3D
- floorMaterial : AudioRoom::Material
- frontMaterial : AudioRoom::Material
- leftMaterial : AudioRoom::Material
- reflectionGain : real
- reverbBrightness : real
- reverbGain : real
- reverbTime : real
- rightMaterial : AudioRoom::Material
詳細な説明
空間オーディオエンジン用の部屋を定義します。
リスナーがルーム内にある場合、そのルームの特性に合わせた一次反射音と残響が音場に適用されます。
部屋は常に正方形で、中心位置、向き、および寸法によって定義されます。部屋の 6 つの壁はそれぞれ異なる素材で構成することができ、それらは、リスナーが部屋の中にいる間に体験する、計算された反射音や残響に影響を与えます。
同じ位置に複数の部屋が重なる場合、エンジンは体積が最も小さい部屋を使用します。
プロパティのドキュメント
backMaterial : AudioRoom::Material
ceilingMaterial : AudioRoom::Material
floorMaterial : AudioRoom::Material
frontMaterial : AudioRoom::Material
leftMaterial : AudioRoom::Material
rightMaterial : AudioRoom::Material
部屋の各面に使用するマテリアルを設定します。プロパティと座標の関係は以下の通りです:
| プロパティ | 座標 |
|---|---|
| 左 | 負の x |
| right | 正の x |
| 奥 | 負の z |
| 前面 | zの正方向 |
| 床 | 負のy軸 |
| 天井 | yの正方向 |
このマテリアルで有効な値は次のとおりです:
| プロパティ値 | 説明 |
|---|---|
| 透明 | 部屋の側面が開いており、反射や残響の原因にはなりません。 |
| AcousticCeilingTiles | ほとんどの反射音や残響を抑制する吸音タイル。 |
| むき出しのレンガ | むき出しのレンガ壁。 |
| BrickPainted | 塗装されたレンガ壁。 |
| ConcreteBlockCoarse | 粗面コンクリートの壁 |
| 塗装済みコンクリートブロック | 塗装されたコンクリートの壁 |
| 厚手のカーテン | 厚手のカーテン。主に低周波を反射する |
| グラスウール断熱材 | グラスウール断熱材。極めて低周波数のみを反射する |
| 薄いガラス | 薄いガラスの壁 |
| 厚いガラス | 厚いガラスの壁 |
| 草 | Grass |
| コンクリート上のリノリウム | リノリウムの床 |
| 大理石 | 大理石の床 |
| 金属 | 金属 |
| コンクリート上の寄木張り | コンクリート上の寄木張りの床 |
| 粗仕上げの漆喰 | 粗仕上げの漆喰 |
| 滑らかな漆喰 | 滑らかな漆喰 |
| 合板パネル | 合板パネル |
| 研磨済みコンクリートまたはタイル | 研磨仕上げのコンクリートまたはタイル |
| シートロック | 岩 |
| 水または氷の表面 | 水または氷 |
| 木製天井 | 木製の天井 |
| 木製パネル | 木製パネル |
| 均一 | すべての周波数において均一な反射をもたらす人工素材 |
dimensions : vector3D
3D空間における部屋の寸法を定義します。単位はデフォルトでセンチメートルです。
QtQuick3D::Node::positionも参照してください 。
reflectionGain : real
この部屋で発生する反射音に対するゲイン係数です。0 から 1 までの値を設定すると反射音が減衰し、1 より大きい値を設定すると反射音にゲインがかかり、音量が大きくなります。
デフォルトは 1 です。係数が 0 の場合は反射が無効になります。負の値は 0 として扱われます。
reverbBrightness : real
生成されるリバーブに適用される輝度係数です。正の値を設定すると、高周波数帯域のリバーブが増強され、低周波数帯域のリバーブが減衰します。負の値を設定すると、その逆の効果が得られます。
デフォルト値は 0 です。
reverbGain : real
この部屋で生成されるリバーブのゲイン係数です。0 から 1 までの値を設定するとリバーブが弱まり、1 より大きい値を設定するとリバーブにゲインがかかり、音量が大きくなります。
デフォルト値は 1 です。係数が 0 の場合はリバーブが無効になります。負の値は 0 として扱われます。
reverbTime : real
この部屋に生成されるすべての残響時間に適用される倍率です。値を大きくすると残響時間が長くなり、部屋がより広く聞こえるようになります。
デフォルト値は 1 です。負の値は 0 として扱われます。
© 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.