KSDS3D_ITD_PARAMS结构 (ksmedia.h)

KSDS3D_ITD_PARAMS结构指定由 3D 节点(KSNODETYPE_3D_EFFECTS)中内部时间延迟(ITD)算法应用于左侧或右侧通道的参数。

语法

typedef struct {
  LONG  Channel;
  FLOAT VolSmoothScale;
  FLOAT TotalDryAttenuation;
  FLOAT TotalWetAttenuation;
  LONG  SmoothFrequency;
  LONG  Delay;
} KSDS3D_ITD_PARAMS, *PKSDS3D_ITD_PARAMS;

成员

Channel

指定通道号(通道 0 是左通道;通道 1 是右通道)。

VolSmoothScale

指定缩放卷级别的渐变因子。 有关详细信息,请参阅以下“备注”部分。

TotalDryAttenuation

指定“干”信号的衰减因子(在应用低通筛选器产生混音效果之前的原始信号)。 有关详细信息,请参阅以下“备注”部分。

TotalWetAttenuation

指定“湿”信号的衰减因子(应用低通筛选器后的混音信号)。 有关详细信息,请参阅以下“备注”部分。

SmoothFrequency

指定音频流的示例频率。 当更改为新的 TotalDryAttenuationTotalWetAttenuation 值时,ITD 算法需要此值来确定要应用平滑的样本数,以便在一些固定的时间间隔内完成转换。 例如,由 KMixer 系统驱动程序实现的 ITD 算法 使用大约 1/8 秒的转换时间间隔。

Delay

指定此通道的时间延迟。 延迟表示为整数样本数。

言论

此结构由 KSDS3D_ITD_PARAMS_MSG 结构使用,KSPROPERTY_ITD3D_PARAMS 属性请求使用该结构为 3D 音频流的左右通道指定 ITD 参数。

延迟 成员指定当前通道延迟从源到达的声音的量。 间隙时间延迟是两个通道之间的延迟差异。

衰减信号是衰减干信号和衰减湿信号的总和:

TotalDryAttenuation + TotalWetAttenuation

相对于 TotalDryAttenuationTotalWetAttenuation 的大小增加,会产生越来越闷热的声音。 从声源的位置、方向和声锥计算两个衰减因子。

当KSPROPERTY_ITD3D_PARAMS set-property 请求更改 TotalDryAttenuationTotalWetAttenuation时,衰减级别的更改将平滑处理多个样本,以避免产生虚假的单击干扰。 VolSmoothScale 成员指定在平滑过程中每个步骤中缩放信号衰减的量。 如果衰减增加,则此参数的值略小于 1;如果衰减正在减少,则该值略小于 1。 在平滑过程中的每个步骤中,上一步的衰减乘以此参数。 达到目标衰减后,该过程将完成。

要求

要求 价值
标头 ksmedia.h (包括 Ksmedia.h)

另请参阅

KSDS3D_ITD_PARAMS_MSG

KSPROPERTY_ITD3D_PARAMS