PySide6.QtSpatialAudio.QAudioRoom¶

class QAudioRoom¶

概要¶

属性¶

• dimensionsᅟ

• positionᅟ

• reflectionGainᅟ

• reverbBrightnessᅟ

• reverbGainᅟ

• reverbTimeᅟ

• rotationᅟ

方法¶

• def __init__()

• def dimensions()

• def position()

• def reflectionGain()

• def reverbBrightness()

• def reverbGain()

• def reverbTime()

• def rotation()

• def setDimensions()

• def setPosition()

• def setReflectionGain()

• def setReverbBrightness()

• def setReverbGain()

• def setReverbTime()

• def setRotation()

• def setWallMaterial()

• def wallMaterial()

信号¶

• def dimensionsChanged()

• def positionChanged()

• def reflectionGainChanged()

• def reverbBrightnessChanged()

• def reverbGainChanged()

• def reverbTimeChanged()

• def rotationChanged()

• def wallsChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

为空间音频引擎定义一个房间。

如果监听器位于房间内，将根据房间的属性对声场应用首次反射和混响。

房间总是正方形的，由其中心位置、方向和尺寸定义。房间的6面墙中的每一面都可以由不同的材料制成，这些材料将有助于计算听众在房间内时所体验到的反射和混响。

如果多个房间覆盖了相同的位置，引擎将使用体积最小的房间。

class Material¶

定义可以应用于房间不同墙壁的不同材料。

常量	描述
QAudioRoom.Transparent	房间的一侧是开放的，不会对反射或混响产生影响。
QAudioRoom.AcousticCeilingTiles	吸音天花板砖，抑制大部分反射和混响。
QAudioRoom.BrickBare	裸露的砖墙。
QAudioRoom.BrickPainted	涂漆的砖墙。
QAudioRoom.ConcreteBlockCoarse	原始混凝土墙
QAudioRoom.ConcreteBlockPainted	涂漆的混凝土墙
QAudioRoom.CurtainHeavy	厚重的窗帘。主要反射低频
QAudioRoom.FiberGlassInsulation	玻璃纤维绝缘。仅反射非常低的频率
QAudioRoom.GlassThin	薄玻璃墙
QAudioRoom.GlassThick	厚玻璃墙
QAudioRoom.Grass	草地
QAudioRoom.LinoleumOnConcrete	油毡地板
QAudioRoom.Marble	大理石地板
QAudioRoom.Metal	金属
QAudioRoom.ParquetOnConcrete	混凝土上的木地板
QAudioRoom.PlasterRough	粗糙的石膏
QAudioRoom.PlasterSmooth	光滑石膏
QAudioRoom.PlywoodPanel	胶合板面板
QAudioRoom.PolishedConcreteOrTile	抛光混凝土或瓷砖
QAudioRoom.Sheetrock	岩石
QAudioRoom.WaterOrIceSurface	水或冰
QAudioRoom.WoodCeiling	木质天花板
QAudioRoom.WoodPanel	木质面板
QAudioRoom.UniformMaterial	人工材料在所有频率上提供均匀的反射

class Wall¶

一个定义房间6面墙的枚举

常量	描述
QAudioRoom.LeftWall	左墙（负x）
QAudioRoom.RightWall	右墙（正x方向）
QAudioRoom.Floor	底部墙（负y）
QAudioRoom.Ceiling	顶部墙壁（正y方向）
QAudioRoom.FrontWall	前墙（负z）
QAudioRoom.BackWall	后墙（正z方向）

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property dimensionsᅟ: QVector3D¶

定义房间在3D空间中的尺寸。默认单位为厘米。

另请参阅

position distanceScale

Access functions:

• dimensions()

• setDimensions()

• 信号 dimensionsChanged()

property positionᅟ: QVector3D¶

定义房间中心在3D空间中的位置。默认单位是厘米。

另请参阅

dimensions distanceScale

Access functions:

• position()

• setPosition()

• 信号 positionChanged()

property reflectionGainᅟ: float¶

此房间内生成的反射增益因子。值为0到1时会减弱反射，而大于1的值会对反射应用增益，使其更响亮。

默认值为1，因子为0时禁用反射。负值将被映射为0。

Access functions:

• reflectionGain()

• setReflectionGain()

• 信号 reflectionGainChanged()

property reverbBrightnessᅟ: float¶

应用于生成混响的亮度因子。正值会增加高频的混响并减弱低频，负值则相反。

默认值为0。

Access functions:

• reverbBrightness()

• setReverbBrightness()

• 信号 reverbBrightnessChanged()

property reverbGainᅟ: float¶

此房间生成的混响增益因子。0到1之间的值将减弱混响，而大于1的值将对混响应用增益，使其更响亮。

默认值为1，因子为0时禁用混响。负值将被映射为0。

Access functions:

• reverbGain()

• setReverbGain()

• 信号 reverbGainChanged()

property reverbTimeᅟ: float¶

应用于为该房间生成的所有混响时间的因子。较大的值将导致更长的混响时间，使房间听起来更大。

默认值为1。负值将被映射为0。

Access functions:

• reverbTime()

• setReverbTime()

• 信号 reverbTimeChanged()

property rotationᅟ: QQuaternion¶

定义房间在3D空间中的方向。

Access functions:

• rotation()

• setRotation()

• 信号 rotationChanged()

__init__(engine)¶

Parameters:

引擎 – QAudioEngine

为 engine 构建一个 QAudioRoom。

dimensions()¶

Return type:

QVector3D

另请参阅

setDimensions()

属性 dimensionsᅟ 的获取器。

dimensionsChanged()¶

属性 dimensionsᅟ 的通知信号。

position()¶

Return type:

QVector3D

另请参阅

setPosition()

属性 positionᅟ 的获取器。

positionChanged()¶

属性 positionᅟ 的通知信号。

reflectionGain()¶

Return type:

浮点数

另请参阅

setReflectionGain()

属性 reflectionGainᅟ 的获取器。

reflectionGainChanged()¶

属性 reflectionGainᅟ 的通知信号。

reverbBrightness()¶

Return type:

浮点数

另请参阅

setReverbBrightness()

属性 reverbBrightnessᅟ 的获取器。

reverbBrightnessChanged()¶

属性 reverbBrightnessᅟ 的通知信号。

reverbGain()¶

Return type:

浮点数

另请参阅

setReverbGain()

属性 reverbGainᅟ 的获取器。

reverbGainChanged()¶

属性 reverbGainᅟ 的通知信号。

reverbTime()¶

Return type:

浮点数

另请参阅

setReverbTime()

属性 reverbTimeᅟ 的获取器。

reverbTimeChanged()¶

属性 reverbTimeᅟ 的通知信号。

rotation()¶

Return type:

QQuaternion

另请参阅

setRotation()

属性 rotationᅟ 的获取器。

rotationChanged()¶

属性 rotationᅟ 的通知信号。

setDimensions(dim)¶

Parameters:

dim – QVector3D

另请参阅

dimensions()

属性 dimensionsᅟ 的设置器。

setPosition(pos)¶

Parameters:

位置 – QVector3D

另请参阅

position()

属性 positionᅟ 的设置器。

setReflectionGain(factor)¶

Parameters:

factor – 浮点数

另请参阅

reflectionGain()

属性 reflectionGainᅟ 的设置器。

setReverbBrightness(factor)¶

Parameters:

factor – 浮点数

另请参阅

reverbBrightness()

属性 reverbBrightnessᅟ 的设置器。

setReverbGain(factor)¶

Parameters:

factor – 浮点数

另请参阅

reverbGain()

属性 reverbGainᅟ 的设置器。

setReverbTime(factor)¶

Parameters:

factor – 浮点数

另请参阅

reverbTime()

属性 reverbTimeᅟ 的设置器。

setRotation(q)¶

Parameters:

q – QQuaternion

另请参阅

rotation()

属性 rotationᅟ 的设置器。

setWallMaterial(wall, material)¶

Parameters:

• 墙 – Wall

• material – Material

将 wall 设置为 material。

不同的墙面材料具有不同的反射和混响特性，这些特性会影响房间的声音。

另请参阅

wallMaterial() Material Wall

wallMaterial(wall)¶

Parameters:

墙 – Wall

Return type:

Material

返回用于wall的材料。

另请参阅

setWallMaterial() Material Wall

wallsChanged()¶

当墙体材料发生变化时发出信号。