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
상세 설명
공간 오디오 엔진을 위한 방을 정의합니다.
청취자가 방 안에 있을 경우, 방의 특성에 부합하는 1차 음향 반사와 잔향이 음장에 적용됩니다.
방은 항상 정사각형이며, 중심 위치, 방향 및 크기로 정의됩니다. 방의 6개 벽면은 각각 서로 다른 재질로 구성될 수 있으며, 이는 청취자가 방 안에 있을 때 경험하게 될 계산된 반사음과 잔향에 영향을 미칩니다.
동일한 위치를 여러 개의 방이 차지하는 경우, 엔진은 부피가 가장 작은 방을 사용합니다.
속성 설명서
backMaterial : AudioRoom::Material
ceilingMaterial : AudioRoom::Material
floorMaterial : AudioRoom::Material
frontMaterial : AudioRoom::Material
leftMaterial : AudioRoom::Material
rightMaterial : AudioRoom::Material
방의 각 면에 사용할 재질을 설정합니다. 속성은 좌표와 다음과 같이 대응됩니다:
| 속성 | 좌표 |
|---|---|
| 왼쪽 | 음의 x |
| 오른쪽 | 양의 x |
| 뒤 | 음의 z |
| 앞 | 양 z |
| 바닥 | 음의 y |
| 천장 | 양의 y |
이 재료에 대한 유효한 값은 다음과 같습니다:
| 속성 값 | 설명 |
|---|---|
| 투명 | 방의 측면이 개방되어 있어 반사나 잔향에 영향을 주지 않습니다. |
| 음향 천장 타일 | 대부분의 반사와 잔향을 억제하는 음향 타일입니다. |
| BrickBare | 마감 처리되지 않은 벽돌 벽입니다. |
| BrickPainted | 페인트가 칠해진 벽돌 벽. |
| ConcreteBlockCoarse | 거친 콘크리트 벽 |
| 도색된 콘크리트 블록 | 페인트 칠한 콘크리트 벽 |
| 무거운 커튼 | 무거운 커튼. 주로 저주파를 반사합니다 |
| 유리섬유 단열재 | 유리섬유 단열재. 극저주파만 반사합니다 |
| 얇은 유리 | 얇은 유리벽 |
| 두꺼운 유리 | 두꺼운 유리 벽 |
| 잔디 | 잔디 |
| 콘크리트 위의 리놀륨 | 리놀륨 바닥 |
| 대리석 | 대리석 바닥 |
| 금속 | 금속 |
| 콘크리트 위의 쪽모이 세공 마루 | 콘크리트 위의 쪽모이 세공 목재 바닥 |
| 거친 미장 | 거친 미장 |
| 매끄러운 미장 | 매끄러운 미장 |
| 합판 패널 | 합판 패널 |
| 광택 처리된 콘크리트 또는 타일 | 광택 처리된 콘크리트 또는 타일 |
| 시트록 | 바위 |
| 물 또는 얼음 표면 | 물 또는 얼음 |
| 목재 천장 | 목재 천장 |
| 나무 패널 | 목재 패널 |
| 균일한 | 모든 주파수에서 균일한 반사 특성을 보이는 인공 소재 |
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
‘A factor to be’는 이 공간에 대해 생성된 모든 잔향 시간에 적용됩니다. 값이 클수록 잔향 시간이 길어져 공간이 더 넓게 들리게 됩니다.
기본값은 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.
