структура KSDS3D_ITD_PARAMS (ksmedia.h)

  • Статья

Структура KSDS3D_ITD_PARAMS задает параметры, применяемые алгоритмом межуральной задержки времени (ITD) к левому или правому каналу в трехмерном узле (KSNODETYPE_3D_EFFECTS).

Синтаксис

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

Указывает частоту выборки аудиопотока. При изменении на новое значение TotalDryAttenuation или TotalWetAttenuation это значение требуется алгоритму ITD, чтобы определить количество выборок, к которым применяется сглаживание, чтобы завершить переход в течение определенного фиксированного интервала времени. Например, алгоритм ITD, реализованный системным драйвером KMixer , использует интервал времени перехода примерно в 1/8 секунды.

Delay

Указывает временную задержку для этого канала. Задержка выражается в виде целочисленного числа выборок.

Комментарии

Эта структура используется структурой KSDS3D_ITD_PARAMS_MSG , которую запрос свойства KSPROPERTY_ITD3D_PARAMS использует для указания параметров ITD для левого и правого каналов трехмерного аудиопотока.

Элемент Delay указывает величину, на которую текущий канал задерживает звук, поступающий из источника. Межуральная задержка — это разница в задержках между двумя каналами.

Сигнал с затуханием представляет собой сумму затухаемого сухого сигнала и затухлого сигнала:

TotalDryAttenuation + TotalWetAttenuation

Увеличение размера TotalWetAttenuation относительно TotalDryAttenuation создает все более приглушенный звук. Два фактора затухания вычисляются на основе положения, ориентации и звукового конуса источника звука.

Когда KSPROPERTY_ITD3D_PARAMS запрос set-property изменяет либо TotalDryAttenuation , либо TotalWetAttenuation, изменение уровня затухания сглаживается по сравнению с рядом выборок, чтобы избежать создания фиктивных помех при щелчке. Элемент VolSmoothScale указывает величину, на которую масштабируется затухание сигнала на каждом шаге процесса сглаживания. Этот параметр имеет значение чуть меньше 1, если затухание увеличивается, или немного больше 1, если затухание уменьшается. На каждом этапе процесса сглаживания затухание предыдущего шага умножается на этот параметр. Процесс завершается при достижении целевого затухания.

Требования

Требование Значение
Заголовок ksmedia.h (включая Ksmedia.h)

См. также раздел

KSDS3D_ITD_PARAMS_MSG

KSPROPERTY_ITD3D_PARAMS