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方向）

def rotationChanged()

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

property dimensionsᅟ: QVector3D

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

另请参阅

position distanceScale

访问函数

• dimensions()

• setDimensions()

• 信号 dimensionsChanged()

属性 positionᅟ: QVector3D

定义了3D空间中房间中心的坐标。默认单位为厘米。

另请参阅

dimensions distanceScale

访问函数

• position()

• setPosition()

• 信号 positionChanged()

属性 reflectionGainᅟ: float

生成该房间内反射的增益系数。从0到1的值会降低反射强度，而大于1的值会将增益应用于反射，使其更响亮。

默认值是1，0的因子会禁用反射。负值映射为0。

访问函数

• reflectionGain()

• setReflectionGain()

• 信号 reflectionGainChanged()

属性 reverbBrightnessᅟ: float

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

默认值是0。

访问函数

• reverbBrightness()

• setReverbBrightness()

• 信号 reverbBrightnessChanged()

属性 reverbGainᅟ: float

生成该房间内混响的增益系数。从0到1的值会降低混响强度，而大于1的值会将增益应用于混响，使其更响亮。

默认值是1，0的因子会禁用混响。负值映射为0。

访问函数

• reverbGain()

• setReverbGain()

• 信号 reverbGainChanged()

属性 reverbTimeᅟ: float

应用于此房间所有混响时长的系数。更大的值会导致更长的混响时长，使房间听起来更大。

默认值是1。负值映射为0。

访问函数

• reverbTime()

• setReverbTime()

• 信号 reverbTimeChanged()

属性 rotationᅟ: QQuaternion

定义3D空间中房间的朝向。

访问函数

• rotation()

• setRotation()

• 信号 rotationChanged()

__init__(engine)

参数:

engine – QAudioEngine

为 engine 构建一个 QAudioRoom。

dimensions()

返回类型:

QVector3D

另请参阅

setDimensions()

属性 dimensionsᅟ 的获取器。

dimensionsChanged()

属性 dimensionsᅟ 的通知信号。

position()

返回类型:

QVector3D

另请参阅

setPosition()

属性 positionᅟ 的获取器。

positionChanged()

属性 positionᅟ 的通知信号。

reflectionGain()

返回类型:

浮点数

另请参阅

setReflectionGain()

属性 reflectionGainᅟ 的获取器。

reflectionGainChanged()

属性 reflectionGainᅟ 的通知信号。

reverbBrightness()

返回类型:

浮点数

另请参阅

setReverbBrightness()

属性 reverbBrightness 的获取器。

reverbBrightnessChanged()

属性 reverbBrightness 的通知信号。

reverbGain()

返回类型:

浮点数

另请参阅

setReverbGain()

属性 reverbGain 的获取器。

reverbGainChanged()

属性 reverbGain 的通知信号。

reverbTime()

返回类型:

浮点数

另请参阅

setReverbTime()

属性 reverbTime 的获取器。

reverbTimeChanged()

属性 reverbTime 的通知信号。

rotation()

返回类型:

QQuaternion

另请参阅

setRotation()

属性 rotation 的获取器。

rotationChanged()

属性 rotation 的通知信号。

setDimensions(dim)

参数:

dim – QVector3D

另请参阅

dimensions()

属性 dimensions 的设置器。

setPosition(pos)

参数:

pos – QVector3D

另请参阅

position()

属性 position 的设置器。

setReflectionGain(factor)

参数:

factor – float

另请参阅

reflectionGain()

属性 reflectionGain 的设置器。

setReverbBrightness(factor)

参数:

factor – float

另请参阅

reverbBrightness()

属性 reverbBrightness 的设置器。

setReverbGain(factor)

参数:

factor – float

另请参阅

reverbGain()

属性 reverbGain 的设置器。

setReverbTime(factor)

参数:

factor – float

另请参阅

reverbTime()

属性 reverbTime 的设置器。

setRotation(q)

参数:

q – QQuaternion

另请参阅

rotation()

属性 rotation 的设置器。

setWallMaterial(wall, material)

参数:

• wall – Wall

• material – Material

将 wall 设置为 material。

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

另请参阅

wallMaterial() 属性 Material 个属性 Wall

wallMaterial(wall)

参数:

wall – Wall

返回类型:

材质

返回用于 wall 的材质。

另请参阅

setWallMaterial() Material Wall

wallsChanged()

信号当墙壁材质改变时。