estructura KSDS3D_ITD_PARAMS (ksmedia.h)

La estructura KSDS3D_ITD_PARAMS especifica los parámetros aplicados por el algoritmo de retraso de tiempo interaural (ITD) al canal izquierdo o derecho en un nodo 3D (KSNODETYPE_3D_EFFECTS).

Sintaxis

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

Miembros

Channel

Especifica el número de canal (el canal 0 es el canal izquierdo; el canal 1 es el canal derecho).

VolSmoothScale

Especifica el factor de rampa para escalar los niveles de volumen. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

TotalDryAttenuation

Especifica el factor de atenuación de la señal "seca" (la señal original antes de aplicar un filtro de paso bajo para producir un efecto silenciado). Para obtener más información, vea la sección Comentarios que se muestra más adelante.

TotalWetAttenuation

Especifica el factor de atenuación de la señal "mojada" (la señal silenciada después de aplicar el filtro de paso bajo). Para obtener más información, vea la sección Comentarios que se muestra más adelante.

SmoothFrequency

Especifica la frecuencia de muestra de la secuencia de audio. Al cambiar a un nuevo valor TotalDryAttenuation o TotalWetAttenuation , el algoritmo ITD necesita este valor para determinar el número de muestras en las que se aplicará suavizado para completar la transición en un intervalo de tiempo fijo. Por ejemplo, el algoritmo ITD implementado por el controlador del sistema KMixer usa un intervalo de tiempo de transición de aproximadamente 1/8 segundos.

Delay

Especifica el retraso de tiempo para este canal. El retraso se expresa como un número entero de muestras.

Comentarios

Esta estructura la usa la estructura KSDS3D_ITD_PARAMS_MSG , que usa la solicitud de propiedad KSPROPERTY_ITD3D_PARAMS para especificar los parámetros de ITD para los canales izquierdo y derecho de una secuencia de audio 3D.

El miembro Delay especifica la cantidad por la que el canal actual retrasa la llegada del sonido desde el origen. El retraso de tiempo interaural es la diferencia entre los retrasos entre los dos canales.

La señal atenuada es la suma de la señal seca atenuada y la señal húmeda atenuada:

TotalDryAttenuation + TotalWetAttenuation

Aumentar el tamaño de TotalWetAttenuation en relación con TotalDryAttenuation produce un sonido cada vez más silenciado. Los dos factores de atenuación se calculan a partir de la posición, la orientación y el cono de sonido de la fuente de sonido.

Cuando una solicitud de KSPROPERTY_ITD3D_PARAMS set-property cambia totalDryAttenuation o TotalWetAttenuation, el cambio en el nivel de atenuación se suaviza en una serie de muestras para evitar generar ruidos de clic falsos. El miembro VolSmoothScale especifica la cantidad por la que se escala la atenuación de la señal durante cada paso del proceso de suavizado. Este parámetro es un valor ligeramente menor que 1 si la atenuación aumenta o ligeramente mayor que 1 si la atenuación disminuye. En cada paso del proceso de suavizado, la atenuación del paso anterior se multiplica por este parámetro. El proceso se completa cuando se alcanza la atenuación de destino.

Requisitos

Requisito	Valor
Header	ksmedia.h (incluye Ksmedia.h)

Consulte también

KSDS3D_ITD_PARAMS_MSG

KSPROPERTY_ITD3D_PARAMS